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.
Organisationen auflisten
Abschnitt betitelt „Organisationen auflisten“GET /v1/organizationsGibt jede Organisation zurück, der Sie angehören.
Antwort
Abschnitt betitelt „Antwort“{ "data": [ { "id": "org_uuid", "name": "Acme Inc.", "role": "ADMIN", "member_count": 12 } ]}Rollenwerte
Abschnitt betitelt „Rollenwerte“| Rolle | Beschreibung |
|---|---|
OWNER | Volle Kontrolle über die Organisation |
ADMIN | Verwaltet Einstellungen, Mitglieder und Ordner |
EDITOR | Erstellt, bearbeitet und zeigt Aufnahmen an |
VIEWER | Nur Lesezugriff |
Ordner auflisten
Abschnitt betitelt „Ordner auflisten“GET /v1/organizations/:id/foldersGibt die aktiven Ordner der Organisation zurück. Sie müssen Mitglied sein.
Antwort
Abschnitt betitelt „Antwort“{ "data": [ { "id": "folder_uuid", "name": "Product team", "icon": null } ]}icon ist der Name des Ordnersymbols oder null.
Mitglieder auflisten
Abschnitt betitelt „Mitglieder auflisten“GET /v1/organizations/:id/membersGibt die Mitglieder der Organisation zurück. Sie müssen Mitglied sein.
Antwort
Abschnitt betitelt „Antwort“{ "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.
Fehlercodes
Abschnitt betitelt „Fehlercodes“| Code | HTTP-Status | Bedeutung |
|---|---|---|
FORBIDDEN | 403 | Sie sind kein Mitglied dieser Organisation |