Skip to content
MCP Gateway

Publish a draft policy version and make it active for the environment.

POST
/v1/policies/{policy_version}/publish

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
policy_version
required
string
>= 1 characters

Query Parameters

Section titled “Query Parameters ”
tenant_id
string
>= 1 characters
environment_id
string
>= 1 characters

Request Body required

Section titled “Request Body required ”
object
manifest_hash
required
string
/^sha256:[a-f0-9]{64}$/
reason_code
required
string
/^[a-z0-9_]+$/
reason
string
<= 500 characters
actor_id

Rejected if supplied; actor is derived from authentication context.

string

Responses

Section titled “ Responses ”

202

Section titled “202 ”

Policy published.

object
schema_version
required
policy_version
required
string
>= 1 characters
status
required
string
Allowed values: draft validating published archived rejected
manifest_hash
required
string
/^sha256:[a-f0-9]{64}$/
etag
required
string
>= 1 characters
audit_event_id
required
string | null
validation
required
object
valid
required
boolean
status
required
Allowed values: not_validated valid invalid
checked_at
required
string | null format: date-time
checked_by
required
string | null
rule_count
required
integer
errors
required
Array<object>
object
reason_code
required
string
/^[a-z0-9_]+$/
message
required
string
>= 1 characters
line
required
integer | null
>= 1
column
required
integer | null
>= 1
path
required
string
>= 1 characters

403

Section titled “403 ”

Missing policy.publish.

409

Section titled “409 ”

Hash mismatch or invalid state.

422

Section titled “422 ”

Validation failed before publish.

object
schema_version
required
policy_version
required
string
>= 1 characters
status
required
string
Allowed values: draft validating published archived rejected
manifest_hash
required
string
/^sha256:[a-f0-9]{64}$/
etag
required
string
>= 1 characters
audit_event_id
required
string | null
validation
required
object
valid
required
boolean
status
required
Allowed values: not_validated valid invalid
checked_at
required
string | null format: date-time
checked_by
required
string | null
rule_count
required
integer
errors
required
Array<object>
object
reason_code
required
string
/^[a-z0-9_]+$/
message
required
string
>= 1 characters
line
required
integer | null
>= 1
column
required
integer | null
>= 1
path
required
string
>= 1 characters

Type set in Geist, Source Serif 4, and Departure Mono.