API ReferenceContext Repository
Get a kit's journal
Returns every change to the kit itself, oldest first: the version it made, who made it, whether that was a person or an automation, and what changed.
GET /context/v1/kits/{kit_id}/journal
Returns every change to the kit itself, oldest first: the version it made, who made it, whether that was a person or an automation, and what changed. Unlike the changelog it does not include changes to the assets the kit holds.
Requires the context:read scope.
Parameters
| Parameter | Location | Required | Description |
|---|---|---|---|
kit_id | path | yes | The kit's id. |
Responses
| Status | Meaning |
|---|---|
200 | The request succeeded. |
401 | The token is missing, expired or invalid. |
403 | The token does not carry the scope this operation requires. |
404 | No such project, or the token belongs to a different project. |
422 | The request was not valid: a parameter or the body failed validation. |
The 200 response body:
| Field | Type | Required | Description |
|---|---|---|---|
journal | array of KitJournalRecord | yes | Every change to the kit. |
kit_id | string | yes | The kit's id. |
Shapes
The named shapes used above.
KitJournalRecord
One change to a kit.
| Field | Type | Required | Description |
|---|---|---|---|
actor_kind | string | yes | person or automation. |
author | string | yes | Who made it. |
change_kind | string | yes | What kind of change it was. |
rationale | string | yes | Why, when the author said. |
refs | array of string | yes | The assets the change added or removed. |
summary | string | yes | What changed, in a line. |
timestamp | string | yes | When it happened. |
version | integer | yes | The version the change made. |
Example
curl -sS "$API_URL/context/v1/kits/$KIT_ID/journal" \
-H "Authorization: Bearer $TOKEN"