API ReferenceContext Repository
Retire a kit
Retires the kit.
DELETE /context/v1/kits/{kit_id}
Retires the kit. Every version stays readable and the retirement is one more entry in the kit's journal. A kit that has moved since base_version is a 409 kit_moved.
Requires the context:kits scope.
Parameters
| Parameter | Location | Required | Description |
|---|---|---|---|
kit_id | path | yes | The kit's id. |
base_version | query | yes | The kit version you read. |
Responses
| Status | Meaning |
|---|---|
204 | 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. |
Example
curl -sS -X DELETE "$API_URL/context/v1/kits/$KIT_ID?base_version=$BASE_VERSION" \
-H "Authorization: Bearer $TOKEN"