Référence API

L'API REST Stellary vous permet de gérer programmatiquement les organisations, espaces de travail, projets, tableaux, cartes et le pilotage stratégique. Tous les endpoints renvoient du JSON.

URL de base : http://localhost:3001 (auto-hébergé) ou l'URL de votre déploiement.

Authentification

Stellary prend en charge deux méthodes d'authentification. Les deux utilisent l'en-tête Authorizationavec un jeton Bearer :

Authorization: Bearer <token>

Jetons JWT

Obtenus en appelant POST /auth/login ou POST /auth/register. Les JWT expirent après 7 jours par défaut (configurable via JWT_EXPIRES_IN).

Jetons d'accès personnels (PAT)

Créés via POST /api-tokens. Les PAT supportent des permissions par portée et une expiration optionnelle. Le jeton complet n'est renvoyé qu'à la création — conservez-le en lieu sûr.

Les deux types de jetons fonctionnent avec tous les endpoints. Le backend tente d'abord la validation JWT, puis la recherche PAT.

Hiérarchie d'autorisation

Bearer Token validé (JWT ou PAT)
  ↓
OrgAccessGuard → vérifie que l'utilisateur est membre de :orgSlug
  ↓
WorkspaceAccessGuard → vérifie que l'utilisateur est membre de :wsSlug
  ↓
Gestionnaire de l'endpoint

Gestion des erreurs

Toutes les erreurs renvoient une structure JSON cohérente :

{
  "statusCode": 400,
  "message": "Validation failed",
  "error": "Bad Request"
}

Code	Signification	Quand
`400`	Bad Request	Échec de validation, champs manquants
`401`	Unauthorized	Jeton invalide / expiré / manquant
`403`	Forbidden	Rôle ou permissions insuffisants
`404`	Not Found	Ressource inexistante ou inaccessible
`409`	Conflict	Doublon, transition d'état invalide
`500`	Internal Error	Erreur serveur

Auth

Inscription, connexion et gestion du profil utilisateur.

POST

/auth/register

Créer un nouveau compte. Renvoie un JWT et l'objet utilisateur. Crée automatiquement une organisation et un espace de travail personnels.

Body Parameters

emailstringrequiredAdresse e-mail valide

passwordstringrequired8 à 128 caractères

namestringNom d’affichage, max 100 caractères

curl -X POST http://localhost:3001/auth/register \
  -H "Content-Type: application/json" \
  -d '{
  "email": "user@example.com",
  "password": "secure-pass-123",
  "name": "Jane Doe"
}'

Response201

{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "user": {
    "id": "665f1a2b3c4d5e6f7a8b9c0d",
    "email": "user@example.com",
    "name": "Jane Doe"
  }
}

POST

/auth/login

S'authentifier et recevoir un JWT.

Body Parameters

emailstringrequiredE-mail du compte

passwordstringrequiredMot de passe du compte

curl -X POST http://localhost:3001/auth/login \
  -H "Content-Type: application/json" \
  -d '{
  "email": "user@example.com",
  "password": "secure-pass-123"
}'

Response201

{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "user": {
    "id": "665f1a2b3c4d5e6f7a8b9c0d",
    "email": "user@example.com",
    "name": "Jane Doe",
    "pilotageRole": "owner"
  }
}

GET

/auth/me

Obtenir le profil de l'utilisateur actuellement authentifié.

curl http://localhost:3001/auth/me \
  -H "Authorization: Bearer YOUR_TOKEN"

Response200

{
  "user": {
    "id": "665f1a2b3c4d5e6f7a8b9c0d",
    "email": "user@example.com",
    "name": "Jane Doe",
    "pilotageRole": "owner"
  }
}

PATCH

/auth/me

Modifier le profil de l'utilisateur courant.

Body Parameters

namestringMaximum 100 caractères

curl -X PATCH http://localhost:3001/auth/me \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Jane Smith"
}'

POST

/auth/change-password

Changer le mot de passe de l'utilisateur courant. Nécessite le mot de passe actuel pour vérification.

Body Parameters

currentPasswordstringrequiredMot de passe actuel

newPasswordstringrequired8 à 128 caractères

curl -X POST http://localhost:3001/auth/change-password \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "currentPassword": "old-password",
  "newPassword": "new-secure-pass"
}'

Organisations

Les organisations sont le conteneur de plus haut niveau. Elles contiennent des espaces de travail et des membres.

POST

/organizations

Créer une nouvelle organisation. Le créateur en devient le propriétaire.

Body Parameters

namestringrequiredNom de l’organisation

slugstringrequired2 à 60 caractères, minuscules, alphanumériques + tirets

curl -X POST http://localhost:3001/organizations \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Acme Corp",
  "slug": "acme-corp"
}'

Response201

{
  "id": "665f1a2b...",
  "name": "Acme Corp",
  "slug": "acme-corp",
  "ownerId": "665f1a2b...",
  "createdAt": "2026-01-15T10:30:00Z"
}

GET

/organizations

Lister toutes les organisations dont l'utilisateur courant est membre.

curl http://localhost:3001/organizations \
  -H "Authorization: Bearer YOUR_TOKEN"

Response200

[
  {
    "id": "665f1a2b...",
    "name": "Acme Corp",
    "slug": "acme-corp",
    "myRole": "owner"
  }
]

GET

/organizations/:orgSlug

Obtenir une organisation par son slug. Nécessite d'être membre.

Path Parameters

orgSlugstringrequired

curl http://localhost:3001/organizations/acme \
  -H "Authorization: Bearer YOUR_TOKEN"

Response200

{
  "id": "665f1a2b...",
  "name": "Acme Corp",
  "slug": "acme-corp",
  "ownerId": "665f1a2b...",
  "myRole": "owner"
}

PATCH

/organizations/:orgSlug

Modifier les détails d'une organisation.

Path Parameters

orgSlugstringrequired

curl -X PATCH http://localhost:3001/organizations/acme \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Acme Corporation"
}'

DELETE

/organizations/:orgSlug

Supprimer une organisation ainsi que tous ses espaces de travail, projets et données. Propriétaire uniquement.

Path Parameters

orgSlugstringrequired

curl -X DELETE http://localhost:3001/organizations/acme \
  -H "Authorization: Bearer YOUR_TOKEN"

Membres de l'organisation

GET

/organizations/:orgSlug/members

Lister tous les membres d'une organisation avec leurs rôles.

Path Parameters

orgSlugstringrequired

curl http://localhost:3001/organizations/acme/members \
  -H "Authorization: Bearer YOUR_TOKEN"

Response200

[
  {
    "userId": "665f1a2b...",
    "role": "owner",
    "email": "owner@acme.com"
  },
  {
    "userId": "665f1b3c...",
    "role": "member",
    "email": "dev@acme.com"
  }
]

POST

/organizations/:orgSlug/members

Ajouter un membre à l'organisation par e-mail.

Path Parameters

orgSlugstringrequired

Body Parameters

emailstringrequiredE-mail de l’utilisateur à ajouter

rolestringrequired"admin" ou "member"

curl -X POST http://localhost:3001/organizations/acme/members \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "new-member@acme.com",
  "role": "member"
}'

PATCH

/organizations/:orgSlug/members/:userId

Modifier le rôle d'un membre. Impossible de changer le propriétaire.

Path Parameters

orgSlugstringrequired

userIdstringrequired

curl -X PATCH http://localhost:3001/organizations/acme/members/USER_ID \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "role": "admin"
}'

DELETE

/organizations/:orgSlug/members/:userId

Retirer un membre de l'organisation.

Path Parameters

orgSlugstringrequired

userIdstringrequired

curl -X DELETE http://localhost:3001/organizations/acme/members/USER_ID \
  -H "Authorization: Bearer YOUR_TOKEN"

Espaces de travail

Les espaces de travail se trouvent au sein des organisations et contiennent des projets. Chaque espace de travail possède sa propre liste de membres et ses rôles.

POST

/orgs/:orgSlug/workspaces

Créer un nouvel espace de travail au sein d'une organisation.

Path Parameters

orgSlugstringrequired

Body Parameters

namestringrequiredNom de l’espace de travail

slugstringrequired2 à 60 caractères, minuscules

curl -X POST http://localhost:3001/orgs/acme/workspaces \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Engineering",
  "slug": "engineering"
}'

GET

/orgs/:orgSlug/workspaces

Lister tous les espaces de travail de l'organisation auxquels l'utilisateur a accès.

Path Parameters

orgSlugstringrequired

curl http://localhost:3001/orgs/acme/workspaces \
  -H "Authorization: Bearer YOUR_TOKEN"

GET

/orgs/:orgSlug/workspaces/:wsSlug

Obtenir un espace de travail par son slug.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

curl http://localhost:3001/orgs/acme/workspaces/eng \
  -H "Authorization: Bearer YOUR_TOKEN"

Response200

{
  "id": "665f2d4e...",
  "name": "Engineering",
  "slug": "engineering",
  "organizationId": "665f1a2b...",
  "ownerId": "665f1a2b...",
  "isPersonal": false,
  "myRole": "admin",
  "myPilotageRole": "owner",
  "createdAt": "2026-01-15T10:30:00Z",
  "updatedAt": "2026-01-15T10:30:00Z"
}

Membres de l'espace de travail

POST

/orgs/:orgSlug/workspaces/:wsSlug/members/invite

Envoyer une invitation par e-mail pour rejoindre l'espace de travail. Crée un jeton d'invitation unique.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

Body Parameters

emailstringrequiredE-mail à inviter

rolestring"admin" ou "member"

curl -X POST http://localhost:3001/orgs/acme/workspaces/eng/members/invite \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "teammate@company.com",
  "role": "member"
}'

POST

/invitations/:token/accept

Accepter une invitation à un espace de travail en utilisant le jeton de l'e-mail d'invitation.

Path Parameters

tokenstringrequired

curl -X POST http://localhost:3001/invitations/INVITE_TOKEN/accept \
  -H "Authorization: Bearer YOUR_TOKEN"

PATCH

/orgs/:orgSlug/workspaces/:wsSlug/members/:userId

Modifier le rôle d'un membre dans l'espace de travail et/ou son rôle de pilotage.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

userIdstringrequired

Body Parameters

rolestring"admin" ou "member"

pilotageRolestring"viewer", "reviewer" ou "owner"

curl -X PATCH http://localhost:3001/orgs/acme/workspaces/eng/members/USER_ID \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "role": "admin",
  "pilotageRole": "reviewer"
}'

Projets

Les projets contiennent des tableaux kanban avec des colonnes et des cartes. Tous les endpoints de projet sont rattachés à un espace de travail.

POST

/orgs/:orgSlug/workspaces/:wsSlug/projects

Créer un nouveau projet dans l'espace de travail.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

Body Parameters

namestringrequiredNom du projet

curl -X POST http://localhost:3001/orgs/acme/workspaces/eng/projects \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Q1 Launch"
}'

Response201

{
  "id": "665f2d4e...",
  "name": "Q1 Launch",
  "workspaceId": "665f2d4e...",
  "createdAt": "2026-03-10T10:00:00Z"
}

GET

/orgs/:orgSlug/workspaces/:wsSlug/projects

Lister tous les projets de l'espace de travail.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

curl http://localhost:3001/orgs/acme/workspaces/eng/projects \
  -H "Authorization: Bearer YOUR_TOKEN"

GET

/orgs/:orgSlug/workspaces/:wsSlug/projects/:projectId

Obtenir un projet par son identifiant.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

projectIdstringrequired

curl http://localhost:3001/orgs/acme/workspaces/eng/projects/PROJ_ID \
  -H "Authorization: Bearer YOUR_TOKEN"

PATCH

/orgs/:orgSlug/workspaces/:wsSlug/projects/:projectId

Modifier les détails d'un projet.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

projectIdstringrequired

curl -X PATCH http://localhost:3001/orgs/acme/workspaces/eng/projects/PROJ_ID \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Q1 Launch v2"
}'

GET

/orgs/:orgSlug/workspaces/:wsSlug/projects/portfolio

Obtenir un résumé du portefeuille de tous les projets avec des métriques agrégées.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

curl http://localhost:3001/orgs/acme/workspaces/eng/projects/portfolio \
  -H "Authorization: Bearer YOUR_TOKEN"

GET

/orgs/:orgSlug/workspaces/:wsSlug/projects/templates

Lister les modèles de projet disponibles.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

curl http://localhost:3001/orgs/acme/workspaces/eng/projects/templates \
  -H "Authorization: Bearer YOUR_TOKEN"

Import & Export de projets

GET

/orgs/:orgSlug/workspaces/:wsSlug/projects/:projectId/export

Exporter un projet sous forme de snapshot JSON complet (colonnes, cartes, métadonnées).

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

projectIdstringrequired

curl http://localhost:3001/orgs/acme/workspaces/eng/projects/PROJ_ID/export \
  -H "Authorization: Bearer YOUR_TOKEN"

POST

/orgs/:orgSlug/workspaces/:wsSlug/projects/import

Importer un projet depuis une structure JSON. Supporte jusqu'à 50 colonnes et 500 cartes.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

curl -X POST http://localhost:3001/orgs/acme/workspaces/eng/projects/import \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "project": { "name": "Imported" },
  "columns": [
    { "name": "To Do" },
    { "name": "In Progress" },
    { "name": "Done" }
  ],
  "cards": [
    {
      "title": "First task",
      "columnIndex": 0,
      "priority": "medium"
    }
  ]
}'

Membres du projet

GET

/orgs/:orgSlug/workspaces/:wsSlug/projects/:projectId/members

Lister les membres du projet.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

projectIdstringrequired

curl http://localhost:3001/orgs/acme/workspaces/eng/projects/PROJ_ID/members \
  -H "Authorization: Bearer YOUR_TOKEN"

POST

/orgs/:orgSlug/workspaces/:wsSlug/projects/:projectId/members

Ajouter un membre au projet par e-mail.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

projectIdstringrequired

curl -X POST http://localhost:3001/orgs/acme/workspaces/eng/projects/PROJ_ID/members \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "dev@company.com"
}'

DELETE

/orgs/:orgSlug/workspaces/:wsSlug/projects/:projectId/members/:userId

Retirer un membre du projet.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

projectIdstringrequired

userIdstringrequired

curl -X DELETE http://localhost:3001/orgs/acme/workspaces/eng/projects/PROJ_ID/members/USER_ID \
  -H "Authorization: Bearer YOUR_TOKEN"

Colonnes

Les colonnes définissent les étapes du workflow sur un tableau de projet. Chaque colonne a un nom et un ordre.

POST

/orgs/:orgSlug/workspaces/:wsSlug/projects/:projectId/columns

Créer une nouvelle colonne.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

projectIdstringrequired

curl -X POST http://localhost:3001/orgs/acme/workspaces/eng/projects/PROJ_ID/columns \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "In Review"
}'

GET

/orgs/:orgSlug/workspaces/:wsSlug/projects/:projectId/columns

Lister toutes les colonnes d'un projet, triées par position.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

projectIdstringrequired

curl http://localhost:3001/orgs/acme/workspaces/eng/projects/PROJ_ID/columns \
  -H "Authorization: Bearer YOUR_TOKEN"

Response200

[
  {
    "id": "665f3e5f...",
    "name": "To Do",
    "projectId": "665f2d4e...",
    "order": 0,
    "createdAt": "2026-01-15T10:30:00Z"
  }
]

PATCH

/orgs/:orgSlug/workspaces/:wsSlug/projects/:projectId/columns/:columnId

Modifier le nom ou l'ordre d'une colonne.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

projectIdstringrequired

columnIdstringrequired

curl -X PATCH http://localhost:3001/orgs/acme/workspaces/eng/projects/PROJ_ID/columns/COL_ID \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Code Review"
}'

DELETE

/orgs/:orgSlug/workspaces/:wsSlug/projects/:projectId/columns/:columnId

Supprimer une colonne.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

projectIdstringrequired

columnIdstringrequired

curl -X DELETE http://localhost:3001/orgs/acme/workspaces/eng/projects/PROJ_ID/columns/COL_ID \
  -H "Authorization: Bearer YOUR_TOKEN"

Response200

{ "ok": true }

Cartes

Les cartes sont les éléments de travail principaux. Elles se trouvent dans des colonnes et supportent des métadonnées riches.

GET

/orgs/:orgSlug/workspaces/:wsSlug/projects/:projectId/cards

Lister toutes les cartes d'un projet (toutes colonnes confondues).

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

projectIdstringrequired

curl http://localhost:3001/orgs/acme/workspaces/eng/projects/PROJ_ID/cards \
  -H "Authorization: Bearer YOUR_TOKEN"

Response200

[
  {
    "id": "665f4f6a...",
    "title": "Design API endpoints",
    "description": "REST routes for billing module",
    "columnId": "665f3e5f...",
    "order": 0,
    "archived": false,
    "priority": "high",
    "dueDate": "2026-04-01T00:00:00Z",
    "assigneeId": "665f1a2b...",
    "checklist": [
      { "_id": "a1b2c3", "title": "List endpoints", "done": true, "order": 0 }
    ],
    "commentCount": 3,
    "attachmentCount": 1
  }
]

POST

/orgs/:orgSlug/workspaces/:wsSlug/projects/:projectId/columns/:columnId/cards

Créer une carte dans une colonne spécifique.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

projectIdstringrequired

columnIdstringrequired

Body Parameters

titlestringrequired1 à 500 caractères

descriptionstringMaximum 5000 caractères

prioritystringlow | medium | high

startDatestringDate ISO

Complex type — edit in code

dueDatestringDate ISO

assigneeIdstringMongoId du responsable

checklistarrayMaximum 100 éléments

Complex type — edit in code

curl -X POST http://localhost:3001/orgs/acme/workspaces/eng/projects/PROJ_ID/columns/COL_ID/cards \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "Implement billing API",
  "description": "See spec in docs",
  "priority": "high",
  "dueDate": "2026-04-01",
  "assigneeId": "665f1a2b...",
  "checklist": [
    {
      "title": "Setup routes",
      "done": false,
      "order": 0
    }
  ]
}'

PATCH

/orgs/:orgSlug/workspaces/:wsSlug/projects/:projectId/cards/:cardId

Modifier n'importe quel champ d'une carte. N'incluez que les champs à modifier. Définissez les champs nullables à null pour les effacer.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

projectIdstringrequired

cardIdstringrequired

curl -X PATCH http://localhost:3001/orgs/acme/workspaces/eng/projects/PROJ_ID/cards/CARD_ID \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "Updated title",
  "columnId": "665f3e5f...",
  "order": 2,
  "priority": "medium",
  "dueDate": null,
  "archived": true
}'

DELETE

/orgs/:orgSlug/workspaces/:wsSlug/projects/:projectId/cards/:cardId

Supprimer définitivement une carte.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

projectIdstringrequired

cardIdstringrequired

curl -X DELETE http://localhost:3001/orgs/acme/workspaces/eng/projects/PROJ_ID/cards/CARD_ID \
  -H "Authorization: Bearer YOUR_TOKEN"

Response200

{ "ok": true }

Commentaires

Commentaires sur les cartes. Le chemin de base inclut les identifiants du projet et de la carte.

GET

/orgs/:orgSlug/workspaces/:wsSlug/projects/:projectId/cards/:cardId/comments

Lister tous les commentaires d'une carte, triés par date de création.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

projectIdstringrequired

cardIdstringrequired

curl http://localhost:3001/orgs/acme/workspaces/eng/projects/PROJ_ID/cards/CARD_ID/comments \
  -H "Authorization: Bearer YOUR_TOKEN"

Response200

[
  {
    "id": "665f5a7b...",
    "cardId": "665f4f6a...",
    "authorId": "665f1a2b...",
    "authorName": "Jane Doe",
    "content": "Spec looks good, let's proceed.",
    "createdAt": "2026-03-10T14:22:00Z"
  }
]

POST

/orgs/:orgSlug/workspaces/:wsSlug/projects/:projectId/cards/:cardId/comments

Poster un commentaire sur une carte.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

projectIdstringrequired

cardIdstringrequired

Body Parameters

contentstringrequired1 à 2000 caractères

curl -X POST http://localhost:3001/orgs/acme/workspaces/eng/projects/PROJ_ID/cards/CARD_ID/comments \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "What about error handling?"
}'

DELETE

/orgs/:orgSlug/workspaces/:wsSlug/projects/:projectId/cards/:cardId/comments/:commentId

Supprimer un commentaire.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

projectIdstringrequired

cardIdstringrequired

commentIdstringrequired

curl -X DELETE http://localhost:3001/orgs/acme/workspaces/eng/projects/PROJ_ID/cards/CARD_ID/comments/CMT_ID \
  -H "Authorization: Bearer YOUR_TOKEN"

Pièces jointes

Fichiers joints aux cartes. Taille maximale : 10 Mo.

GET

/orgs/:orgSlug/workspaces/:wsSlug/projects/:projectId/cards/:cardId/attachments

Lister toutes les pièces jointes d'une carte.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

projectIdstringrequired

cardIdstringrequired

curl http://localhost:3001/orgs/acme/workspaces/eng/projects/PROJ_ID/cards/CARD_ID/attachments \
  -H "Authorization: Bearer YOUR_TOKEN"

Response200

[
  {
    "id": "665f6b8c...",
    "cardId": "665f4f6a...",
    "uploadedBy": "665f1a2b...",
    "originalName": "api-spec.pdf",
    "mimeType": "application/pdf",
    "size": 245760,
    "createdAt": "2026-03-10T14:30:00Z"
  }
]

POST

/orgs/:orgSlug/workspaces/:wsSlug/projects/:projectId/cards/:cardId/attachments

Envoyer un fichier. Utilisez multipart/form-data avec le champ 'file'.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

projectIdstringrequired

cardIdstringrequired

curl -X POST http://localhost:3001/orgs/acme/workspaces/eng/projects/PROJ_ID/cards/CARD_ID/attachments \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "file=@./document.pdf"

GET

/orgs/:orgSlug/workspaces/:wsSlug/projects/:projectId/cards/:cardId/attachments/:attachmentId

Télécharger une pièce jointe. Renvoie le flux brut du fichier avec le type MIME correct.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

projectIdstringrequired

cardIdstringrequired

attachmentIdstringrequired

curl http://localhost:3001/orgs/acme/workspaces/eng/projects/PROJ_ID/cards/CARD_ID/attachments/ATT_ID \
  -H "Authorization: Bearer YOUR_TOKEN"

DELETE

/orgs/:orgSlug/workspaces/:wsSlug/projects/:projectId/cards/:cardId/attachments/:attachmentId

Supprimer une pièce jointe.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

projectIdstringrequired

cardIdstringrequired

attachmentIdstringrequired

curl -X DELETE http://localhost:3001/orgs/acme/workspaces/eng/projects/PROJ_ID/cards/CARD_ID/attachments/ATT_ID \
  -H "Authorization: Bearer YOUR_TOKEN"

Notifications

Notifications basées sur l'activité pour l'utilisateur courant. Générées automatiquement lorsque des cartes sont créées, modifiées, déplacées, assignées ou commentées.

GET

/notifications

Lister les notifications de l'utilisateur courant.

Paramètres de requête

limitnumberNombre max de résultats (par défaut : 50)

unreadOnlystring"true" ou "1" pour filtrer les non lues uniquement

curl http://localhost:3001/notifications \
  -H "Authorization: Bearer YOUR_TOKEN"

Response200

[
  {
    "id": "665f7c9d...",
    "userId": "665f1a2b...",
    "readAt": null,
    "activity": {
      "type": "card_moved",
      "actorId": "665f1b3c...",
      "meta": {
        "fromColumn": "To Do",
        "toColumn": "In Progress"
      },
      "createdAt": "2026-03-10T15:00:00Z"
    }
  }
]

GET

/notifications/count

Obtenir le nombre de notifications non lues.

curl http://localhost:3001/notifications/count \
  -H "Authorization: Bearer YOUR_TOKEN"

Response200

{ "count": 12 }

PATCH

/notifications/read-all

Marquer toutes les notifications comme lues.

curl -X PATCH http://localhost:3001/notifications/read-all \
  -H "Authorization: Bearer YOUR_TOKEN"

PATCH

/notifications/:id/read

Marquer une notification comme lue.

Path Parameters

idstringrequired

curl -X PATCH http://localhost:3001/notifications/ID/read \
  -H "Authorization: Bearer YOUR_TOKEN"

Types d'activité

Type	Déclenché quand
`card_created`	Une nouvelle carte est créée
`card_updated`	Les champs d'une carte sont modifiés
`card_moved`	Une carte est déplacée vers une autre colonne
`card_archived`	Une carte est archivée
`card_deleted`	Une carte est définitivement supprimée
`card_assigned`	Le responsable d'une carte change
`comment_added`	Un commentaire est posté sur une carte
`member_added`	Un membre rejoint le projet
`member_removed`	Un membre est retiré

Pilotage

Le centre de commandement stratégique. Gère les missions, priorités, tâches, décisions, documentation et actions proposées par l'IA. Tous les endpoints sont rattachés à un espace de travail.

GET

/orgs/:orgSlug/workspaces/:wsSlug/pilotage/state

Obtenir l'état complet du pilotage pour un espace de travail. Mêmes données exposées aux agents IA via l'outil MCP get_pilotage_state.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

Paramètres de requête

profilestringpilotage | execution | revue (par défaut : pilotage)

intentstringweekly_review | daily_execution | sprint_planning | context_only

detailLevelstringminimal | standard | detailed (par défaut : standard)

curl http://localhost:3001/orgs/acme/workspaces/eng/pilotage/state \
  -H "Authorization: Bearer YOUR_TOKEN"

Response200

{
  "cycle": "v8",
  "contractVersion": 7,
  "missions": [
    {
      "id": "m-001",
      "objective": "Implement billing module",
      "module": "billing",
      "status": "in_progress",
      "blockedReason": null
    }
  ],
  "activePriorities": [...],
  "todos": [...],
  "decisions": [...],
  "activeDocs": [...],
  "usageContext": {
    "profile": "pilotage",
    "role": "owner",
    "intent": "weekly_review"
  }
}

Missions

POST

/orgs/:orgSlug/workspaces/:wsSlug/pilotage/missions

Créer une nouvelle mission.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

Body Parameters

objectivestringrequiredObjectif de la mission

modulestringNom du module

curl -X POST http://localhost:3001/orgs/acme/workspaces/eng/pilotage/missions \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "objective": "Implement billing module",
  "module": "billing"
}'

PATCH

/orgs/:orgSlug/workspaces/:wsSlug/pilotage/missions/:id

Modifier le statut ou les détails d'une mission.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

idstringrequired

Body Parameters

statusstringto_launch | in_progress | blocked | done

blockedReasonstringMax 200 caractères, ou null pour effacer

curl -X PATCH http://localhost:3001/orgs/acme/workspaces/eng/pilotage/missions/ID \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "blocked",
  "blockedReason": "Waiting on API"
}'

Priorités

POST

/orgs/:orgSlug/workspaces/:wsSlug/pilotage/priorities

Créer une nouvelle priorité.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

curl -X POST http://localhost:3001/orgs/acme/workspaces/eng/pilotage/priorities \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "label": "Ship billing MVP",
  "module": "billing"
}'

Tâches

POST

/orgs/:orgSlug/workspaces/:wsSlug/pilotage/todos

Créer une nouvelle tâche.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

Body Parameters

labelstringrequiredLibellé de la tâche

missionIdstringLier à une mission

priorityIdstringLier à une priorité

curl -X POST http://localhost:3001/orgs/acme/workspaces/eng/pilotage/todos \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "label": "Write Stripe integration tests",
  "missionId": "m-001",
  "priorityId": "p-001"
}'

PATCH

/orgs/:orgSlug/workspaces/:wsSlug/pilotage/todos/:id

Modifier le statut d'une tâche.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

idstringrequired

Body Parameters

statusstringtodo | in_progress | blocked | done

curl -X PATCH http://localhost:3001/orgs/acme/workspaces/eng/pilotage/todos/ID \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "done"
}'

Décisions

POST

/orgs/:orgSlug/workspaces/:wsSlug/pilotage/decisions

Enregistrer une décision stratégique.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

Body Parameters

titlestringrequiredTitre de la décision

impactstringDescription de l’impact

curl -X POST http://localhost:3001/orgs/acme/workspaces/eng/pilotage/decisions \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "Use Stripe over custom billing",
  "impact": "Reduces dev time by 3 weeks, adds 2.9% transaction fee"
}'

Documents actifs

POST

/orgs/:orgSlug/workspaces/:wsSlug/pilotage/docs

Enregistrer un document actif.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

Body Parameters

titlestringrequiredTitre du document

ownerstringNom du propriétaire

sourceTypestringproduct | tech | sprint | ops

curl -X POST http://localhost:3001/orgs/acme/workspaces/eng/pilotage/docs \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "Billing API Spec v2",
  "owner": "Jane Doe",
  "sourceType": "tech"
}'

Actions proposées (Révision IA)

POST

/orgs/:orgSlug/workspaces/:wsSlug/pilotage/actions/propose

Soumettre une action proposée par l'IA pour révision humaine.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

Body Parameters

actionTypestringrequiredMax 100 caractères

explanationstringrequiredMax 500 caractères

payloadobjectDonnées de contexte optionnelles

Complex type — edit in code

curl -X POST http://localhost:3001/orgs/acme/workspaces/eng/pilotage/actions/propose \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "actionType": "move_card",
  "explanation": "All subtasks complete, move to Done",
  "payload": {
    "cardId": "665f4f6a...",
    "targetColumn": "Done"
  }
}'

Response201

{
  "id": "act-001",
  "actionType": "move_card",
  "explanation": "All subtasks complete, move to Done",
  "status": "suggested",
  "payload": {
    "cardId": "665f4f6a...",
    "targetColumn": "Done"
  },
  "createdAt": "2026-03-10T15:30:00Z"
}

GET

/orgs/:orgSlug/workspaces/:wsSlug/pilotage/actions

Lister les actions proposées, avec filtre optionnel par statut.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

Paramètres de requête

statusstringsuggested | approved | rejected | applied

curl http://localhost:3001/orgs/acme/workspaces/eng/pilotage/actions \
  -H "Authorization: Bearer YOUR_TOKEN"

POST

/orgs/:orgSlug/workspaces/:wsSlug/pilotage/actions/:id/review

Approuver ou rejeter une action proposée.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

idstringrequired

Body Parameters

approvedbooleanrequiredtrue pour approuver, false pour rejeter

reasonstringOptionnel, max 200 caractères

curl -X POST http://localhost:3001/orgs/acme/workspaces/eng/pilotage/actions/ID/review \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "approved": true,
  "reason": "Looks correct"
}'

POST

/orgs/:orgSlug/workspaces/:wsSlug/pilotage/actions/:id/apply

Appliquer une action approuvée. Fonctionne uniquement sur les actions ayant le statut 'approved'.

Path Parameters

orgSlugstringrequired

wsSlugstringrequired

idstringrequired

curl -X POST http://localhost:3001/orgs/acme/workspaces/eng/pilotage/actions/ID/apply \
  -H "Authorization: Bearer YOUR_TOKEN"

Jetons API

Gérez les jetons d'accès personnels pour un accès programmatique à l'API. Ces endpoints nécessitent une authentification JWT (et non PAT) pour éviter l'escalade de jetons.

POST

/api-tokens

Créer un nouveau jeton. La valeur complète du jeton n'est renvoyée qu'une seule fois.

Body Parameters

namestringrequiredMax 100 caractères

scopesarrayPar défaut toutes les portées

Complex type — edit in code

expiresAtstringDate ISO ou null pour sans expiration

curl -X POST http://localhost:3001/api-tokens \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "CI Pipeline",
  "scopes": [
    "projects:read",
    "projects:write"
  ],
  "expiresAt": "2027-01-01T00:00:00Z"
}'

Response201

{
  "id": "665f8dae...",
  "token": "synth_a1b2c3d4e5f6...",
  "name": "CI Pipeline",
  "prefix": "synth_a1b2",
  "scopes": ["projects:read", "projects:write"],
  "expiresAt": "2027-01-01T00:00:00Z",
  "createdAt": "2026-03-10T16:00:00Z"
}

GET

/api-tokens

Lister tous les jetons de l'utilisateur courant. N'inclut pas la valeur complète du jeton.

curl http://localhost:3001/api-tokens \
  -H "Authorization: Bearer YOUR_TOKEN"

Response200

[
  {
    "id": "665f8dae...",
    "name": "CI Pipeline",
    "prefix": "synth_a1b2",
    "scopes": ["projects:read", "projects:write"],
    "expiresAt": "2027-01-01T00:00:00Z",
    "lastUsedAt": "2026-03-12T09:15:00Z",
    "createdAt": "2026-03-10T16:00:00Z"
  }
]

DELETE

/api-tokens/:id

Révoquer définitivement un jeton.

Path Parameters

idstringrequired

curl -X DELETE http://localhost:3001/api-tokens/ID \
  -H "Authorization: Bearer YOUR_TOKEN"

Portées disponibles

Portée	Donne accès à
`projects:read`	Lecture des projets, colonnes, cartes, commentaires, pièces jointes
`projects:write`	Création/modification/suppression de projets, colonnes, cartes, commentaires, pièces jointes
`pilotage:read`	Lecture de l'état du pilotage (missions, priorités, tâches, décisions)
`pilotage:write`	Création/modification de missions, tâches, décisions ; proposition d'actions
`notifications:read`	Lecture et gestion des notifications
`account:read`	Lecture du profil utilisateur
`account:write`	Modification du profil utilisateur

Scopes

Les scopes sont des paquets de travail ou phases au sein d'un projet. Chaque scope possède ses propres colonnes, cartes et vues (Kanban, Liste, Calendrier, Roadmap, Stats).

POST

/…/projects/:projectId/scopes

Créer un scope dans un projet.

Path Parameters

projectIdstringrequired

curl -X POST http://localhost:3001/…/projects/PROJ_ID/scopes \
  -H "Authorization: Bearer YOUR_TOKEN"

GET

/…/projects/:projectId/scopes

Lister les scopes d'un projet.

Path Parameters

projectIdstringrequired

curl http://localhost:3001/…/projects/PROJ_ID/scopes \
  -H "Authorization: Bearer YOUR_TOKEN"

GET

/…/scopes/:scopeId

Obtenir les détails d'un scope.

Path Parameters

scopeIdstringrequired

curl http://localhost:3001/…/scopes/SCOPEID \
  -H "Authorization: Bearer YOUR_TOKEN"

PATCH

/…/scopes/:scopeId

Modifier le nom ou les paramètres d'un scope.

Path Parameters

scopeIdstringrequired

curl -X PATCH http://localhost:3001/…/scopes/SCOPEID \
  -H "Authorization: Bearer YOUR_TOKEN"

DELETE

/…/scopes/:scopeId

Supprimer un scope et tout son contenu.

Path Parameters

scopeIdstringrequired

curl -X DELETE http://localhost:3001/…/scopes/SCOPEID \
  -H "Authorization: Bearer YOUR_TOKEN"

Vues de scope

Chaque scope supporte 5 types de vues : kanban, list, calendar, roadmap, stats.

GET

/…/scopes/:scopeId/views

Lister les vues disponibles et la vue active.

Path Parameters

scopeIdstringrequired

curl http://localhost:3001/…/scopes/SCOPEID/views \
  -H "Authorization: Bearer YOUR_TOKEN"

PATCH

/…/scopes/:scopeId/views

Changer le type de vue active.

Path Parameters

scopeIdstringrequired

curl -X PATCH http://localhost:3001/…/scopes/SCOPEID/views \
  -H "Authorization: Bearer YOUR_TOKEN"

Labels

Étiquettes colorées pour catégoriser les cartes. Les labels sont définis au niveau du projet.

POST

/…/projects/:projectId/labels

Créer un label avec un nom et une couleur.

Path Parameters

projectIdstringrequired

curl -X POST http://localhost:3001/…/projects/PROJ_ID/labels \
  -H "Authorization: Bearer YOUR_TOKEN"

GET

/…/projects/:projectId/labels

Lister les labels du projet.

Path Parameters

projectIdstringrequired

curl http://localhost:3001/…/projects/PROJ_ID/labels \
  -H "Authorization: Bearer YOUR_TOKEN"

PATCH

/…/labels/:labelId

Modifier le nom ou la couleur d'un label.

Path Parameters

labelIdstringrequired

curl -X PATCH http://localhost:3001/…/labels/LABELID \
  -H "Authorization: Bearer YOUR_TOKEN"

DELETE

/…/labels/:labelId

Supprimer un label. Le retire de toutes les cartes.

Path Parameters

labelIdstringrequired

curl -X DELETE http://localhost:3001/…/labels/LABELID \
  -H "Authorization: Bearer YOUR_TOKEN"

POST

/…/cards/:cardId/labels/:labelId

Ajouter un label à une carte.

Path Parameters

cardIdstringrequired

labelIdstringrequired

curl -X POST http://localhost:3001/…/cards/CARD_ID/labels/LABELID \
  -H "Authorization: Bearer YOUR_TOKEN"

DELETE

/…/cards/:cardId/labels/:labelId

Retirer un label d'une carte.

Path Parameters

cardIdstringrequired

labelIdstringrequired

curl -X DELETE http://localhost:3001/…/cards/CARD_ID/labels/LABELID \
  -H "Authorization: Bearer YOUR_TOKEN"

Champs personnalisés

Champs de métadonnées personnalisés au niveau du projet. Types supportés : text, number, select, multi-select, date, boolean.

POST

/…/projects/:projectId/custom-fields

Créer un champ personnalisé. Pour select/multi-select, inclure le tableau d'options.

Path Parameters

projectIdstringrequired

curl -X POST http://localhost:3001/…/projects/PROJ_ID/custom-fields \
  -H "Authorization: Bearer YOUR_TOKEN"

GET

/…/projects/:projectId/custom-fields

Lister les définitions de champs du projet.

Path Parameters

projectIdstringrequired

curl http://localhost:3001/…/projects/PROJ_ID/custom-fields \
  -H "Authorization: Bearer YOUR_TOKEN"

PATCH

/…/custom-fields/:fieldId

Modifier le nom, le type ou les options d'un champ.

Path Parameters

fieldIdstringrequired

curl -X PATCH http://localhost:3001/…/custom-fields/FIELDID \
  -H "Authorization: Bearer YOUR_TOKEN"

DELETE

/…/custom-fields/:fieldId

Supprimer un champ. Retire les valeurs de toutes les cartes.

Path Parameters

fieldIdstringrequired

curl -X DELETE http://localhost:3001/…/custom-fields/FIELDID \
  -H "Authorization: Bearer YOUR_TOKEN"

PATCH

/…/cards/:cardId/custom-fields

Définir les valeurs des champs personnalisés d'une carte.

Path Parameters

cardIdstringrequired

curl -X PATCH http://localhost:3001/…/cards/CARD_ID/custom-fields \
  -H "Authorization: Bearer YOUR_TOKEN"

Relations entre cartes

Lier des cartes avec des relations typées : blocks / blocked_by, related_to, duplicates, parent_of.

POST

/…/cards/:cardId/relations

Créer une relation. Body : { targetCardId, type }.

Path Parameters

cardIdstringrequired

curl -X POST http://localhost:3001/…/cards/CARD_ID/relations \
  -H "Authorization: Bearer YOUR_TOKEN"

GET

/…/cards/:cardId/relations

Lister les relations d'une carte.

Path Parameters

cardIdstringrequired

curl http://localhost:3001/…/cards/CARD_ID/relations \
  -H "Authorization: Bearer YOUR_TOKEN"

DELETE

/…/relations/:relationId

Supprimer une relation.

Path Parameters

relationIdstringrequired

curl -X DELETE http://localhost:3001/…/relations/RELATIONID \
  -H "Authorization: Bearer YOUR_TOKEN"

Checklists

Éléments de checklist dans une carte. Le pourcentage de progression est calculé automatiquement.

POST

/…/cards/:cardId/checklist

Ajouter un élément. Body : { title }.

Path Parameters

cardIdstringrequired

curl -X POST http://localhost:3001/…/cards/CARD_ID/checklist \
  -H "Authorization: Bearer YOUR_TOKEN"

PATCH

/…/cards/:cardId/checklist/:itemId

Modifier un élément (cocher/décocher, renommer).

Path Parameters

cardIdstringrequired

itemIdstringrequired

curl -X PATCH http://localhost:3001/…/cards/CARD_ID/checklist/ITEMID \
  -H "Authorization: Bearer YOUR_TOKEN"

DELETE

/…/cards/:cardId/checklist/:itemId

Supprimer un élément.

Path Parameters

cardIdstringrequired

itemIdstringrequired

curl -X DELETE http://localhost:3001/…/cards/CARD_ID/checklist/ITEMID \
  -H "Authorization: Bearer YOUR_TOKEN"

Documents

Base de connaissances avec 8 types : document, spec, brief, adr, note, reference, template, spreadsheet.

POST

/…/documents

Créer un document. Body : title, docType, content (JSON TipTap), parentId optionnel.

curl -X POST http://localhost:3001/…/documents \
  -H "Authorization: Bearer YOUR_TOKEN"

GET

/…/documents

Lister les documents. Filtrer par docType, contexte ou parentId.

curl http://localhost:3001/…/documents \
  -H "Authorization: Bearer YOUR_TOKEN"

GET

/…/documents/:documentId

Obtenir le document complet avec son contenu.

Path Parameters

documentIdstringrequired

curl http://localhost:3001/…/documents/DOCUMENTID \
  -H "Authorization: Bearer YOUR_TOKEN"

PATCH

/…/documents/:documentId

Modifier le titre, le contenu ou les métadonnées.

Path Parameters

documentIdstringrequired

curl -X PATCH http://localhost:3001/…/documents/DOCUMENTID \
  -H "Authorization: Bearer YOUR_TOKEN"

DELETE

/…/documents/:documentId

Supprimer un document.

Path Parameters

documentIdstringrequired

curl -X DELETE http://localhost:3001/…/documents/DOCUMENTID \
  -H "Authorization: Bearer YOUR_TOKEN"

Workflow de revue

Statuts : draft → pending_review → approved / changes_requested.

POST

/…/documents/:documentId/submit-review

Soumettre un document pour revue.

Path Parameters

documentIdstringrequired

curl -X POST http://localhost:3001/…/documents/DOCUMENTID/submit-review \
  -H "Authorization: Bearer YOUR_TOKEN"

POST

/…/documents/:documentId/review

Réviser un document. Body : { status, notes }.

Path Parameters

documentIdstringrequired

curl -X POST http://localhost:3001/…/documents/DOCUMENTID/review \
  -H "Authorization: Bearer YOUR_TOKEN"

Agents

Agents IA au niveau du workspace avec outils et niveaux d'autonomie configurables. Trois modes : supervised, autonomous, approval.

POST

/…/agents

Créer un agent. Body : name, slug, autonomyMode, outils, limites.

curl -X POST http://localhost:3001/…/agents \
  -H "Authorization: Bearer YOUR_TOKEN"

GET

/…/agents

Lister les agents du workspace.

curl http://localhost:3001/…/agents \
  -H "Authorization: Bearer YOUR_TOKEN"

GET

/…/agents/:agentId

Obtenir les détails d'un agent.

Path Parameters

agentIdstringrequired

curl http://localhost:3001/…/agents/AGENTID \
  -H "Authorization: Bearer YOUR_TOKEN"

PATCH

/…/agents/:agentId

Modifier la configuration d'un agent.

Path Parameters

agentIdstringrequired

curl -X PATCH http://localhost:3001/…/agents/AGENTID \
  -H "Authorization: Bearer YOUR_TOKEN"

DELETE

/…/agents/:agentId

Supprimer un agent.

Path Parameters

agentIdstringrequired

curl -X DELETE http://localhost:3001/…/agents/AGENTID \
  -H "Authorization: Bearer YOUR_TOKEN"

Missions

Tâches IA sur les cartes avec streaming SSE en temps réel. Cycle : queued → running → awaiting_approval → completed / failed.

POST

/…/agents/:agentId/missions

Créer une mission. Body : { cardId, prompt }.

Path Parameters

agentIdstringrequired

curl -X POST http://localhost:3001/…/agents/AGENTID/missions \
  -H "Authorization: Bearer YOUR_TOKEN"

GET

/…/agents/:agentId/missions

Lister les missions d'un agent.

Path Parameters

agentIdstringrequired

curl http://localhost:3001/…/agents/AGENTID/missions \
  -H "Authorization: Bearer YOUR_TOKEN"

GET

/…/missions/:missionId

Obtenir les détails et la progression d'une mission.

Path Parameters

missionIdstringrequired

curl http://localhost:3001/…/missions/MISSIONID \
  -H "Authorization: Bearer YOUR_TOKEN"

POST

/…/missions/:missionId/cancel

Annuler une mission en cours.

Path Parameters

missionIdstringrequired

curl -X POST http://localhost:3001/…/missions/MISSIONID/cancel \
  -H "Authorization: Bearer YOUR_TOKEN"

Propositions

Les agents supervisés proposent des changements avant exécution.

GET

/…/missions/:missionId/proposals

Lister les propositions d'une mission.

Path Parameters

missionIdstringrequired

curl http://localhost:3001/…/missions/MISSIONID/proposals \
  -H "Authorization: Bearer YOUR_TOKEN"

POST

/…/proposals/:proposalId/approve

Approuver une proposition.

Path Parameters

proposalIdstringrequired

curl -X POST http://localhost:3001/…/proposals/PROPOSALID/approve \
  -H "Authorization: Bearer YOUR_TOKEN"

POST

/…/proposals/:proposalId/reject

Rejeter une proposition. Body : { reason }.

Path Parameters

proposalIdstringrequired

curl -X POST http://localhost:3001/…/proposals/PROPOSALID/reject \
  -H "Authorization: Bearer YOUR_TOKEN"

Automatisations

Règles d'automatisation au niveau du projet. 7 types de déclencheurs : task_moved, task_created, checklist_complete, due_date_reached, task_status_changed, task_assigned, task_added_to_board.

POST

/…/automations

Créer une règle. Body : trigger, conditions (JSON), action.

curl -X POST http://localhost:3001/…/automations \
  -H "Authorization: Bearer YOUR_TOKEN"

GET

/…/automations

Lister les règles d'automatisation du projet.

curl http://localhost:3001/…/automations \
  -H "Authorization: Bearer YOUR_TOKEN"

GET

/…/automations/:ruleId

Obtenir les détails d'une règle.

Path Parameters

ruleIdstringrequired

curl http://localhost:3001/…/automations/RULEID \
  -H "Authorization: Bearer YOUR_TOKEN"

PATCH

/…/automations/:ruleId

Modifier une règle.

Path Parameters

ruleIdstringrequired

curl -X PATCH http://localhost:3001/…/automations/RULEID \
  -H "Authorization: Bearer YOUR_TOKEN"

DELETE

/…/automations/:ruleId

Supprimer une règle.

Path Parameters

ruleIdstringrequired

curl -X DELETE http://localhost:3001/…/automations/RULEID \
  -H "Authorization: Bearer YOUR_TOKEN"

PATCH

/…/automations/:ruleId/toggle

Activer ou désactiver une règle.

Path Parameters

ruleIdstringrequired

curl -X PATCH http://localhost:3001/…/automations/RULEID/toggle \
  -H "Authorization: Bearer YOUR_TOKEN"

Traces d'exécution

Chaque exécution est tracée avec l'acteur, la cible, l'horodatage et le résultat.

GET

/…/automations/:ruleId/traces

Lister les traces d'exécution d'une règle.

Path Parameters

ruleIdstringrequired

curl http://localhost:3001/…/automations/RULEID/traces \
  -H "Authorization: Bearer YOUR_TOKEN"

Assistant Projet IA

Création de projet guidée par IA en plusieurs étapes : Cadrage → Raffinement (questions adaptatives) → Génération de roadmap → Exécution.

POST

/…/project-drafts

Créer un brouillon de projet. Body : { name, description, contextDocuments }.

curl -X POST http://localhost:3001/…/project-drafts \
  -H "Authorization: Bearer YOUR_TOKEN"

GET

/…/project-drafts

Lister les brouillons du workspace.

curl http://localhost:3001/…/project-drafts \
  -H "Authorization: Bearer YOUR_TOKEN"

GET

/…/project-drafts/:draftId

Obtenir les détails d'un brouillon.

Path Parameters

draftIdstringrequired

curl http://localhost:3001/…/project-drafts/DRAFTID \
  -H "Authorization: Bearer YOUR_TOKEN"

POST

/…/project-drafts/:draftId/refine

Soumettre les réponses de raffinement.

Path Parameters

draftIdstringrequired

curl -X POST http://localhost:3001/…/project-drafts/DRAFTID/refine \
  -H "Authorization: Bearer YOUR_TOKEN"

POST

/…/project-drafts/:draftId/generate-roadmap

Générer une roadmap phasée.

Path Parameters

draftIdstringrequired

curl -X POST http://localhost:3001/…/project-drafts/DRAFTID/generate-roadmap \
  -H "Authorization: Bearer YOUR_TOKEN"

POST

/…/project-drafts/:draftId/execute

Exécuter : créer le projet avec phases en colonnes et livrables en cartes.

Path Parameters

draftIdstringrequired

curl -X POST http://localhost:3001/…/project-drafts/DRAFTID/execute \
  -H "Authorization: Bearer YOUR_TOKEN"

DELETE

/…/project-drafts/:draftId

Supprimer un brouillon.

Path Parameters

draftIdstringrequired

curl -X DELETE http://localhost:3001/…/project-drafts/DRAFTID \
  -H "Authorization: Bearer YOUR_TOKEN"

Pour l'intégration IA via MCP, consultez le guide d'intégration MCP. Pour un tutoriel guidé, consultez Démarrage rapide.