API-ReferenzGET

Workspaces auflisten

Listet die Workspaces auf, in denen RedReplier-Zugangsdaten handeln können, mit Rolle und Berechtigungen in jedem.

GEThttps://ai.redreplier.com/ai-app/api/v1/workspaces

Listet die Workspaces auf, in denen RedReplier-Zugangsdaten handeln können, mit Rolle und Berechtigungen in jedem.

Bearer-Token (RedReplier-API-Token)

Authentifizierung

Sende ein RedReplier-API-Token oder ein OAuth-Access-Token als Bearer-Token. Dieser Endpoint steht jedem gültigen Schlüssel offen.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Parameter

Dieser Endpoint hat keine Pfad- oder Query-Parameter.

Request-Body

Dieser Endpoint benötigt keinen JSON-Body.

Antwort

Gibt ein Objekt mit einem workspaces-Array zurück.

  • workspaces (Workspace[]): Workspaces, in denen diese Zugangsdaten handeln können.

Workspace-Objekt

  • id (string): Workspace-ID. Sende sie im Header X-Workspace-Id, um in diesem Workspace zu handeln.
  • name (string): Name des Workspace.
  • organization ({ id, name }): Organisation, der der Workspace gehört.
  • role ({ key, name }): Deine Rolle in diesem Workspace. key ist admin, editor, contributor oder viewer.
  • permissions (string[]): Berechtigungsschlüssel, die du in diesem Workspace hast, zum Beispiel redreplier.write.
  • isDefault (boolean): True für den Workspace, in dem ein Aufruf ohne Header X-Workspace-Id landet.
  • current (boolean): True für den Workspace, in dem dieser Aufruf gelandet ist.

Beispielanfrage

curl -s https://ai.redreplier.com/ai-app/api/v1/workspaces \
  -H 'Authorization: Bearer redreplier_test_1234567890'

Hinweise

Eine OAuth-Anmeldung, etwa über den Claude- oder ChatGPT-Connector, erreicht jeden Workspace, dem das Mitglied angehört, über Organisationen hinweg. Ein API-Schlüssel erreicht nur seinen eigenen Workspace, die Liste hat also einen Eintrag. Wähle einen Workspace, indem du seine id bei jeder anderen Anfrage im Header X-Workspace-Id sendest.

Fehler

  • 401 Unauthorized: Fehlendes oder ungültiges Bearer-Token.
  • 500 Internal Server Error: Unerwarteter Serverfehler.
Beispielanfrage (curl)
curl --request GET \
  --url https://ai.redreplier.com/ai-app/api/v1/workspaces \
  --header 'Authorization: Bearer redreplier_test_1234567890'
200
{
  "workspaces": [
    {
      "id": "acct_7dK9pQ2",
      "name": "Acme CRM",
      "organization": { "id": "org_01J8ZK4M2Q", "name": "Acme" },
      "role": { "key": "editor", "name": "Editor" },
      "permissions": ["workspace.read", "redreplier.write"],
      "isDefault": true,
      "current": true
    },
    {
      "id": "acct_3Hm8XwR",
      "name": "Northwind",
      "organization": { "id": "org_01J9P7T3XB", "name": "Northwind Studio" },
      "role": { "key": "viewer", "name": "Viewer" },
      "permissions": ["workspace.read"],
      "isDefault": false,
      "current": false
    }
  ]
}