Team-API #

Ihr Team besteht aus allen Personen, die neben Ihnen in Ihrem Konto arbeiten – Administratoren, Agenten und Betrachter mit Lesezugriff – sowie den Einladungen, die Sie versendet haben, und den Abteilungen, in denen Sie diese organisieren. Die Team-API ist die programmatische Version von Einstellungen → Team: Fügen Sie Personen hinzu oder entfernen Sie sie, legen Sie fest, was jeder Einzelne sehen und tun kann, versenden und verfolgen Sie Einladungen und verwalten Sie Abteilungen.

Alle unten aufgeführten Endpunkte beziehen sich auf die Basis-URL https://api.youraiconnector.com/v1. Die Dashboard-Version für alle Funktionen auf dieser Seite finden Sie unter Teamverwaltung.

Authentifizierung: Diese Endpunkte erfordern eine angemeldete Person #

Dies ist der einzige Teil der API, der nicht mit einem API-Schlüssel verwendet werden kann. Jeder /team-Endpunkt, mit Ausnahme der Abteilungs-Endpunkte, muss mit einem Firebase-ID-Token aus einer angemeldeten Sitzung aufgerufen werden:

Authorization: Bearer <Firebase ID token>

Wenn Sie stattdessen einen API-Schlüssel senden, wird die Anfrage mit einem 401 abgelehnt:

{
  "success": false,
  "error_code": 401,
  "error": "This endpoint requires a Firebase ID token (Authorization: Bearer <token>)."
}

Der Grund dafür ist, dass diese Endpunkte basierend auf der angemeldeten Person entscheiden, was zu tun ist: Ihre Rolle, die Obergrenze dessen, was Sie anderen gewähren dürfen, und ob Sie derzeit in einem anderen Konto arbeiten. Ein API-Schlüssel ist eine Integration, keine Person, daher gibt es niemanden, auf den diese Regeln angewendet werden könnten.

In der Praxis bedeutet dies, dass die Team-API für eine First-Party-App mit einem angemeldeten Your AI Connector-Benutzer gedacht ist (siehe Authentifizierung → Firebase-ID-Token). Eine Server-zu-Server-Integration kann keine Teammitglieder verwalten – es gibt keine Möglichkeit, einen dieser Token von außerhalb der App zu erstellen.

Die Ausnahme: Die vier Abteilungs-Endpunkte sind gewöhnliche API-Endpunkte. Sie akzeptieren Ihren API-Schlüssel genau wie der Rest der API, ebenso wie eine angemeldete Sitzung.

Jede Antwort auf dieser Seite folgt dem üblichen Envelope: success: true plus die Felder des Endpunkts auf der obersten Ebene oder success: false mit error und error_code, wenn etwas schiefgeht.

Rollen und Berechtigungen #

Jedes Teammitglied hat eine Rolle, die den Standardzugriff auf 12 Bereiche der App festlegt. Sie können dann einzelne Bereiche überschreiben.

Jeder Bereich ist auf eine von vier Stufen eingestellt: none (ausgeblendet), view (nur Lesezugriff), edit (erstellen und ändern), full (einschließlich löschen).

Um von den Standardeinstellungen der Rolle abzuweichen, senden Sie permission_overrides — ein Array von { "area": ..., "level": ... }-Objekten. Jeder Eintrag ersetzt den Standardwert der Rolle für diesen einen Bereich; alles, was Sie nicht auflisten, behält den Standardwert der Rolle bei.

"permission_overrides": [
  { "area": "analytics", "level": "full" },
  { "area": "billing", "level": "none" }
]

Wer kann diese Endpunkte aufrufen

• Der Kontoinhaber kann immer alles tun.
• Ein Teammitglied benötigt team_management unter view, um die Mitgliederliste und die Einladungsliste zu lesen, sowie unter edit, um hinzuzufügen, zu ändern, zu suspendieren, zu entfernen, einzuladen, zu stornieren oder erneut zu senden. Administratoren haben standardmäßig edit; Editoren und Betrachter haben none, daher können standardmäßig nur Administratoren das Team verwalten.
• Niemand kann Zugriffsrechte vergeben, die über die eigenen hinausgehen. Wenn Sie versuchen, jemandem eine Stufe zuzuweisen, die Sie selbst nicht besitzen — oder jemanden zu bearbeiten, zu suspendieren oder zu entfernen, dessen Zugriff bereits umfassender ist als Ihrer —, wird die Anfrage mit 403 und einer Nachricht, die den Bereich benennt, abgelehnt.

Das Teammitglied-Objekt #

GET /team/members gibt pro Mitglied eines dieser Objekte zurück:

Entfernte Mitglieder werden nicht zurückgegeben — die Liste enthält nur aktive und suspendierte Mitglieder.

Sichtbarkeitsbeschränkungen sind hier nur schreibgeschützt. contact_scope, contact_scope_axes und sub_account_access (siehe Einschränken, was ein Mitglied sehen kann) können beim Erstellen, Aktualisieren und Einladen festgelegt werden, aber dieser Endpunkt gibt sie nicht zurück.

Teammitglieder auflisten #

GET /team/members

Gibt die Mitgliederliste sowie die Sitzplatzanzahl Ihres Plans zurück, sodass Sie „3 von 5 Sitzplätzen“ anzeigen können und wissen, wann eine Einladung abgelehnt wird.

cURL

curl "https://api.youraiconnector.com/v1/team/members" \
  -H "Authorization: Bearer FIREBASE_ID_TOKEN"

JavaScript

const res = await fetch("https://api.youraiconnector.com/v1/team/members", {
  headers: { Authorization: `Bearer ${idToken}` },
});
const { members, seat_limit, seats_used } = await res.json();

Python

import requests

res = requests.get(
    "https://api.youraiconnector.com/v1/team/members",
    headers={"Authorization": f"Bearer {id_token}"},
)
data = res.json()

Antwort

{
  "success": true,
  "members": [
    {
      "account_owner_uid": "owner_uid_123",
      "member_uid": "uid_alice",
      "member_email": "alice@example.com",
      "member_display_name": "Alice Chen",
      "role": "admin",
      "permission_overrides": [],
      "status": "active",
      "auto_assign_enabled": true,
      "created_by": "owner_uid_123",
      "created_at": "2026-05-01T10:00:00.000Z",
      "updated_at": "2026-06-02T09:15:00.000Z"
    }
  ],
  "seat_limit": 5,
  "seats_used": 3
}

seat_limit ist null, wenn Ihr Plan keine Sitzplatzbegrenzung hat. seats_used zählt nur aktive Mitglieder — das Suspendieren oder Entfernen einer Person gibt ihren Sitzplatz sofort frei.

Ein Teammitglied direkt hinzufügen #

POST /team/members

Fügt jemanden sofort Ihrem Team hinzu, ohne eine Einladung.

Dies sendet keine E-Mail. Niemand wird darüber informiert, dass er hinzugefügt wurde, und falls die Person noch kein Your AI Connector-Login hatte, hat das für sie erstellte Konto kein Passwort, sodass sie sich erst anmelden kann, nachdem sie es zurückgesetzt hat. Verwenden Sie Eine Einladung senden, es sei denn, Sie haben Ihre eigene Methode, um die Person zu informieren und ihr die Anmeldung zu ermöglichen.

Anfragefelder

cURL

curl -X POST "https://api.youraiconnector.com/v1/team/members" \
  -H "Authorization: Bearer FIREBASE_ID_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "sam@example.com",
    "display_name": "Sam Rivera",
    "role": "editor"
  }'

JavaScript

const res = await fetch("https://api.youraiconnector.com/v1/team/members", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${idToken}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    email: "sam@example.com",
    display_name: "Sam Rivera",
    role: "editor",
  }),
});
const { member_uid } = await res.json();

Antwort — 201 Created

{
  "success": true,
  "team_member_id": "owner_uid_123_uid_sam",
  "member_uid": "uid_sam",
  "message": "Team member created successfully."
}

Das Hinzufügen einer Person, die zuvor suspendiert oder entfernt wurde, reaktiviert sie, anstatt einen Fehler zu verursachen.

Ein Teammitglied aktualisieren #

PATCH /team/members/{memberUid}

Ändert die Rolle, Berechtigungen, Sichtbarkeit, Kundenzugriff oder die Teilnahme eines Mitglieds an der automatischen Kontaktzuweisung. Senden Sie nur die Felder, die Sie ändern möchten; alles, was Sie weglassen, behält seinen aktuellen Wert bei.

Anfragefelder

Dies ist der einzige Endpunkt, bei dem null “löschen” bedeutet. Das Senden von "contact_scope": null, "contact_scope_axes": null oder "sub_account_access": null entfernt diese Einschränkung vollständig und ermöglicht dem Mitglied wieder den Zugriff auf alles. Beim Erstellen und Einladen bedeutet null einfach “nicht angegeben”.

cURL

curl -X PATCH "https://api.youraiconnector.com/v1/team/members/uid_sam" \
  -H "Authorization: Bearer FIREBASE_ID_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "role": "admin",
    "permission_overrides": [{ "area": "billing", "level": "none" }]
  }'

Antwort

{
  "success": true,
  "message": "Team member updated successfully."
}

Ein Teammitglied suspendieren #

POST /team/members/{memberUid}/suspend

Suspendiert jemanden: Die Person behält ihren Platz im Team, verliert aber den Zugriff. Verwenden Sie dies anstelle des Entfernens, wenn die Pause nur vorübergehend ist — holen Sie sie mit PATCH /team/members/{memberUid} und {"status": "active"} zurück.

cURL

curl -X POST "https://api.youraiconnector.com/v1/team/members/uid_sam/suspend" \
  -H "Authorization: Bearer FIREBASE_ID_TOKEN"

Antwort

{
  "success": true,
  "message": "Team member suspended successfully."
}

Ein suspendiertes Mitglied gibt seinen Platz frei, sodass Sie jemand anderen an seiner Stelle einladen können. Der Zugriff endet, wenn das aktuelle Sitzungs-Token das nächste Mal aktualisiert wird, was bis zu einer Stunde dauern kann — entfernen Sie die Person stattdessen, wenn der Zugriff sofort enden soll.

Ein Teammitglied entfernen #

DELETE /team/members/{memberUid}

Entfernt eine Person aus Ihrem Team und gibt deren Platz frei. Die Person wird abgemeldet und verliert den Zugriff auf Ihr Konto; ihr eigenes Login bleibt davon unberührt.

cURL

curl -X DELETE "https://api.youraiconnector.com/v1/team/members/uid_sam" \
  -H "Authorization: Bearer FIREBASE_ID_TOKEN"

Antwort

{
  "success": true,
  "message": "Team member removed successfully."
}

Das Entfernen ist von Ihrer Seite aus permanent: Ein entferntes Mitglied kann nicht über den Update-Endpunkt reaktiviert werden – laden Sie die Person erneut ein, falls Sie es sich anders überlegen. Ihre E-Mail-Adresse wird zudem aus der Benachrichtigungsliste Ihres Kontos entfernt.

Einschränken der Sichtbarkeit für Mitglieder #

Drei optionale Felder, die beim Hinzufügen, Aktualisieren und Einladen akzeptiert werden, bestimmen, wie viel von dem Konto eine Person sehen kann. Sie lassen sich kombinieren: Ein Mitglied, das in mehr als einem Bereich eingeschränkt ist, unterliegt allen diesen Einschränkungen.

contact_scope — all (Standard: jeder Kontakt und jede Konversation) oder assigned (nur die, die ihnen zugewiesen sind). Fügen Sie bei assigned den Wert "contact_scope_unassigned": true hinzu, damit sie auch Kontakte sehen können, die noch niemandem gehören.

contact_scope_axes — beschränkt sie auf benannte Agenten, Kanäle oder Abteilungen:

Agenten- und Abteilungs-IDs werden beim Speichern nicht überprüft – eine ID, die nicht existiert, entspricht einfach nichts, was als leerer Posteingang und nicht als Fehler angezeigt wird. Kanalnamen werden überprüft: Ein nicht erkannter Name wird mit 400 abgelehnt.

Keines dieser drei Felder kann für den Kontoinhaber festgelegt werden – eine solche Anfrage wird mit 400 abgelehnt.

Einladungen auflisten #

GET /team/invites

Die von Ihnen versendeten Einladungen, beginnend mit der neuesten, damit Sie sehen können, wer noch nicht angenommen hat.

Abfrageparameter

cURL

curl "https://api.youraiconnector.com/v1/team/invites?status=pending" \
  -H "Authorization: Bearer FIREBASE_ID_TOKEN"

Antwort

{
  "success": true,
  "invites": [
    {
      "id": "inv_abc123",
      "account_owner_uid": "owner_uid_123",
      "account_owner_display_name": "Acme Ltd",
      "invitee_email": "sam@example.com",
      "invitee_uid": null,
      "role": "editor",
      "permission_overrides": [],
      "status": "pending",
      "created_by": "owner_uid_123",
      "created_at": "2026-06-10T12:00:00.000Z",
      "expires_at": "2026-06-17T12:00:00.000Z",
      "responded_at": null
    }
  ]
}

Das Einladungs-Token wird nie zurückgegeben — es existiert nur in der versendeten E-Mail.

Einladung versenden #

POST /team/invites

Sendet jemandem per E-Mail eine Einladung, Ihrem Team beizutreten. Dies ist der übliche Weg, um ein Teammitglied hinzuzufügen: Die Person klickt auf den Link, meldet sich mit ihrem eigenen Konto an und akzeptiert. Wenn sie noch kein Your AI Connector-Konto hat, wird eines für sie erstellt und die E-Mail führt sie durch die Einrichtung eines Passworts.

Anfragefelder

Wenn Sie die Berechtigungen im Voraus festlegen, müssen Sie das Mitglied später nicht mehr bearbeiten — alles wird auf die Mitgliedschaft übertragen, sobald diese angenommen wurde.

cURL

curl -X POST "https://api.youraiconnector.com/v1/team/invites" \
  -H "Authorization: Bearer FIREBASE_ID_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "email": "sam@example.com", "role": "editor" }'

JavaScript

const res = await fetch("https://api.youraiconnector.com/v1/team/invites", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${idToken}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ email: "sam@example.com", role: "editor" }),
});
const { invite_id } = await res.json();

Antwort — 201 Created

{
  "success": true,
  "invite_id": "inv_abc123",
  "message": "Team invite sent successfully."
}

Dinge, die Sie einplanen sollten

• Einladungen laufen nach 7 Tagen ab. Eine abgelaufene Einladung kann erneut gesendet werden, wodurch die 7-Tage-Frist von neuem beginnt.
• Ausstehende Einladungen belegen einen Sitzplatz. Im Gegensatz zum direkten Hinzufügen eines Mitglieds zählt die Sitzplatzprüfung hier aktive Mitglieder plus ausstehende Einladungen. Ein Konto, bei dem alle Plätze belegt sind, wird daher abgelehnt, bevor die E-Mail versendet wird.
• 20 Einladungen pro Tag, gezählt pro Konto, sowohl für das Senden als auch für das erneute Senden.

Einladung stornieren #

DELETE /team/invites/{inviteId}

Zieht eine Einladung zurück, bevor sie angenommen wurde. Der Link in der E-Mail funktioniert dann nicht mehr.

cURL

curl -X DELETE "https://api.youraiconnector.com/v1/team/invites/inv_abc123" \
  -H "Authorization: Bearer FIREBASE_ID_TOKEN"

Antwort

{
  "success": true,
  "message": "Team invite cancelled."
}

Sowohl pending- als auch expired-Einladungen können storniert werden. Eine Einladung, die bereits angenommen, abgelehnt oder storniert wurde, gibt 400 zurück; eine, die nicht Ihnen gehört, gibt 403 zurück; eine unbekannte ID gibt 404 zurück.

Einladung erneut senden #

POST /team/invites/{inviteId}/resend

Sendet die Einladungs-E-Mail erneut – falls sie übersehen wurde oder im Spam gelandet ist. Funktioniert bei pending- und expired-Einladungen und setzt das Ablaufdatum auf 7 Tage ab jetzt zurück.

cURL

curl -X POST "https://api.youraiconnector.com/v1/team/invites/inv_abc123/resend" \
  -H "Authorization: Bearer FIREBASE_ID_TOKEN"

Antwort

{
  "success": true,
  "message": "Team invite resent successfully."
}

Die neue E-Mail enthält einen neuen Link, und der alte Link funktioniert weiterhin, sodass eine Person, die die erste E-Mail später findet, nicht blockiert ist. Das erneute Senden zählt gegen dasselbe Limit von 20 pro Tag wie das Senden, und das Reaktivieren einer abgelaufenen Einladung prüft Ihre Sitzplätze erneut – ein voller Plan wird mit 429 abgelehnt.

Einladung annehmen #

POST /team/invites/accept

Nimmt eine Einladung mit dem Token aus der Einladungs-E-Mail an und fügt die angemeldete Person dem Team des Kontos hinzu.

Dies ist eine Handlung Ihrer eigenen Identität. Melden Sie sich als Sie selbst an – dies wird absichtlich mit 403 verweigert, während Sie innerhalb des Kontos einer anderen Person arbeiten.

Anfragefelder

cURL

curl -X POST "https://api.youraiconnector.com/v1/team/invites/accept" \
  -H "Authorization: Bearer FIREBASE_ID_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "invite_token": "1f4c…" }'

Antwort

{
  "success": true,
  "team_member_id": "owner_uid_123_uid_sam",
  "account_owner_uid": "owner_uid_123",
  "message": "Team invite accepted successfully."
}

Einladung ablehnen #

POST /team/invites/decline

Lehnt eine Einladung mit dem Token aus der E-Mail ab. Wie beim Annehmen ist dies eine Handlung Ihrer eigenen Identität und wird verweigert, während Sie innerhalb eines anderen Kontos arbeiten.

cURL

curl -X POST "https://api.youraiconnector.com/v1/team/invites/decline" \
  -H "Authorization: Bearer FIREBASE_ID_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "invite_token": "1f4c…" }'

Antwort

{
  "success": true,
  "message": "Team invite declined."
}

Abteilungen #

Eine Abteilung ist eine benannte Gruppe Ihres Teams – Vertrieb, Kundensupport, Personalwesen. Sie weist einem Lead ein verantwortliches Team zu, kann neue Konversationen eigenständig beanspruchen und kann dazu verwendet werden, die Sichtbarkeit für Mitglieder einzuschränken.

Diese vier Endpunkte erfordern einen API-Schlüssel. Im Gegensatz zum Rest dieser Seite authentifizieren sie sich wie jeder andere Endpunkt in der API (siehe Authentifizierung). Eine angemeldete Sitzung funktioniert ebenfalls: Zum Lesen wird contacts unter view benötigt, und zum Erstellen, Ändern oder Löschen wird team_management unter edit benötigt.

Das Abteilungsobjekt

Wenn sowohl routing_agents als auch routing_channels festgelegt sind, muss eine Konversation beiden Kriterien entsprechen, um hier abgelegt zu werden – so geben Sie einem Team beispielsweise “den Support-Agenten, aber nur auf WhatsApp”.

Ein Konto kann bis zu 50 Abteilungen haben.

Abteilungen auflisten #

GET /team/departments

curl "https://api.youraiconnector.com/v1/team/departments?apiKey=YOUR_API_KEY"

Antwort

{
  "success": true,
  "departments": [
    {
      "id": "dep_abc123",
      "name": "Sales",
      "color": "#2f6fed",
      "member_uids": ["uid_alice", "uid_bob"],
      "auto_assign_enabled": true,
      "routing_agents": [],
      "routing_channels": ["whatsapp"],
      "created_by": "owner_uid_123"
    }
  ]
}

Eine Abteilung erstellen #

POST /team/departments

Anfragefelder

cURL

curl -X POST "https://api.youraiconnector.com/v1/team/departments?apiKey=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sales",
    "color": "#2f6fed",
    "member_uids": ["uid_alice", "uid_bob"],
    "routing_channels": ["whatsapp"]
  }'

JavaScript

const res = await fetch("https://api.youraiconnector.com/v1/team/departments", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name: "Sales",
    color: "#2f6fed",
    member_uids: ["uid_alice", "uid_bob"],
    routing_channels: ["whatsapp"],
  }),
});
const { department } = await res.json();

Python

import requests

res = requests.post(
    "https://api.youraiconnector.com/v1/team/departments",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={
        "name": "Sales",
        "color": "#2f6fed",
        "member_uids": ["uid_alice", "uid_bob"],
        "routing_channels": ["whatsapp"],
    },
)
department = res.json()["department"]

Antwort — 201 Created

{
  "success": true,
  "department": {
    "id": "dep_abc123",
    "name": "Sales",
    "color": "#2f6fed",
    "member_uids": ["uid_alice", "uid_bob"],
    "auto_assign_enabled": true,
    "routing_agents": [],
    "routing_channels": ["whatsapp"],
    "created_by": "owner_uid_123"
  }
}

Eine Abteilung aktualisieren #

PATCH /team/departments/{departmentId}

Ändert eine Abteilung. Nur die Felder, die Sie senden, werden geändert.

curl -X PATCH "https://api.youraiconnector.com/v1/team/departments/dep_abc123?apiKey=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "member_uids": ["uid_alice"], "auto_assign_enabled": false }'

Antwort

{
  "success": true,
  "department": {
    "id": "dep_abc123",
    "name": "Sales",
    "color": "#2f6fed",
    "member_uids": ["uid_alice"],
    "auto_assign_enabled": false,
    "routing_agents": [],
    "routing_channels": ["whatsapp"],
    "created_by": "owner_uid_123"
  }
}

Das Senden von nicht erkannten Feldern gibt 400 zurück; eine unbekannte Abteilung gibt 404 zurück; ein Name, der mit einer anderen Abteilung kollidiert, gibt 409 zurück.

Eine Abteilung löschen #

DELETE /team/departments/{departmentId}

curl -X DELETE "https://api.youraiconnector.com/v1/team/departments/dep_abc123?apiKey=YOUR_API_KEY"

Antwort

{
  "success": true,
  "deleted": "dep_abc123"
}

Das Löschen einer Abteilung, auf die jemand beschränkt ist, wird verweigert. Die 400-Antwort nennt die Mitglieder, deren Sichtbarkeit darauf eingeschränkt ist, sodass Sie deren Bereich zuerst anpassen können. Dies ist beabsichtigt: Sie stillschweigend von der Beschränkung zu befreien, würde ihnen Zugriff auf Ihren gesamten Kundenstamm gewähren, ohne dass dies ersichtlich wäre.

Kontakte, die unter einer gelöschten Abteilung abgelegt wurden, werden nicht umgeschrieben – sie zeigen einfach keine Abteilung mehr an, und beim nächsten Mal, wenn Sie sie ablegen, bleibt die Einstellung erhalten.

Überprüfen Sie Ihre eigenen Berechtigungen #

GET /team/permissions

Gibt zurück, was die angemeldete Person in dem Konto, in dem sie gerade arbeitet, tun darf. Verwenden Sie dies, um Schaltflächen auszublenden, die ein Mitglied nicht verwenden kann, anstatt es die Einschränkung erst durch einen Fehler entdecken zu lassen.

cURL

curl "https://api.youraiconnector.com/v1/team/permissions" \
  -H "Authorization: Bearer FIREBASE_ID_TOKEN"

Antwort – der Kontoinhaber

{
  "success": true,
  "role": "owner",
  "is_team_mode": false,
  "permissions": {
    "campaigns": "full",
    "contacts": "full",
    "messages": "full",
    "appointments": "full",
    "settings": "full",
    "billing": "full",
    "team_management": "full",
    "analytics": "full",
    "phone_numbers": "full",
    "integrations": "full",
    "faqs": "full",
    "daily_summaries": "full"
  }
}

Antwort – ein Teammitglied, das innerhalb eines Kontos arbeitet

{
  "success": true,
  "role": "editor",
  "is_team_mode": true,
  "permissions": { "campaigns": "edit", "billing": "none", "…": "…" },
  "member": {
    "uid": "uid_sam",
    "email": "sam@example.com",
    "display_name": "Sam Rivera",
    "account_owner_uid": "owner_uid_123"
  }
}

role ist owner, wenn die angemeldete Person der Kontoinhaber ist; andernfalls ist es ihre Teamrolle. member ist nur im Team-Modus vorhanden und enthält contact_scope, contact_scope_unassigned und contact_scope_axes, wenn ihre Mitgliedschaft diese beinhaltet.

Sitzungs-Tokens #

Fünf Endpunkte erstellen ein einmaliges Anmelde-Token für den Wechsel zwischen Konten. Sie antworten alle auf die gleiche Weise:

{
  "success": true,
  "customToken": "eyJhbGciOi…"
}

Das Token wird gegen eine Sitzung mit dem Firebase-Client-SDK ausgetauscht. Es ist kein API-Schlüssel und kann nicht als solcher gesendet werden, weshalb diese Endpunkte nur innerhalb einer First-Party-App nützlich sind.

Jeder verweigert den Zugriff mit 403, wenn die Sitzung nicht dazu berechtigt ist: kein Mitglied dieses Kontos, kein Mitarbeiter, das Unterkonto gehört nicht zu Ihrer Agentur oder wurde Ihnen nicht zugewiesen, oder die Sitzung befindet sich derzeit nicht in dem Modus, den der Endpunkt erfordert.

Plattformrolle zuweisen #

POST /team/users/{targetUid}/role

Legt die Plattform-Rolle eines Benutzers fest — User, Dev, Support oder Agency. Dies ist keine Teammitgliedschaft: Es definiert, welche Art von Your AI Connector-Konto jemand besitzt.

Dieser Endpunkt ist auf Your AI Connector-Mitarbeiter beschränkt, und der letzte verbleibende Dev kann nicht herabgestuft werden. Er ist der Vollständigkeit halber aufgeführt; er ist nicht Teil der Verwaltung Ihres eigenen Teams.

{
  "success": true,
  "targetUid": "uid_sam",
  "role": "Agency",
  "claimUpdated": true
}

Team-API-Fehler #

Team-Endpunkte geben den Standard-Fehlerumschlag zurück, immer mit error_code zusätzlich zum HTTP-Status:

{
  "success": false,
  "error_code": 403,
  "error": "Cannot grant \"full\" access to \"billing\" — exceeds your own permissions."
}

Die gemeinsamen Codes, die jeder Endpunkt zurückgeben kann — 429 (Ratenlimit) und 500 — sind mit Hinweisen zur Wiederholung unter Fehler & Paginierung aufgeführt.

Verwandte Themen #

• Teamverwaltung — dieselben Funktionen im Dashboard, mit Screenshots.
• Authentifizierung — wie man ein Firebase-ID-Token anstelle eines API-Schlüssels sendet.
• Kontakte-API — die Kontakte, auf die sich die Sichtbarkeitsbeschränkungen eines Mitglieds beziehen.