> Source: https://vitna.ai/docs/api/v1/engine/org-workloads
> Raw Markdown: https://vitna.ai/docs/api/v1/engine/org-workloads.md
> Corpus index: https://vitna.ai/llms.txt
# Organisation workloads
List, create, edit and transition workloads in your organisation's register over HTTP, including reversible pausing and permanent archiving that free active workload slots without erasing decision history.
```
GET /api/v1/org/workloads
POST /api/v1/org/workloads
GET /api/v1/org/workloads/{slug}
POST /api/v1/org/workloads/{slug}
```
```
Authorization: Bearer vitna_push_...
```
```bash
curl -H "authorization: Bearer vitna_push_..." https://vitna.ai/api/v1/org/workloads
curl -X POST https://vitna.ai/api/v1/org/workloads \
-H "authorization: Bearer vitna_push_..." \
-H "content-type: application/json" \
-d '{
"slug": "support-triage",
"name": "Support triage",
"classId": "model",
"incumbentSkuId": "openai/gpt-5.6-luna",
"unitLabel": "ticket",
"unitProfile": { "inputTokensPerUnit": 1800, "outputTokensPerUnit": 400 },
"priority": "economics"
}'
```
## Scopes and plan allowance
Reads (`GET`) accept either a `platform` or `push` key. Writes (`POST`) require a `platform` key (`vitna_key_...`; `router` keys are refused with `403 forbidden_scope`).
Every workload carries a `status` in `active`, `paused` or `archived`:
- `active` workloads count against the organisation's metered allowance (`1` on Free, `3` on Deploy, unmetered under an operator agreement).
- `paused` workloads stop counting toward the active allowance while retaining all standing decisions, lane rules and measurements. Resuming (`paused` to `active`) checks the active allowance inside the write transaction and answers `402 plan_allowance_exceeded` if all slots are full.
- `archived` workloads permanently retire a lane while keeping its audit trail intact (`409 workload_archived` if asked to re-activate).
## Response shape
```json
{
"data": [
{
"id": "convexity/support-triage",
"orgId": "convexity",
"slug": "support-triage",
"name": "Support triage",
"classId": "model",
"incumbentSkuId": "openai/gpt-5.6-luna",
"incumbentIsPrivate": false,
"unitLabel": "ticket",
"unitProfile": { "inputTokensPerUnit": 1800, "outputTokensPerUnit": 400 },
"monthlyVolume": null,
"constraints": {},
"delivery": {},
"priority": "economics",
"notes": null,
"status": "active",
"pausedAt": null,
"archivedAt": null,
"activeRuleCount": 0,
"activeFallbackCount": 0,
"decisionCount": 1
}
],
"meta": {
"generatedAt": "2026-09-14T12:00:00.000Z",
"orgId": "convexity",
"count": 1,
"activeCount": 1,
"workloadAllowance": 3
}
}
```