Quickstart API

Créez une clé API, envoyez votre première requête, puis configurez un webhook.

1. Créer une clé API

curl -X POST https://api.workload.com/api/v1/api-keys \
  -H "Authorization: Bearer YOUR_ADMIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"My integration","scopes":["projects:read","projects:write"]}'

Exemple avec scopes scaled agile :

curl -X POST https://api.workload.com/api/v1/api-keys \
  -H "Authorization: Bearer YOUR_ADMIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Scaled agile BI","scopes":["programs:read","planning-increments:read","dependencies:read"]}'

2. Lister les projets

curl https://api.workload.com/api/v1/projects \
  -H "Authorization: Bearer YOUR_API_KEY"

3. Lire programmes & PI (scaled agile)

Si scaledAgileEnabled est activé, utilisez les scopes programs:read, planning-increments:read et dependencies:read.

curl "https://api.workload.com/api/v1/programs" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl "https://api.workload.com/api/v1/planning-increments?programId=PROGRAM_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

            curl "https://api.workload.com/api/v1/dependencies?programId=PROGRAM_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

4. Pont capacité ServiceNow (CSV / IntegrationHub / REST v1)

Pas de connecteur Marketplace. Scopes : team-members:write, allocations:write, timesheet:read. Recette : /docs/integrations/servicenow. Ne pas mapper incidents → projets ni CMDB → équipes.

curl -X POST https://api.workload.com/api/v1/api-keys \
  -H "Authorization: Bearer YOUR_ADMIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"ServiceNow capacity bridge","scopes":["team-members:write","allocations:write","timesheet:read"]}'

4. Pont capacité ServiceNow (CSV / IntegrationHub / REST v1) →