Submit an immutable registration_status=deprecated edit for an MCP server.

POST

/v1/mcp-servers/{server_id}/registration-status/deprecate

Authorizations

• oidc

Parameters

Path Parameters

server_id

required

string

Query Parameters

tenant_id

string

>= 1 characters

environment_id

string

>= 1 characters

Request Body ^required

object

reason_code

required

string

/^[a-z0-9_]+$/

reason

required

string

>= 1 characters

actor_id

Deprecated compatibility field. Server derives actor identity from /v1/identity/me context and rejects mismatches.

string

>= 1 characters

Responses

202

Deprecation submitted as immutable pending submission; live snapshot is unchanged until approval.

object

summary

required

object

submission_id

required

string

>= 1 characters

sequence

required

integer

>= 1

status

required

string

Allowed values: submitted under_review approved rejected superseded

manifest_hash

required

string

/^sha256:[0-9a-f]{64}$/

submitted_by

required

string

>= 1 characters

submitted_at

required

string format: date-time

reviewed_by

string

reviewed_at

string format: date-time

review_reason_code

string

/^[a-z0-9_]+$/

review_reason

string

>= 1 characters

version

required

string

>= 1 characters

max_tool_risk_tier

required

Allowed values: low medium high critical

approved_tool_count

required

integer

denied_candidate_count

required

integer

superseded_by_submission_id

string

created_from_snapshot_id

string

manifest

required

object

schema_version

required

server_id

required

string

>= 1 characters

name

required

string

>= 1 characters

tenant_id

required

string

>= 1 characters

owner

required

object

team

required

string

>= 1 characters

user_id

required

string

>= 1 characters

escalation_contact

required

string

>= 1 characters

oncall_rotation

required

string

>= 1 characters

environment_id

required

string

>= 1 characters

endpoint

string format: uri

/^https:///

transport

required

One of:

object

Any of:

unknown

unknown

object

object

Any of:

unknown

unknown

version

required

string

>= 1 characters

registration_status

required

Allowed values: registered disabled deprecated

credential_mode

required

Allowed values: service_account user_delegated agent_scoped workload_mapped

requested_approval_status

required

Allowed values: submitted under_review

docs_url

required

string format: uri

tools

required

Array<object>

>= 1 items

object

tool_id

required

string

>= 1 characters

name

required

string

>= 1 characters

description

required

string

>= 1 characters

risk_tier

required

Allowed values: low medium high critical

gateway_status

required

Allowed values: allowed denied_candidate

denied_reason

string

/^[a-z0-9_]+$/

input_schema_ref

required

string

>= 1 characters

input_schema

Sanitized MCP tool input schema preserved in the approved snapshot and runtime projection.

object

policy_refs

required

Array<string>

>= 1 items