Reviews
Reviews in the management API. 8 endpoints.
Read the guideOpenAPI 3.1 document
Try it settings
https://api.bifrostorbit.com/cms/manage/v1
The management API takes a management token, which is secret and acts as a person, so nothing here is sent from the docs.
Try it sends each request straight from your browser to the API. The key stays in this page's memory: it is never saved, never sent to docs.bifrostorbit.com and gone when you leave or reload the page. Only reads are run; anything that changes data is described and never sent.
Its latest review, or null
GET/organisations/{organisationId}/spaces/{spaceId}/environments/{environmentId}/regions/{regionId}/locales/{localeId}/content/{contentId}/reviewKey required
Its latest review, or null. Permission: content:read.
Parameters
organisationIdstringpath, requiredThe organisation's id, from the Management tokens page.
spaceIdstringpath, requiredThe space's id.
environmentIdstringpath, requiredThe environment's id.
regionIdstringpath, requiredThe region's id.
localeIdstringpath, requiredThe language's id.
contentIdstringpath, requiredThe content item's id.
Responses
200OKThe review.dataReview or any or nullFields of data
One of:
Review
idstringAn id.
contentIdstringAn id.
contentNamestringcontentUrlstring or nullcontentTypestringregionstring or nulllocalestring or nullenvironmentIdstringAn id.
regionIdstringAn id.
localeIdstringAn id.
versionintegerThe draft version sent.
One of pending, approved, rejected, withdrawn, superseded.statusstringstepsobject[]Fields of steps
keystringnamestring
One of pending, approved, rejected.statusstringdecidedBystring or nulldecidedRolestring or nulldecidedAtstring or nullcommentstring or nullwhostring or null
messagestring or nullreviewersstring[]publishOnApprovalbooleansubmittedBystringsentByAgentstring or nulldraftedByAistring or nullsubmittedAtstringdecidedAtstring or nullpublishedAtstring or nullstalebooleanThe page changed after it was sent.
any or null
401UnauthorisedNo token, or a token that is unknown, expired or revoked, or whose person no longer has access.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
403ForbiddenLacks content:read.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
404Not foundNo such content item, or it's in another organisation.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
500Server errorSomething went wrong on our side. Try again in a moment.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
curl 'https://api.bifrostorbit.com/cms/manage/v1/organisations/6650f1c2a9e4b1d2c3f40a01/spaces/6650f1c2a9e4b1d2c3f40a02/environments/6650f1c2a9e4b1d2c3f40a13/regions/6650f1c2a9e4b1d2c3f40a17/locales/6650f1c2a9e4b1d2c3f40a18/content/6650f1c2a9e4b1d2c3f40a21/review' \ -H 'Authorization: Bearer cms_mt_…'Try it
Management tokens are secret and act as a person, so nothing is sent from the docs.
Example answer
{ "data": { "id": "6650f1c2a9e4b1d2c3f40a46", "contentId": "6650f1c2a9e4b1d2c3f40a21", "contentName": "Lofoten sea kayaking", "contentUrl": "/trips/lofoten-sea-kayaking", "contentType": "trip", "region": "Norway", "locale": "Norsk", "environmentId": "6650f1c2a9e4b1d2c3f40a13", "regionId": "6650f1c2a9e4b1d2c3f40a17", "localeId": "6650f1c2a9e4b1d2c3f40a18", "version": 12, "status": "pending", "steps": [ { "key": "lofoten", "name": "Lofoten sea kayaking", "status": "pending", "decidedBy": "6650f1c2a9e4b1d2c3f40a30", "decidedRole": null, "decidedAt": "2026-11-02T09:30:00.000Z", "comment": null, "who": null } ], "message": null, "reviewers": [ "…" ], "publishOnApproval": true, "submittedBy": "Ingrid Berg", "sentByAgent": null, "draftedByAi": null, "submittedAt": "2026-11-02T09:30:00.000Z", "decidedAt": "2026-11-02T09:30:00.000Z", "publishedAt": "2026-11-02T09:30:00.000Z", "stale": false }}Sends the draft for review
POST/organisations/{organisationId}/spaces/{spaceId}/environments/{environmentId}/regions/{regionId}/locales/{localeId}/content/{contentId}/reviewKey required
Sends the draft for review. Permission: content:update.
Parameters
organisationIdstringpath, requiredThe organisation's id, from the Management tokens page.
spaceIdstringpath, requiredThe space's id.
environmentIdstringpath, requiredThe environment's id.
regionIdstringpath, requiredThe region's id.
localeIdstringpath, requiredThe language's id.
contentIdstringpath, requiredThe content item's id.
Idempotency-KeystringheaderOptional. A unique value, such as a UUID, that makes a retry safe: the same key with the same request within 24 hours returns the first answer again, with Idempotent-Replayed: true, instead of making the change twice. The same key with a different request gets 422; while the first request is still running, 409. Only successful answers are kept.
Up to 255 characters.
Request body, optional
messagestring or nulloptionalWhat to look at, up to 2,000 characters.
Default null. Up to 2000 characters.reviewerIdsstring[]optionalUp to 20 people to ask, from GET {space}/reviewers.
Default []. Up to 20 items.publishOnApprovalbooleanoptionalPublish as soon as it's approved.
Default true.
Responses
201CreatedThe review.dataReviewFields of data
idstringAn id.
contentIdstringAn id.
contentNamestringcontentUrlstring or nullcontentTypestringregionstring or nulllocalestring or nullenvironmentIdstringAn id.
regionIdstringAn id.
localeIdstringAn id.
versionintegerThe draft version sent.
One of pending, approved, rejected, withdrawn, superseded.statusstringstepsobject[]Fields of steps
keystringnamestring
One of pending, approved, rejected.statusstringdecidedBystring or nulldecidedRolestring or nulldecidedAtstring or nullcommentstring or nullwhostring or null
messagestring or nullreviewersstring[]publishOnApprovalbooleansubmittedBystringsentByAgentstring or nulldraftedByAistring or nullsubmittedAtstringdecidedAtstring or nullpublishedAtstring or nullstalebooleanThe page changed after it was sent.
400Bad requestThe body isn't valid JSON.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
401UnauthorisedNo token, or a token that is unknown, expired or revoked, or whose person no longer has access.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
403ForbiddenLacks content:update, or the token is read only.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
404Not foundNo such content item, or it's in another organisation.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
409ConflictNothing new to review.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
422UnprocessableThe body doesn't match the schema. Each problem is in error.details.issues.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
500Server errorSomething went wrong on our side. Try again in a moment.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
curl -X POST 'https://api.bifrostorbit.com/cms/manage/v1/organisations/6650f1c2a9e4b1d2c3f40a01/spaces/6650f1c2a9e4b1d2c3f40a02/environments/6650f1c2a9e4b1d2c3f40a13/regions/6650f1c2a9e4b1d2c3f40a17/locales/6650f1c2a9e4b1d2c3f40a18/content/6650f1c2a9e4b1d2c3f40a21/review' \ -H 'Authorization: Bearer cms_mt_…' \ -H 'Content-Type: application/json' \ -d '{"message":"New 2027 departures and prices.","reviewerIds":["6650f1c2a9e4b1d2c3f40a30"]}'Try it
Management tokens are secret and act as a person, so nothing is sent from the docs.
Example answer
{ "data": { "id": "6650f1c2a9e4b1d2c3f40a46", "contentId": "6650f1c2a9e4b1d2c3f40a21", "contentName": "Lofoten sea kayaking", "contentUrl": "/trips/lofoten-sea-kayaking", "contentType": "trip", "region": "Norway", "locale": "Norsk", "environmentId": "6650f1c2a9e4b1d2c3f40a13", "regionId": "6650f1c2a9e4b1d2c3f40a17", "localeId": "6650f1c2a9e4b1d2c3f40a18", "version": 12, "status": "pending", "steps": [ { "key": "lofoten", "name": "Lofoten sea kayaking", "status": "pending", "decidedBy": "6650f1c2a9e4b1d2c3f40a30", "decidedRole": null, "decidedAt": "2026-11-02T09:30:00.000Z", "comment": null, "who": null } ], "message": null, "reviewers": [ "…" ], "publishOnApproval": true, "submittedBy": "Ingrid Berg", "sentByAgent": null, "draftedByAi": null, "submittedAt": "2026-11-02T09:30:00.000Z", "decidedAt": "2026-11-02T09:30:00.000Z", "publishedAt": "2026-11-02T09:30:00.000Z", "stale": false }}Who can be asked to review
GET/organisations/{organisationId}/spaces/{spaceId}/reviewersKey required
Who can be asked to review. Permission: content:update.
Parameters
organisationIdstringpath, requiredThe organisation's id, from the Management tokens page.
spaceIdstringpath, requiredThe space's id.
Responses
200OK[{ userId, name, email, roleName, role, canApprove, invited }].dataobject[]Fields of data
userIdstringAn id.
namestringemailstringroleNamestringrolestringcanApprovebooleaninvitedbooleanHasn't accepted the invitation yet.
401UnauthorisedNo token, or a token that is unknown, expired or revoked, or whose person no longer has access.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
403ForbiddenLacks content:update.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
404Not foundNo such space, or it's in another organisation.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
500Server errorSomething went wrong on our side. Try again in a moment.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
curl 'https://api.bifrostorbit.com/cms/manage/v1/organisations/6650f1c2a9e4b1d2c3f40a01/spaces/6650f1c2a9e4b1d2c3f40a02/reviewers' \ -H 'Authorization: Bearer cms_mt_…'Try it
Management tokens are secret and act as a person, so nothing is sent from the docs.
Example answer
{ "data": [ { "userId": "6650f1c2a9e4b1d2c3f40a30", "name": "Lofoten sea kayaking", "email": "ingrid.berg@northwilds.com", "roleName": "…", "role": "…", "canApprove": false, "invited": false } ]}Reviews
GET/organisations/{organisationId}/spaces/{spaceId}/reviewsKey required
Reviews. status is open (default) or decided; mine=true. Up to 100. Permission: content:read.
Parameters
organisationIdstringpath, requiredThe organisation's id, from the Management tokens page.
spaceIdstringpath, requiredThe space's id.
statusstringqueryopen (the default) or decided.
One of open, decided.minestringquerytrue for reviews you sent or were asked to do.
One of true, false.
Responses
200OKList of reviews.dataReview[]Up to 100.
Fields of data
idstringAn id.
contentIdstringAn id.
contentNamestringcontentUrlstring or nullcontentTypestringregionstring or nulllocalestring or nullenvironmentIdstringAn id.
regionIdstringAn id.
localeIdstringAn id.
versionintegerThe draft version sent.
One of pending, approved, rejected, withdrawn, superseded.statusstringstepsobject[]Fields of steps
keystringnamestring
One of pending, approved, rejected.statusstringdecidedBystring or nulldecidedRolestring or nulldecidedAtstring or nullcommentstring or nullwhostring or null
messagestring or nullreviewersstring[]publishOnApprovalbooleansubmittedBystringsentByAgentstring or nulldraftedByAistring or nullsubmittedAtstringdecidedAtstring or nullpublishedAtstring or nullstalebooleanThe page changed after it was sent.
401UnauthorisedNo token, or a token that is unknown, expired or revoked, or whose person no longer has access.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
403ForbiddenLacks content:read.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
404Not foundNo such space, or it's in another organisation.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
500Server errorSomething went wrong on our side. Try again in a moment.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
curl 'https://api.bifrostorbit.com/cms/manage/v1/organisations/6650f1c2a9e4b1d2c3f40a01/spaces/6650f1c2a9e4b1d2c3f40a02/reviews' \ -H 'Authorization: Bearer cms_mt_…'Try it
Management tokens are secret and act as a person, so nothing is sent from the docs.
Example answer
{ "data": [ { "id": "6650f1c2a9e4b1d2c3f40a46", "contentId": "6650f1c2a9e4b1d2c3f40a21", "contentName": "Lofoten sea kayaking", "contentUrl": "/trips/lofoten-sea-kayaking", "contentType": "trip", "region": "Norway", "locale": "Norsk", "environmentId": "6650f1c2a9e4b1d2c3f40a13", "regionId": "6650f1c2a9e4b1d2c3f40a17", "localeId": "6650f1c2a9e4b1d2c3f40a18", "version": 12, "status": "pending", "steps": [ { "key": "lofoten", "name": "Lofoten sea kayaking", "status": "pending", "decidedBy": "6650f1c2a9e4b1d2c3f40a30", "decidedRole": null, "decidedAt": "2026-11-02T09:30:00.000Z", "comment": null, "who": null } ], "message": null, "reviewers": [ "…" ], "publishOnApproval": true, "submittedBy": "Ingrid Berg", "sentByAgent": null, "draftedByAi": null, "submittedAt": "2026-11-02T09:30:00.000Z", "decidedAt": "2026-11-02T09:30:00.000Z", "publishedAt": "2026-11-02T09:30:00.000Z", "stale": false } ]}One review, with its changes and comments
GET/organisations/{organisationId}/spaces/{spaceId}/reviews/{reviewId}Key required
One review, with its changes and comments. Permission: content:read.
Parameters
organisationIdstringpath, requiredThe organisation's id, from the Management tokens page.
spaceIdstringpath, requiredThe space's id.
reviewIdstringpath, requiredThe review's id.
Responses
200OKThe review.dataobjectFields of data
idstringAn id.
contentIdstringAn id.
contentNamestringcontentUrlstring or nullcontentTypestringregionstring or nulllocalestring or nullenvironmentIdstringAn id.
regionIdstringAn id.
localeIdstringAn id.
versionintegerThe draft version sent.
One of pending, approved, rejected, withdrawn, superseded.statusstringstepsobject[]Fields of steps
keystringnamestring
One of pending, approved, rejected.statusstringdecidedBystring or nulldecidedRolestring or nulldecidedAtstring or nullcommentstring or nullwhostring or null
messagestring or nullreviewersstring[]publishOnApprovalbooleansubmittedBystringsentByAgentstring or nulldraftedByAistring or nullsubmittedAtstringdecidedAtstring or nullpublishedAtstring or nullstalebooleanThe page changed after it was sent.
changesobject[]What the draft changes.
Fields of changes
One of field, seo, component.areastringkeystringtypestringsometimes
One of added, removed, changed.changestringfieldsstring[]sometimes
isNewbooleanThe page has never been published.
commentsobject[]Fields of comments
idstringAn id.
authorstringbodystringcomponentIdstring or nullcreatedAtstring
canDecidebooleandecideBlockedstring or nullWhy the token's person can't decide, such as their own changes.
decideBlockedWordingany or any or nullThe same as a translation key.
canWithdrawboolean
401UnauthorisedNo token, or a token that is unknown, expired or revoked, or whose person no longer has access.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
403ForbiddenThe review is in a region or language the token's person can't read.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
404Not foundNo such review, or it's in another organisation.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
500Server errorSomething went wrong on our side. Try again in a moment.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
curl 'https://api.bifrostorbit.com/cms/manage/v1/organisations/6650f1c2a9e4b1d2c3f40a01/spaces/6650f1c2a9e4b1d2c3f40a02/reviews/6650f1c2a9e4b1d2c3f40a30' \ -H 'Authorization: Bearer cms_mt_…'Try it
Management tokens are secret and act as a person, so nothing is sent from the docs.
Example answer
{ "data": { "id": "6650f1c2a9e4b1d2c3f40a40", "contentId": "6650f1c2a9e4b1d2c3f40a21", "contentName": "…", "contentUrl": null, "contentType": "…", "region": null, "locale": "nb-NO", "environmentId": "6650f1c2a9e4b1d2c3f40a13", "regionId": "6650f1c2a9e4b1d2c3f40a17", "localeId": "6650f1c2a9e4b1d2c3f40a18", "version": 12, "status": "pending", "steps": [ { "key": "lofoten", "name": "Lofoten sea kayaking", "status": "pending", "decidedBy": "6650f1c2a9e4b1d2c3f40a30", "decidedRole": null, "decidedAt": "2026-11-02T09:30:00.000Z", "comment": null, "who": null } ], "message": null, "reviewers": [ "…" ], "publishOnApproval": true, "submittedBy": "6650f1c2a9e4b1d2c3f40a30", "sentByAgent": null, "draftedByAi": null, "submittedAt": "2026-11-02T09:30:00.000Z", "decidedAt": "2026-11-02T09:30:00.000Z", "publishedAt": "2026-11-02T09:30:00.000Z", "stale": false, "changes": [ { "area": "field", "key": "lofoten", "type": "…", "change": "added", "fields": [ "…" ] } ], "isNew": false, "comments": [ { "id": "6650f1c2a9e4b1d2c3f40a40", "author": "Ingrid Berg", "body": "…", "componentId": null, "createdAt": "2026-11-02T09:30:00.000Z" } ], "canDecide": true, "decideBlocked": null, "decideBlockedWording": null, "canWithdraw": false }}Comments on a review
POST/organisations/{organisationId}/spaces/{spaceId}/reviews/{reviewId}/commentsKey required
Comments on a review. Permission: content:read.
Parameters
organisationIdstringpath, requiredThe organisation's id, from the Management tokens page.
spaceIdstringpath, requiredThe space's id.
reviewIdstringpath, requiredThe review's id.
Idempotency-KeystringheaderOptional. A unique value, such as a UUID, that makes a retry safe: the same key with the same request within 24 hours returns the first answer again, with Idempotent-Replayed: true, instead of making the change twice. The same key with a different request gets 422; while the first request is still running, 409. Only successful answers are kept.
Up to 255 characters.
Request body
Up to 4000 characters.bodystringrequiredcomponentIdstring or nulloptionalA block the comment is about.
Default null. Up to 100 characters.
Responses
201CreatedThe comment.dataobjectFields of data
idstringAn id.
bodystringcomponentIdstring or nullcreatedAtstring
400Bad requestThe body isn't valid JSON.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
401UnauthorisedNo token, or a token that is unknown, expired or revoked, or whose person no longer has access.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
403ForbiddenLacks content:read, or the token is read only.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
404Not foundNo such review, or it's in another organisation.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
422UnprocessableThe body doesn't match the schema. Each problem is in error.details.issues.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
500Server errorSomething went wrong on our side. Try again in a moment.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
curl -X POST 'https://api.bifrostorbit.com/cms/manage/v1/organisations/6650f1c2a9e4b1d2c3f40a01/spaces/6650f1c2a9e4b1d2c3f40a02/reviews/6650f1c2a9e4b1d2c3f40a30/comments' \ -H 'Authorization: Bearer cms_mt_…' \ -H 'Content-Type: application/json' \ -d '{"body":"Could the second paragraph name the fjords?"}'Try it
Management tokens are secret and act as a person, so nothing is sent from the docs.
Example answer
{ "data": { "id": "6650f1c2a9e4b1d2c3f40a40", "body": "…", "componentId": null, "createdAt": "2026-11-02T09:30:00.000Z" }}Approves or rejects
POST/organisations/{organisationId}/spaces/{spaceId}/reviews/{reviewId}/decisionKey required
Approves or rejects. Permission: content:approve.
Parameters
organisationIdstringpath, requiredThe organisation's id, from the Management tokens page.
spaceIdstringpath, requiredThe space's id.
reviewIdstringpath, requiredThe review's id.
Idempotency-KeystringheaderOptional. A unique value, such as a UUID, that makes a retry safe: the same key with the same request within 24 hours returns the first answer again, with Idempotent-Replayed: true, instead of making the change twice. The same key with a different request gets 422; while the first request is still running, 409. Only successful answers are kept.
Up to 255 characters.
Request body
One of approve, reject.decisionstringrequiredcommentstring or nulloptionalRequired to reject: what needs to change.
Default null. Up to 2000 characters.
Responses
200OKThe review.dataReviewFields of data
idstringAn id.
contentIdstringAn id.
contentNamestringcontentUrlstring or nullcontentTypestringregionstring or nulllocalestring or nullenvironmentIdstringAn id.
regionIdstringAn id.
localeIdstringAn id.
versionintegerThe draft version sent.
One of pending, approved, rejected, withdrawn, superseded.statusstringstepsobject[]Fields of steps
keystringnamestring
One of pending, approved, rejected.statusstringdecidedBystring or nulldecidedRolestring or nulldecidedAtstring or nullcommentstring or nullwhostring or null
messagestring or nullreviewersstring[]publishOnApprovalbooleansubmittedBystringsentByAgentstring or nulldraftedByAistring or nullsubmittedAtstringdecidedAtstring or nullpublishedAtstring or nullstalebooleanThe page changed after it was sent.
400Bad requestThe body isn't valid JSON.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
401UnauthorisedNo token, or a token that is unknown, expired or revoked, or whose person no longer has access.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
403ForbiddenLacks content:approve, or your own changes.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
404Not foundNo such review, or it's in another organisation.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
409ConflictIt isn't open, the page changed after it was sent, or someone else decided first.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
422UnprocessableThe body doesn't match the schema. Each problem is in error.details.issues.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
500Server errorSomething went wrong on our side. Try again in a moment.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
curl -X POST 'https://api.bifrostorbit.com/cms/manage/v1/organisations/6650f1c2a9e4b1d2c3f40a01/spaces/6650f1c2a9e4b1d2c3f40a02/reviews/6650f1c2a9e4b1d2c3f40a30/decision' \ -H 'Authorization: Bearer cms_mt_…' \ -H 'Content-Type: application/json' \ -d '{"decision":"approve","comment":"Looks good."}'Try it
Management tokens are secret and act as a person, so nothing is sent from the docs.
Example answer
{ "data": { "id": "6650f1c2a9e4b1d2c3f40a46", "contentId": "6650f1c2a9e4b1d2c3f40a21", "contentName": "Lofoten sea kayaking", "contentUrl": "/trips/lofoten-sea-kayaking", "contentType": "trip", "region": "Norway", "locale": "Norsk", "environmentId": "6650f1c2a9e4b1d2c3f40a13", "regionId": "6650f1c2a9e4b1d2c3f40a17", "localeId": "6650f1c2a9e4b1d2c3f40a18", "version": 12, "status": "pending", "steps": [ { "key": "lofoten", "name": "Lofoten sea kayaking", "status": "pending", "decidedBy": "6650f1c2a9e4b1d2c3f40a30", "decidedRole": null, "decidedAt": "2026-11-02T09:30:00.000Z", "comment": null, "who": null } ], "message": null, "reviewers": [ "…" ], "publishOnApproval": true, "submittedBy": "Ingrid Berg", "sentByAgent": null, "draftedByAi": null, "submittedAt": "2026-11-02T09:30:00.000Z", "decidedAt": "2026-11-02T09:30:00.000Z", "publishedAt": "2026-11-02T09:30:00.000Z", "stale": false }}Withdraws a review
POST/organisations/{organisationId}/spaces/{spaceId}/reviews/{reviewId}/withdrawKey required
Withdraws a review. Permission: Its sender, or content:approve.
Parameters
organisationIdstringpath, requiredThe organisation's id, from the Management tokens page.
spaceIdstringpath, requiredThe space's id.
reviewIdstringpath, requiredThe review's id.
Idempotency-KeystringheaderOptional. A unique value, such as a UUID, that makes a retry safe: the same key with the same request within 24 hours returns the first answer again, with Idempotent-Replayed: true, instead of making the change twice. The same key with a different request gets 422; while the first request is still running, 409. Only successful answers are kept.
Up to 255 characters.
Responses
200OKThe review.dataReviewFields of data
idstringAn id.
contentIdstringAn id.
contentNamestringcontentUrlstring or nullcontentTypestringregionstring or nulllocalestring or nullenvironmentIdstringAn id.
regionIdstringAn id.
localeIdstringAn id.
versionintegerThe draft version sent.
One of pending, approved, rejected, withdrawn, superseded.statusstringstepsobject[]Fields of steps
keystringnamestring
One of pending, approved, rejected.statusstringdecidedBystring or nulldecidedRolestring or nulldecidedAtstring or nullcommentstring or nullwhostring or null
messagestring or nullreviewersstring[]publishOnApprovalbooleansubmittedBystringsentByAgentstring or nulldraftedByAistring or nullsubmittedAtstringdecidedAtstring or nullpublishedAtstring or nullstalebooleanThe page changed after it was sent.
401UnauthorisedNo token, or a token that is unknown, expired or revoked, or whose person no longer has access.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
403ForbiddenLacks Its sender, or content:approve, or the token is read only.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
404Not foundNo such review, or it's in another organisation.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
409ConflictIt isn't open.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
500Server errorSomething went wrong on our side. Try again in a moment.errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
curl -X POST 'https://api.bifrostorbit.com/cms/manage/v1/organisations/6650f1c2a9e4b1d2c3f40a01/spaces/6650f1c2a9e4b1d2c3f40a02/reviews/6650f1c2a9e4b1d2c3f40a30/withdraw' \ -H 'Authorization: Bearer cms_mt_…'Try it
Management tokens are secret and act as a person, so nothing is sent from the docs.
Example answer
{ "data": { "id": "6650f1c2a9e4b1d2c3f40a46", "contentId": "6650f1c2a9e4b1d2c3f40a21", "contentName": "Lofoten sea kayaking", "contentUrl": "/trips/lofoten-sea-kayaking", "contentType": "trip", "region": "Norway", "locale": "Norsk", "environmentId": "6650f1c2a9e4b1d2c3f40a13", "regionId": "6650f1c2a9e4b1d2c3f40a17", "localeId": "6650f1c2a9e4b1d2c3f40a18", "version": 12, "status": "pending", "steps": [ { "key": "lofoten", "name": "Lofoten sea kayaking", "status": "pending", "decidedBy": "6650f1c2a9e4b1d2c3f40a30", "decidedRole": null, "decidedAt": "2026-11-02T09:30:00.000Z", "comment": null, "who": null } ], "message": null, "reviewers": [ "…" ], "publishOnApproval": true, "submittedBy": "Ingrid Berg", "sentByAgent": null, "draftedByAi": null, "submittedAt": "2026-11-02T09:30:00.000Z", "decidedAt": "2026-11-02T09:30:00.000Z", "publishedAt": "2026-11-02T09:30:00.000Z", "stale": false }}SchemasThe shapes the endpoints above answer with and take.
Error
Every error has this shape. Write code against code and the status, never the message.
errorobjectFields of error
One of bad_request, unauthorized, forbidden, not_found, created_in_orbit, conflict, validation_failed, internal_error, unavailable.codestringmessagestringFollows Accept-Language when CMS Orbit has the language.
detailsanysometimesWhen there is more to read. On 422, issues: each field that failed, with path, message and code. On a field value that breaks the content type's rules, a list of { path, message }. On a version conflict, currentVersion, expected and received.
Review
idstringAn id.
contentIdstringAn id.
contentNamestringcontentUrlstring or nullcontentTypestringregionstring or nulllocalestring or nullenvironmentIdstringAn id.
regionIdstringAn id.
localeIdstringAn id.
versionintegerThe draft version sent.
One of pending, approved, rejected, withdrawn, superseded.statusstringstepsobject[]Fields of steps
keystringnamestring
One of pending, approved, rejected.statusstringdecidedBystring or nulldecidedRolestring or nulldecidedAtstring or nullcommentstring or nullwhostring or null
messagestring or nullreviewersstring[]publishOnApprovalbooleansubmittedBystringsentByAgentstring or nulldraftedByAistring or nullsubmittedAtstringdecidedAtstring or nullpublishedAtstring or nullstalebooleanThe page changed after it was sent.