Accept the current terms and set the org's data-use choice
POST /v1/terms
Owners only. Records who accepted which version, from where, and sets org.data_use. The default before any acceptance is scoring_only.
Credential. A dashboard session token belonging to an owner of the organisation.
curl --fail-with-body -X POST "https://api-833252724876.us-central1.run.app/v1/terms" \
-H "Authorization: Bearer $JEAN_SESSION_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"terms_version": "2026-09-01"
}'
Body
| Field | Type | Required | Notes |
|---|---|---|---|
terms_version | string | yes | Must equal current_version from GET /v1/terms. |
data_use | "scoring_only", "aggregate_ok", "training_ok" | no | Default "scoring_only". |
Response · 200
{
"org_id": "org_k3j2h4g5f6d7s8a9q0w1",
"current_version": "2026-09-01",
"data_use": "scoring_only",
"accepted_version": "2026-09-01",
"accepted_at": "2026-01-15T09:30:00Z",
"accepted_by": "usr_b2c3d4e5f6g7h8i9j0k1",
"up_to_date": true
}
Errors
| Status | Meaning |
|---|---|
401 | Unauthenticated, invalid token or revoked key. |
403 | Forbidden, session required or org required. |
409 | Already exists, or stale version. |
422 | Validation failed. |
429 | Quota or rate limit exceeded; error.details says which, and when. |
500 | Internal error; quote error.request_id when reporting it. |
Every one carries the same envelope.