Request a review · Cueston Docs

POST/surveys/{id}/publish-requestsNeedscontent.edit

Asks a publisher to review and publish the current draft to production (snapshotted as a version now, so later edits don't change what's reviewed). Publishers are emailed.

Authorization

secretKey

headerAuthorizationBearer <sk_…>

A secret API key from Settings → API keys. It acts with its creator's role.

Path Parameters

id*integer

The survey's id.

Range1 <= value

Request Body

application/json

body

note?|

What changed and why, for the reviewer.

versionId?|

Ask to publish this existing version (a rollback) instead of the working draft.

Response Body

Created

application/json

response

request*

A request to publish a version to production, waiting for (or after) review.

Shell

curl -X POST 'https://app.cueston.com/api/surveys/1/publish-requests' \
  -H 'Content-Type: application/json' \
  -d '{}'curl -X POST 'https://app.cueston.com/api/surveys/1/publish-requests' \
  -H 'Content-Type: application/json' \
  -d '{}'

Example ResponseSchema

JSON

{
  "request": {
    "id": 42,
    "contentType": "tour",
    "contentId": 42,
    "contentName": "Onboarding tour",
    "versionId": 7,
    "version": 3,
    "environment": "production",
    "status": "pending",
    "note": "Clearer copy on step 2",
    "requestedBy": {
      "id": 42,
      "name": "Ada Lovelace",
      "email": "ada@acme.com"
    },
    "reviewer": {
      "id": 42,
      "name": "Ada Lovelace",
      "email": "ada@acme.com"
    },
    "reviewNote": "Looks good",
    "createdAt": "2026-10-26T09:30:00Z",
    "reviewedAt": "2026-10-26T09:30:00Z"
  }
}{
  "request": {
    "id": 42,
    "contentType": "tour",
    "contentId": 42,
    "contentName": "Onboarding tour",
    "versionId": 7,
    "version": 3,
    "environment": "production",
    "status": "pending",
    "note": "Clearer copy on step 2",
    "requestedBy": {
      "id": 42,
      "name": "Ada Lovelace",
      "email": "ada@acme.com"
    },
    "reviewer": {
      "id": 42,
      "name": "Ada Lovelace",
      "email": "ada@acme.com"
    },
    "reviewNote": "Looks good",
    "createdAt": "2026-10-26T09:30:00Z",
    "reviewedAt": "2026-10-26T09:30:00Z"
  }
}