Preview MCP server deletion
/api/v1/mcp-servers/{server_id}/delete-impactPreview how many agents would be detached by deleting a connector. The returned agent list is paginated and includes only agents the caller can identify.
Required access
Credentials: delegated token, user session
Scope: mcp_servers:delete
Requires the same connector deletion authority as the delete operation. Managing a library connector through a delegated token also requires the exact mcp_servers:publish scope. The total can exceed the visible-agent count. A delegated caller also needs agents:read to receive agent identities; without it, the visible count is zero and the agent list is empty.
Authorization
DelegatedToken A token issued to an external application acting for a specific user, prefixed gsmc_dt_. Carries that user's identity for attribution and ownership, is bound to the organization chosen when it was issued, and stays capped at member role however privileged the user is.
In: header
Path Parameters
uuidQuery Parameters
1 <= value <= 100500 <= value0Header Parameters
Selects the active organization for a direct user session that has more than one membership. Service-principal keys and delegated tokens are each bound to one organization and ignore it.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/mcp-servers/497f6eca-6276-4993-bfeb-53cbbbba6f08/delete-impact" \ -H "Authorization: Bearer $GUEST_MACHINES_API_KEY"{ "attached_agent_count": 0, "visible_agent_count": 0, "agents": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string" } ]}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}