Operations
Poll an authorized command receipt
The server loads the persisted operation’s grant, actor, profile and name,
then rechecks current access and the original action scopes. Article
generation/publication results additionally require articles:read;
calendar results additionally require calendar:read; settings results
additionally require settings:read. A revoked grant
or lost collaborator membership cannot read a previously accepted receipt.
GET
/
operations
/
{id}
Error
A valid request URL is required to generate request examples{
"data": {
"id": "11111111-1111-4111-8111-111111111111",
"profile_id": "22222222-2222-4222-8222-222222222222",
"operation": "generateArticles",
"status": "succeeded",
"resource_ids": [
"44444444-4444-4444-8444-444444444444",
"33333333-3333-4333-8333-333333333333"
],
"result": {
"batch_id": "44444444-4444-4444-8444-444444444444",
"accepted_ids": [
"33333333-3333-4333-8333-333333333333"
],
"skipped": [],
"requested_count": 1
},
"result_url": null,
"retry_instruction": null,
"created_at": "2026-09-24T09:00:00+00:00",
"updated_at": "2026-09-24T09:00:00+00:00"
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pagination": {
"limit": 50,
"has_more": true,
"next_cursor": "<string>"
},
"catalog": {
"available_count": 1,
"enriched_count": 1,
"truncated": true
}
}
}{
"error": {
"code": "insufficient_quota",
"message": "The current article generation quota is exhausted.",
"request_id": "33333333-3333-4333-8333-333333333333",
"retryable": false
}
}{
"error": {
"code": "insufficient_quota",
"message": "The current article generation quota is exhausted.",
"request_id": "33333333-3333-4333-8333-333333333333",
"retryable": false
}
}Authorizations
OAuth2PersonalAPIKey
Authorization-code grant with PKCE S256, exact scopes, explicit resource audience and a persisted consent grant. Obtain endpoint URLs from server discovery in the target environment. Refresh tokens remain client-bound.
FlowAuthorization Code
- Authorization URL
- /oauth/authorize
- Token URL
- /oauth/token
- Refresh URL
- /oauth/token
Path Parameters
Resource UUID, scoped by the path profile or persisted operation receipt.
Response
Reauthorized operation status and public result reference.
Show child attributes
Show child attributes
Example:
{
"id": "11111111-1111-4111-8111-111111111111",
"profile_id": "22222222-2222-4222-8222-222222222222",
"operation": "generateArticles",
"status": "succeeded",
"resource_ids": [
"44444444-4444-4444-8444-444444444444",
"33333333-3333-4333-8333-333333333333"
],
"result": {
"batch_id": "44444444-4444-4444-8444-444444444444",
"accepted_ids": ["33333333-3333-4333-8333-333333333333"],
"skipped": [],
"requested_count": 1
},
"result_url": null,
"retry_instruction": null,
"created_at": "2026-09-24T09:00:00+00:00",
"updated_at": "2026-09-24T09:00:00+00:00"
}
Show child attributes
Show child attributes
⌘I
Error
A valid request URL is required to generate request examples{
"data": {
"id": "11111111-1111-4111-8111-111111111111",
"profile_id": "22222222-2222-4222-8222-222222222222",
"operation": "generateArticles",
"status": "succeeded",
"resource_ids": [
"44444444-4444-4444-8444-444444444444",
"33333333-3333-4333-8333-333333333333"
],
"result": {
"batch_id": "44444444-4444-4444-8444-444444444444",
"accepted_ids": [
"33333333-3333-4333-8333-333333333333"
],
"skipped": [],
"requested_count": 1
},
"result_url": null,
"retry_instruction": null,
"created_at": "2026-09-24T09:00:00+00:00",
"updated_at": "2026-09-24T09:00:00+00:00"
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pagination": {
"limit": 50,
"has_more": true,
"next_cursor": "<string>"
},
"catalog": {
"available_count": 1,
"enriched_count": 1,
"truncated": true
}
}
}{
"error": {
"code": "insufficient_quota",
"message": "The current article generation quota is exhausted.",
"request_id": "33333333-3333-4333-8333-333333333333",
"retryable": false
}
}{
"error": {
"code": "insufficient_quota",
"message": "The current article generation quota is exhausted.",
"request_id": "33333333-3333-4333-8333-333333333333",
"retryable": false
}
}