REST API reference

Browse the existing authoring endpoints and download the OpenAPI specification.

PeopleTide Content · HTTP integration guides

Authoring base URL.

Use https://content.peopletide.com/api/v1 from a trusted integration with a site-specific agent bearer key. Human-only actions use the existing signed-in workspace session. OpenAPI is available publicly at /api/v1/openapi.json.

Shell

# Run from a trusted terminal. Set SITE_ID and CMS_AGENT_TOKEN first.
curl --fail-with-body \
  -H "Authorization: Bearer $CMS_AGENT_TOKEN" \
  "https://content.peopletide.com/api/v1/sites/$SITE_ID/content?limit=25"

Existing authoring endpoints.

The endpoint index below comes from the application’s OpenAPI operation list. Request payloads follow the document, revision-write, and proposal contracts described in these guides. Site setup, grants, and token administration require human administrator access.

GET/api/v1/sites

POST/api/v1/sites

GET/api/v1/sites/{site}/schemas

PUT/api/v1/sites/{site}/schemas/{type}

GET/api/v1/sites/{site}/content

GET/api/v1/sites/{site}/content/{id}

PUT/api/v1/sites/{site}/content/{id}

GET/api/v1/sites/{site}/content/{id}/history

GET/api/v1/sites/{site}/content/{id}/references

POST/api/v1/sites/{site}/snapshots

GET/api/v1/sites/{site}/snapshots/{id}

POST/api/v1/sites/{site}/snapshots/{id}/review

GET/api/v1/sites/{site}/changesets

POST/api/v1/sites/{site}/changesets

GET/api/v1/sites/{site}/changesets/{id}

POST/api/v1/sites/{site}/changesets/{id}/validate

POST/api/v1/sites/{site}/changesets/{id}/approve

POST/api/v1/sites/{site}/changesets/{id}/reject

GET/api/v1/sites/{site}/releases

POST/api/v1/sites/{site}/releases/{id}/rollback

GET/api/v1/sites/{site}/tokens

POST/api/v1/sites/{site}/tokens

DELETE/api/v1/sites/{site}/tokens/{id}

GET/api/v1/sites/{site}/grants

PUT/api/v1/sites/{site}/grants/{id}

GET/api/v1/sites/{site}/media

POST/api/v1/sites/{site}/media

POST/api/v1/sites/{site}/media/{id}/finalize

GET/api/v1/sites/{site}/changes

GET/api/v1/sites/{site}/review-tasks

Download the OpenAPI specification ↗

Public delivery endpoints.

GET /delivery/v1/{org}/{site}/current.json discovers the release; GET the returned manifest and object URLs. GET and HEAD serve published artifacts, and OPTIONS supports browser delivery. These endpoints use neither the authoring bearer key nor workspace cookies.

Errors are JSON.

Error responses contain error and optional details. Read details for validation or conflict context. Common statuses are 400 invalid input, 401 authentication required, 403 access or human approval required, 404 missing resource, and 409 revision or release conflict. Bound retries for transient failures; do not automatically resubmit approval actions.