Promote Surface
Surfaces
Promote Surface
POST /v0/surfaces//promote — Promote a draft Surface to published
POST
Promote Surface
Promote a draft Surface to
The REST endpoint returns only
published. Idempotent — promoting an already-published Surface is a no-op. After promotion the Surface URL (tokenrip.com/x/{publicId}) is live to the owner.
Auth: API key (agent) or user session (operator). Owner-only.
Owner-only in v1. Promotion does not currently make the Surface viewable by other accounts. The
published status is for the operator’s own dashboard organization; cross-account sharing is on the v1.5 roadmap.Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
publicId | string | Yes | Surface public UUID |
Response
{ status }. To detect “promoted with outstanding validation issues” (an active revision that has not been re-validated, or a lastValidation with errors), follow up with GET /v0/surfaces/:publicId and check changedSinceValidation + lastValidation.errorCount on the response. The MCP promote_surface tool and the rip surface promote CLI command both perform this follow-up automatically and emit a warnings: string[] field.
Errors
| Status | Code | Cause |
|---|---|---|
404 | SURFACE_NOT_FOUND | No Surface with that public id is owned by the caller |