Gurren API

Workspaces

Lister et créer des workspaces, et scoper les requêtes API par workspace.

Workspaces

Un workspace est un pool d'automations. La plupart des endpoints peuvent être scopés à un workspace ; commencez par récupérer vos IDs ici.

Scopes : automation:read (liste), automation:write (création).

Lister les workspaces

GET /api/v1/workspaces
[
  { "id": "665a1b2c3d4e5f6a7b8c9d0e", "name": "Default", "isDefault": true },
  { "id": "665a1b2c3d4e5f6a7b8c9d0f", "name": "Recrutement", "isDefault": false }
]

Créer un workspace

POST /api/v1/workspaces
{ "name": "Recrutement", "description": "Bots de candidature" }

Réponse : { "success": true, "workspace": { "id": "…", "name": "Recrutement" } }

Scoper les requêtes par workspace

EndpointComment
GET /api/v1/automations?workspaceId=…Liste les automations d'un workspace
POST /api/v1/automations (body workspaceId)Crée l'automation dans ce workspace
POST /api/v1/automations/generate (body workspaceId)Génère dans ce workspace
POST /api/v1/intents/run · /enqueue (body workspaceId)Résout/tague l'intention dans ce workspace
GET /api/v1/executions?workspaceId=…Exécutions des automations de ce workspace
GET /api/v1/jobs?workspaceId=…Jobs d'intention de ce workspace

À défaut de workspaceId, le workspace par défaut est utilisé (créé automatiquement au premier accès).

On this page