POST/containers/{containerId}/recite
Re-cite a held container's current ancestor path
Operation containers.recite
Description
Advances a container's access manifest so it cites its ancestors' current heads, without changing grants, keys, or parent. Clients call it after changing an ancestor so descendants they already hold stop citing superseded heads. Requires admin access; after 512 epochs the container no longer accepts re-citations.
Authentication
Requires a signed-in session: the client sends its session token as a bearer token in the Authorization header.
Parameters
| Name | In | Type | Details |
|---|---|---|---|
containerId | path | string | required |
Request body
application/jsonContainerReciteRequest
A signed container.recite that advances a container's manifest to cite its ancestors' current heads, changing nothing else.
7 fields
bodyany JSON valuerequiredeventobject with any fieldsrequiredexpectedManifestHashstringrequired- not empty
Hash of the manifest this re-citation derives.
manifestobject with any fieldsrequired- 1 to 100 items
The container's current path, from its root.
The container's current manifest head.
Heads of the principal policies the re-citation was planned against.
Other fields are allowed.
Responses
200 OK
application/jsonContainerReciteResponse
Acknowledges a re-citation by its event hash and new manifest head; keys are unchanged.
8 fields
containerIdstringrequiredcreatedAtstringrequiredeventHashstringrequired- not empty
manifestHeadobjectrequired2 fields
epochnumberrequiredmanifestHashstringrequired
Other fields are allowed.
organizationIdstringrequiredparentIdstringrequirednullablesystemSlotstringoptionalnullable- pattern
^sys_v1_[A-Za-z0-9_-]{43}$
- pattern
updatedAtstringrequired
Other fields are allowed.
Other responses
| Status | Meaning | Body |
|---|---|---|
| 400 | Bad Request |
|
| 401 | Unauthorized |
|
| 402 | Payment Required |
|
| 403 | Forbidden |
|
| 404 | Not Found |
|
| 409 | Conflict |
|
| 500 | Internal Server Error |
|
| 503 | Service Unavailable |
|