Skip to main content
POST
Deploy the draft

Authorizations

Authorization
string
header
required

Management API authentication. Pass an op-mak-… management token as a Bearer token. Runtime op-… API keys are rejected with 403 — they belong on the data-plane endpoints. Mint a management key from the platform UI under Settings → API keys.

Path Parameters

name
string
required

Route name

Body

application/json
expected_active_version_number
integer

Optional active version precondition; zero means currently unpublished. A changed live pointer returns 409.

Required range: x >= 0
expected_draft_revision
integer

Optional positive revision of the draft reviewed by the caller; a changed draft returns 409.

Required range: x >= 1
expected_route_uuid
string<uuid>

Optional route identity precondition; a recycled route name does not satisfy it.

idempotency_key
string

Unique operation identifier. Reusing the same request returns its original deployed version without reactivating it. Use a fresh identifier for every new deployment.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9._:-]+$
note
string

Release note recorded on the new version.

Response

Successful response

data
object
meta
object
Last modified on September 17, 2026