APIPolicies
Evaluate agent instance access
Evaluate effective access for an agent instance — what MCPs and tools it can use.
GET
/policies/evaluate/agent-instances/{agent_instance_id}Evaluate effective access for an agent instance — what MCPs and tools it can use.
Path Parameters
agent_instance_id*string
Format
uuidResponse Body
application/json
application/json
curl -X GET "https://example.com/policies/evaluate/agent-instances/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "agent_instance_id": null, "agent_slug": "string", "mcps": [ { "mcp_id": "92dad337-069f-4a18-a93d-2e7f16082ffb", "slug": "string", "display_name": "string", "tools": [ { "name": "string", "description": "string", "status": "allowed", "policy": { "id": null, "priority": 0, "mcp_ids": [ "c2c9208c-a7ac-41cc-84f1-8c1caec92987" ], "agent_slugs": [ "string" ], "agent_instance_ids": [ "bc3f18ff-0dcd-4cc7-8f61-6ca61814f10b" ], "user_ids": [ "2d98503d-4ab4-41bd-8fc6-78cc006fd2db" ], "groups": [ "string" ], "agent_slug_tag_ids": [ "e428595a-d9dd-4887-8327-2d9cad5b7425" ], "mcp_tag_ids": [ "17d4a46c-d971-4171-9a66-88ec59ce6eeb" ], "tool_tag_ids": [ "41068329-9b4f-4cc3-b249-3ec2a7a2cee8" ], "condition": "string", "condition_description": "string", "tool_patterns": [ "string" ], "effect": "allow", "status": "active", "name": "string", "description": "string", "agent_instance_refs": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "display_name": "string" } ], "user_refs": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "display_name": "string" } ], "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" } } ] } ]}{ "code": "bad_request", "message": "string", "validation_errors": [ { "field": "string", "message": "string", "rule": "string" } ]}