Skip to content
MCP Gateway

Compare two approved backend snapshot IDs.

GET
/v1/mcp-servers/{server_id}/versions/compare

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
server_id
required
string

Query Parameters

Section titled “Query Parameters ”
tenant_id
required
string
environment_id
required
string
from
required
string
to
required
string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Secret-free diff between approved snapshots.

object
schema_version
required
from
required
object
snapshot_id
required
string
>= 1 characters
previous_snapshot_id
string
submission_id
required
string
>= 1 characters
sequence
required
integer
>= 1
manifest_hash
required
string
/^sha256:[0-9a-f]{64}$/
version
required
string
>= 1 characters
version_unchanged_from_previous
required
boolean
approved_at
required
string format: date-time
approved_by
required
string
>= 1 characters
approval_reason_code
required
string
/^[a-z0-9_]+$/
approval_reason
string
>= 1 characters
max_tool_risk_tier
required
Allowed values: low medium high critical
risk_delta
required
object
from
Allowed values: low medium high critical
to
required
Allowed values: low medium high critical
increased
required
boolean
approved_tool_count
required
integer
denied_candidate_count
required
integer
tool_delta
required
object
added
required
integer
removed
required
integer
changed
required
integer
changed_areas
required
Array
Allowed values: endpoint owner credential_mode policy_refs tools docs_url registration_status schema_version
to
required
object
snapshot_id
required
string
>= 1 characters
previous_snapshot_id
string
submission_id
required
string
>= 1 characters
sequence
required
integer
>= 1
manifest_hash
required
string
/^sha256:[0-9a-f]{64}$/
version
required
string
>= 1 characters
version_unchanged_from_previous
required
boolean
approved_at
required
string format: date-time
approved_by
required
string
>= 1 characters
approval_reason_code
required
string
/^[a-z0-9_]+$/
approval_reason
string
>= 1 characters
max_tool_risk_tier
required
Allowed values: low medium high critical
risk_delta
required
object
from
Allowed values: low medium high critical
to
required
Allowed values: low medium high critical
increased
required
boolean
approved_tool_count
required
integer
denied_candidate_count
required
integer
tool_delta
required
object
added
required
integer
removed
required
integer
changed
required
integer
changed_areas
required
Array
Allowed values: endpoint owner credential_mode policy_refs tools docs_url registration_status schema_version
risk_change
required
object
from
Allowed values: low medium high critical
to
required
Allowed values: low medium high critical
increased
required
boolean
sections
required
object
identity_owner
required
Array<object>
object
field
required
string
>= 1 characters
from
string
to
string
resolved_refs

Present for policy_refs diffs when the backend can resolve labels/status.

Array<object>
object
policy_ref
required
string
>= 1 characters
exists
required
boolean
status
required
Any of:
string
Allowed values: draft validating published archived rejected
active_in_environment
required
boolean
owner
required
Any of:
object
user_id
required
string
>= 1 characters
team
required
string
>= 1 characters
description
required
string | null
rule_count
required
integer
used_by_servers_count
required
integer
valid_for_runtime
required
boolean
reason_code
required
Allowed values: valid policy_ref_not_found policy_ref_not_published policy_ref_archived policy_ref_environment_mismatch
endpoint_routing
required
Array<object>
object
field
required
string
>= 1 characters
from
string
to
string
resolved_refs

Present for policy_refs diffs when the backend can resolve labels/status.

Array<object>
object
policy_ref
required
string
>= 1 characters
exists
required
boolean
status
required
Any of:
string
Allowed values: draft validating published archived rejected
active_in_environment
required
boolean
owner
required
Any of:
object
user_id
required
string
>= 1 characters
team
required
string
>= 1 characters
description
required
string | null
rule_count
required
integer
used_by_servers_count
required
integer
valid_for_runtime
required
boolean
reason_code
required
Allowed values: valid policy_ref_not_found policy_ref_not_published policy_ref_archived policy_ref_environment_mismatch
credential_mode
required
Array<object>
object
field
required
string
>= 1 characters
from
string
to
string
resolved_refs

Present for policy_refs diffs when the backend can resolve labels/status.

Array<object>
object
policy_ref
required
string
>= 1 characters
exists
required
boolean
status
required
Any of:
string
Allowed values: draft validating published archived rejected
active_in_environment
required
boolean
owner
required
Any of:
object
user_id
required
string
>= 1 characters
team
required
string
>= 1 characters
description
required
string | null
rule_count
required
integer
used_by_servers_count
required
integer
valid_for_runtime
required
boolean
reason_code
required
Allowed values: valid policy_ref_not_found policy_ref_not_published policy_ref_archived policy_ref_environment_mismatch
policy_refs
required
Array<object>
object
field
required
string
>= 1 characters
from
string
to
string
resolved_refs

Present for policy_refs diffs when the backend can resolve labels/status.

Array<object>
object
policy_ref
required
string
>= 1 characters
exists
required
boolean
status
required
Any of:
string
Allowed values: draft validating published archived rejected
active_in_environment
required
boolean
owner
required
Any of:
object
user_id
required
string
>= 1 characters
team
required
string
>= 1 characters
description
required
string | null
rule_count
required
integer
used_by_servers_count
required
integer
valid_for_runtime
required
boolean
reason_code
required
Allowed values: valid policy_ref_not_found policy_ref_not_published policy_ref_archived policy_ref_environment_mismatch
tools_added
required
Array<object>
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
input_schema_ref
required
string
>= 1 characters
denied_reason
string
/^[a-z0-9_]+$/
policy_refs
required
Array<string>
tools_removed
required
Array<object>
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
input_schema_ref
required
string
>= 1 characters
denied_reason
string
/^[a-z0-9_]+$/
policy_refs
required
Array<string>
tools_changed
required
Array<object>
object
tool_id
required
string
>= 1 characters
changes
required
Array<object>
object
field
required
string
>= 1 characters
from
string
to
string
resolved_refs

Present for policy_refs diffs when the backend can resolve labels/status.

Array<object>
object
policy_ref
required
string
>= 1 characters
exists
required
boolean
status
required
Any of:
string
Allowed values: draft validating published archived rejected
active_in_environment
required
boolean
owner
required
Any of:
object
user_id
required
string
>= 1 characters
team
required
string
>= 1 characters
description
required
string | null
rule_count
required
integer
used_by_servers_count
required
integer
valid_for_runtime
required
boolean
reason_code
required
Allowed values: valid policy_ref_not_found policy_ref_not_published policy_ref_archived policy_ref_environment_mismatch
manifest_schema_version
required
Array<object>
object
field
required
string
>= 1 characters
from
string
to
string
resolved_refs

Present for policy_refs diffs when the backend can resolve labels/status.

Array<object>
object
policy_ref
required
string
>= 1 characters
exists
required
boolean
status
required
Any of:
string
Allowed values: draft validating published archived rejected
active_in_environment
required
boolean
owner
required
Any of:
object
user_id
required
string
>= 1 characters
team
required
string
>= 1 characters
description
required
string | null
rule_count
required
integer
used_by_servers_count
required
integer
valid_for_runtime
required
boolean
reason_code
required
Allowed values: valid policy_ref_not_found policy_ref_not_published policy_ref_archived policy_ref_environment_mismatch

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