Skip to content
MCP Gateway

List reviewable submissions (decision workbench) across the tenant, all environments.

GET
/v1/approvals

Tenant-wide queue of submissions whose review_status is submitted or under_review, including approved servers carrying a pending revision/owner-edit/deprecation submission. Not derived from server approval_status. V1 returns only resource_type=mcp_server. Fixed page_size 50; default sort (sort omitted) is risk-first then oldest-waiting.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
tenant_id
string
q
string
change_type
string
risk
string
health
string
owner_team
string
environment_id
string
review_status
string
bulk_eligible
boolean
sort
string
/^[a-z_]+:(asc|desc)$/
page
integer
default: 1 >= 1

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Tenant-wide approvals queue envelope with KPIs, facets, and reviewable submissions.

object
schema_version
required
page
required
integer
>= 1
page_size
required
integer
total_count
required
integer
total_pages
required
integer
>= 1
kpis
required
object
total_pending
required
integer
under_review
required
integer
critical_risk
required
integer
unhealthy
required
integer
bulk_eligible
required
integer
teams
required
integer
facets
required
object
resource_type
required
Array<object>
object
value
required
string
>= 1 characters
count
required
integer
change_type
required
Array<object>
object
value
required
string
>= 1 characters
count
required
integer
risk
required
Array<object>
object
value
required
string
>= 1 characters
count
required
integer
health
required
Array<object>
object
value
required
string
>= 1 characters
count
required
integer
owner_team
required
Array<object>
object
value
required
string
>= 1 characters
count
required
integer
environment_id
required
Array<object>
object
value
required
string
>= 1 characters
count
required
integer
review_status
required
Array<object>
object
value
required
string
>= 1 characters
count
required
integer
bulk_eligible
required
Array<object>
object
value
required
string
>= 1 characters
count
required
integer
items
required
Array<object>
object
resource_type
required
tenant_id
required
string
>= 1 characters
resource_id
required
string
>= 1 characters
name
required
string
>= 1 characters
environment_id
required
string
>= 1 characters
submission_id
required
string
>= 1 characters
manifest_hash
required
string
/^sha256:[0-9a-f]{64}$/
review_status
required
Allowed values: submitted under_review
change_type
required
Allowed values: registration revision owner_edit deprecation
submitted_by
required
string
>= 1 characters
submitted_at
required
string format: date-time
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
max_tool_risk_tier
required
Allowed values: low medium high critical
health
required
object
status
required
Allowed values: healthy degraded unhealthy unknown
route_available
required
boolean
last_checked_at
required
string format: date-time
latency_ms
required
integer
checked_by
required
string
>= 1 characters
failure_reason
required
string
nullable /^[a-z0-9_]+$/
connector_status
required
Allowed values: healthy degraded unhealthy unknown not_configured
approved_tool_count
required
integer
denied_candidate_count
required
integer
bulk_eligible
required
boolean
bulk_ineligible_reason
string
Allowed values: critical_risk unhealthy deprecated_registration disabled_approval missing_permission mixed_resource_type
permissions
required
object
allowed_actions
required
Array
Allowed values: approval.read approval.approve approval.reject

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