API
/web_api/mcp_server_snapshot/capture
/web_api/mcp_server_snapshot/capture
This page is built from the JSON Schema snapshot in the documentation repository. The snapshot is updated by a separate command from the main app catalog and is not rewritten when the site is built.
Request
main-app://schemas/api_mcp_testing/mcp_server_snapshot/capture.request.json
REQUEST /web_api/mcp_server_snapshot/capture
| Name | Type | Required | Constraint |
|---|---|---|---|
mcp_server_id | integer | Yes | minimum 1 |
Other top-level fields are not allowed.
Response
main-app://schemas/api_mcp_testing/mcp_server_snapshot/capture.response.json
RESPONSE /web_api/mcp_server_snapshot/capture
| Name | Type | Required | Constraint |
|---|---|---|---|
api_code | integer | Yes | const 200 |
api_result | object | Yes | other fields allowed |
empty | boolean | No | - |
Other top-level fields are not allowed.
api_result
| Name | Type | Required | Constraint |
|---|---|---|---|
mcp_server_snapshot_id | integer | No | minimum 0 |
mcp_server_id | integer | No | minimum 0 |
team_id | integer | No | minimum 0 |
project_id | integer | No | minimum 0 |
snapshot_status | enum | No | "DRAFT", "FIXED" |
protocol_revision | string | No | - |
snapshot_transport | enum | No | "STREAMABLE_HTTP" |
mcp_server_auth_kind | enum | No | "BEARER", "OAUTH" |
snapshot_completeness | enum | No | "COMPLETE_UNVERIFIED", "INCOMPLETE", "ERROR" |
catalog_hash | string | No | - |
server_name | string | null | No | maxLength 255 |
server_version | string | null | No | maxLength 255 |
instructions | string | null | No | - |
client_name | string | null | No | maxLength 255 |
client_version | string | null | No | maxLength 255 |
protocol_adapter_version | string | No | maxLength 128 |
redaction_policy_version | string | No | maxLength 32 |
credential_generation | integer | No | minimum 0 |
access_subject | string | null | No | maxLength 512 |
captured_at | string | No | - |
fixed_at | string | No | - |
created_by_user_id | integer | No | minimum 0 |
created_at | string | No | - |
updated_at | string | No | - |
Source schema
The files below are copied from the snapshot unchanged. A $ref fragment is a separate block. The schemas are not merged.
Request: main-app://schemas/api_mcp_testing/mcp_server_snapshot/capture.request.json
json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "main-app://schemas/api_mcp_testing/mcp_server_snapshot/capture.request.json",
"title": "REQUEST /web_api/mcp_server_snapshot/capture",
"type": "object",
"additionalProperties": false,
"required": ["mcp_server_id"],
"properties": {
"mcp_server_id": { "type": "integer", "minimum": 1 }
}
}Response: main-app://schemas/api_mcp_testing/mcp_server_snapshot/capture.response.json
json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "main-app://schemas/api_mcp_testing/mcp_server_snapshot/capture.response.json",
"title": "RESPONSE /web_api/mcp_server_snapshot/capture",
"allOf": [
{ "$ref": "main-app://schemas/_shared/envelope-success.json" },
{
"type": "object",
"properties": {
"api_result": { "$ref": "main-app://schemas/api_mcp_testing/mcp_server_snapshot/row.json" }
}
}
]
}Fragment: main-app://schemas/_shared/envelope-success.json
json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "main-app://schemas/_shared/envelope-success.json",
"title": "Canonical success envelope",
"type": "object",
"required": ["api_code", "api_result"],
"properties": {
"api_code": { "const": 200 },
"api_result": true,
"empty": { "type": "boolean" }
},
"additionalProperties": false
}Fragment: main-app://schemas/api_mcp_testing/mcp_server_snapshot/row.json
json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "main-app://schemas/api_mcp_testing/mcp_server_snapshot/row.json",
"title": "Row mcp_server_snapshot",
"$comment": "Generated from the DB model structure_scheme. Edit the model, then run node fill-from-structure-scheme.mjs.",
"type": "object",
"additionalProperties": true,
"properties": {
"mcp_server_snapshot_id": {
"type": "integer",
"minimum": 0
},
"mcp_server_id": {
"type": "integer",
"minimum": 0
},
"team_id": {
"type": "integer",
"minimum": 0
},
"project_id": {
"type": "integer",
"minimum": 0
},
"snapshot_status": {
"type": "string",
"enum": [
"DRAFT",
"FIXED"
]
},
"protocol_revision": {
"type": "string"
},
"snapshot_transport": {
"type": "string",
"enum": [
"STREAMABLE_HTTP"
]
},
"mcp_server_auth_kind": {
"type": "string",
"enum": [
"BEARER",
"OAUTH"
]
},
"snapshot_completeness": {
"type": "string",
"enum": [
"COMPLETE_UNVERIFIED",
"INCOMPLETE",
"ERROR"
]
},
"catalog_hash": {
"type": "string"
},
"server_name": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"server_version": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"instructions": {
"type": [
"string",
"null"
]
},
"client_name": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"client_version": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"protocol_adapter_version": {
"type": "string",
"maxLength": 128
},
"redaction_policy_version": {
"type": "string",
"maxLength": 32
},
"credential_generation": {
"type": "integer",
"minimum": 0
},
"access_subject": {
"type": [
"string",
"null"
],
"maxLength": 512
},
"captured_at": {
"type": "string",
"description": "timestamp Y-m-d H:i:s"
},
"fixed_at": {
"type": "string",
"description": "timestamp Y-m-d H:i:s"
},
"created_by_user_id": {
"type": "integer",
"minimum": 0
},
"created_at": {
"type": "string",
"description": "timestamp Y-m-d H:i:s"
},
"updated_at": {
"type": "string",
"description": "timestamp Y-m-d H:i:s"
}
}
}Did this page help?