Get context
GET
/api/projects/{projectId}/contextSigned-in memberRead-only
The AI knows nothing about a product beyond the change in front of it. A Project's context tells it what it cannot guess: what is a client and what is a server, where settings live, how people reach features, and what stays in English by design. Follow Project context on a Project's card, or call GET /api/projects/{projectId}/context, which returns the context and who last changed it. Every member can read it; only administrators write it, on the page or with PUT /api/projects/{projectId}/context and {"context": "..."}. It is plain text of at most 2000 characters; longer returns 400 validation_failed, and an empty one clears it.
Path parameters
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | string (uuid) | Required |
Response
Success: 200
| Field | Type | Required | Notes |
|---|---|---|---|
projectId | string (uuid) | Optional | |
context | string | Optional | |
updatedBy | string | Optional | |
updatedAt | string (date-time) | Optional |
Errors
| Status | Code | Applies to |
|---|---|---|
400 | validation_faileda field is missing or out of range | Any endpoint |
400 | invalid_parametera path or query parameter is missing or does not convert, such as an ID that is not a UUID | Any endpoint |
401 | authentication_requiredno session | Any endpoint |
404 | not_foundno such address | Any endpoint |
405 | method_not_allowedthe address does not take that method | Any endpoint |
415 | unsupported_media_typethe address does not read a body of that type | Any endpoint |
500 | internal_errora fault ReleaseFlow did not foresee; the body never carries the exception behind it | Any endpoint |
400 | invalid_change_filter | Changes area |
400 | invalid_change_review | Changes area |
400 | invalid_sensitive_paths | Changes area |
404 | change_not_found | Changes area |
404 | duplicate_candidate_not_found | Changes area |
409 | change_processing | Changes area |
409 | change_not_eligible_for_ai | Changes area |
409 | duplicate_candidate_decided | Changes area |
409 | change_excluded | Changes area |
409 | change_in_release | Changes area |
502 | ai_classification_failed | Changes area |
503 | ai_classification_unavailable | Changes area |
404 | category_not_found | Categories area |
404 | category_suggestion_not_found | Categories area |
409 | category_code_taken | Categories area |
409 | category_system | Categories area |
409 | category_suggestion_decided | Categories area |
Request
bash
# Sign in first and keep the session cookie in cookies.txt (see Sessions and CSRF).
curl "http://localhost:8080/api/projects/$PROJECT_ID/context" \
-b cookies.txt -c cookies.txt
Response
200Example
{
"projectId": "<uuid>",
"context": "<string>",
"updatedBy": "<string>",
"updatedAt": "<date-time>"
}