Zum Inhalt springen

Organisationen

Schreibgeschützte Endpunkte für die Organisationen, denen Sie angehören. Alle Pfade liegen auf https://api.recordmeeting.com und erfordern einen API-Schlüssel. Siehe Authentifizierung.

Um die Aufnahmen einer Organisation aufzulisten, verwenden Sie Aufnahmen auflisten mit organization_id.

GET /v1/organizations

Gibt jede Organisation zurück, der Sie angehören.

{
"data": [
{
"id": "org_uuid",
"name": "Acme Inc.",
"role": "ADMIN",
"member_count": 12
}
]
}
RolleBeschreibung
OWNERVolle Kontrolle über die Organisation
ADMINVerwaltet Einstellungen, Mitglieder und Ordner
EDITORErstellt, bearbeitet und zeigt Aufnahmen an
VIEWERNur Lesezugriff

GET /v1/organizations/:id/folders

Gibt die aktiven Ordner der Organisation zurück. Sie müssen Mitglied sein.

{
"data": [
{
"id": "folder_uuid",
"name": "Product team",
"icon": null
}
]
}

icon ist der Name des Ordnersymbols oder null.


GET /v1/organizations/:id/members

Gibt die Mitglieder der Organisation zurück. Sie müssen Mitglied sein.

{
"data": [
{
"id": "user_uuid",
"email": "alice@example.com",
"name": "Alice",
"role": "EDITOR"
}
],
"emails_included": true
}

E-Mail-Adressen werden nur zurückgegeben, wenn Ihre Rolle in der Organisation OWNER oder ADMIN ist. Bei anderen Rollen ist jede email null und emails_included ist false.


CodeHTTP-StatusBedeutung
FORBIDDEN403Sie sind kein Mitglied dieser Organisation