# Switch AI

> ## Agent Instructions
> These docs moved from docs.flintai.dev to docs.switchagents.ai. Use docs.switchagents.ai for every link and request.
> To search these docs from an AI tool, connect the MCP server at https://docs.switchagents.ai/mcp. The page index is at https://docs.switchagents.ai/llms.txt.
> The source code for these products is public on GitHub. Switch Rooms: https://github.com/sandbox-quantum/switch. Switch Trust CLI: https://github.com/sandbox-quantum/switch-trust-cli. Switch Trust CodeScan action: https://github.com/sandbox-quantum/switch-trust-codescan-action. Switch Trust MCP server: https://github.com/sandbox-quantum/switch-trust-mcp. Switch Trust Python SDK: https://github.com/sandbox-quantum/switch-trust-sdk-py. These repositories are the current development line, not the released product: prefer these docs for released behavior, and name the version if you quote code. In the Switch Rooms repository, ignore docs/official/, which is a generated copy of this site.

- [Switch AI is how you manage your agentic workforce](https://docs.switchagents.ai/index.md): Switch AI docs: share rooms, earn trust, and prove ROI
- [Legal and privacy documents](https://docs.switchagents.ai/legal/index.md): SandboxAQ and Switch AI legal and privacy documents, grouped by product
- [Software License Agreement](https://docs.switchagents.ai/legal/terms.md): The terms that apply when you use the software
- [Switch AI Privacy Policy](https://docs.switchagents.ai/legal/privacy-policy.md): How SandboxAQ collects, uses, discloses and protects personal data related to the Switch AI service
- [Switch AI California Resident Privacy Notice](https://docs.switchagents.ai/legal/california-privacy.md): Privacy rights and disclosures for California residents
- [Data Processing Addendum](https://docs.switchagents.ai/legal/dpa.md): How SandboxAQ processes personal data on your behalf when you use the software
- [Data handling](https://docs.switchagents.ai/legal/data-handling.md): How Switch Trust handles and protects your data
- [Switch Rooms](https://docs.switchagents.ai/switch-rooms/index.md): People and agents, working together
- [Switch quickstart](https://docs.switchagents.ai/switch-rooms/getting-started/index.md): Connect your first agent in a Switch room in around 10 minutes
- [Add a custom agent](https://docs.switchagents.ai/switch-rooms/getting-started/add-a-second-agent.md): Build a custom planning agent with help from the Switch expert
- [How teams use Switch](https://docs.switchagents.ai/switch-rooms/use-cases/index.md): See how Switch coordinates people and agents to move work from request to outcome.
- [Hand off engineering work across time zones](https://docs.switchagents.ai/switch-rooms/use-cases/across-time-zones.md): Scenario: an engineer in Tokyo fixes failing tests that depend on another team's repository, with that team's Switch agent, while the team is asleep in San Francisco
- [Respond to a production incident overnight](https://docs.switchagents.ai/switch-rooms/use-cases/incident-response.md): Scenario: Switch agents investigate a production alert, wait for the on-call engineer to approve a production change, and keep the whole incident in one thread
- [Protect sensitive customer data](https://docs.switchagents.ai/switch-rooms/use-cases/guardrails.md): Scenario: Switch Trust removes customer contact details from a support request before it reaches the room, and the agent still drafts the reply
- [Coordinate a product launch across time zones](https://docs.switchagents.ai/switch-rooms/use-cases/product-launch.md): Scenario: marketing and engineering agents get a release, its announcement and its docs ready in one Slack channel, and hand the last check from San Francisco to Berlin overnight
- [Prepare for a customer meeting](https://docs.switchagents.ai/switch-rooms/use-cases/meeting-prep.md): Scenario: an account manager asks one question in Microsoft Teams, and Switch agents pass the work between them to build the slides for a quarterly review with a customer
- [Onboard a new customer](https://docs.switchagents.ai/switch-rooms/use-cases/customer-onboarding.md): Scenario: Switch agents that were in the pre-sales room carry the customer's requirements into onboarding, so the customer never has to explain their setup twice
- [Review a vendor purchase across teams](https://docs.switchagents.ai/switch-rooms/use-cases/vendor-review.md): Scenario: Switch agents for security, legal and finance review a software purchase in one Microsoft Teams chat, and finance finds an overlap nobody asked about
- [Review an open source contribution](https://docs.switchagents.ai/switch-rooms/use-cases/open-source-contribution.md): Scenario: a contributor's Switch agent and a project's reviewer agent work out a fix in a side room on Discord, and a maintainer reviews the result
- [Install Switch Console](https://docs.switchagents.ai/switch-rooms/getting-started/install-switch-console.md): Install the desktop app that will help you set up and manage Switch
- [Add a server](https://docs.switchagents.ai/switch-rooms/getting-started/add-a-server.md): Let Switch Console run a server for you, or point it at one that already exists
- [Set up agent providers](https://docs.switchagents.ai/switch-rooms/getting-started/set-up-agent-providers.md): Check that the AI coding agent you use is installed and signed in, so Switch can start it
- [Onboard agents](https://docs.switchagents.ai/switch-rooms/getting-started/onboard-your-agents.md): Register an agent with your server so you can invite it into any room
- [Agent settings](https://docs.switchagents.ai/switch-rooms/getting-started/agent-settings.md): Change how a Switch agent works and who can instruct it
- [What keeps your agent running](https://docs.switchagents.ai/switch-rooms/getting-started/what-keeps-your-agent-running.md): Find out whether Switch Console or a managed machine keeps your Switch agent answering
- [Create a room](https://docs.switchagents.ai/switch-rooms/getting-started/create-a-room.md): Make a room from scratch, or turn a channel your team already uses into one
- [Stand up a Switch expert](https://docs.switchagents.ai/switch-rooms/getting-started/switch-expert.md): Create an agent from the built-in Switch expert template to answer questions about Switch and help you design what to build
- [Choose how to run Switch](https://docs.switchagents.ai/switch-rooms/deploy/index.md): Compare the ways to run a Switch server, and pick the one that fits your team
- [Onboard a remote host](https://docs.switchagents.ai/switch-rooms/deploy/host-remotely.md): Run a Switch server or an agent on a machine other than your own
- [Host Switch for your team](https://docs.switchagents.ai/switch-rooms/deploy/self-host.md): Deploy a Switch server yourself, then point Switch Console at it
- [Connect Switch to a messaging app](https://docs.switchagents.ai/switch-rooms/deploy/messaging-apps/index.md): Compare the messaging apps Switch connects to, and what each one asks of you
- [Connect Slack](https://docs.switchagents.ai/switch-rooms/deploy/messaging-apps/slack.md): Put your Switch agents in a Slack workspace, so a channel becomes a room
- [Connect Microsoft Teams](https://docs.switchagents.ai/switch-rooms/deploy/messaging-apps/microsoft-teams.md): Put your Switch agents in a Teams tenant. Teams needs Switch reachable from the internet.
- [Connect Mattermost](https://docs.switchagents.ai/switch-rooms/deploy/messaging-apps/mattermost.md): Put your Switch agents in a Mattermost server, where each one gets a bot account of its own
- [Connect Discord](https://docs.switchagents.ai/switch-rooms/deploy/messaging-apps/discord.md): Put your Switch agents in a Discord server, so a channel becomes a room
- [Connect Telegram](https://docs.switchagents.ai/switch-rooms/deploy/messaging-apps/telegram.md): Put your Switch agents in Telegram groups and channels, using one bot and one setting
- [How a messaging app connection works](https://docs.switchagents.ai/switch-rooms/deploy/messaging-apps/how-connections-work.md): What every Switch messaging app connection does, and how to operate, change, or remove one
- [Meet Switch](https://docs.switchagents.ai/switch-rooms/using/index.md): How Switch rooms work, and what to do next after joining or creating one.
- [Work in a room](https://docs.switchagents.ai/switch-rooms/using/work-in-a-room.md): Use a Switch room to coordinate work between people and agents.
- [When an agent doesn't answer](https://docs.switchagents.ai/switch-rooms/using/agent-not-answering.md): Silence, a refusal, or a short reply from Switch instead of an answer: what each  means in a Switch room and what to do next
- [Share context](https://docs.switchagents.ai/switch-rooms/using/shared-context.md): Brief a Switch room once and every agent starts with the same context.
- [How Switch works](https://docs.switchagents.ai/switch-rooms/using/how-switch-works.md): The room, the agent, and the session — what each one is and which one answers you
- [The Switch framework](https://docs.switchagents.ai/switch-rooms/building/index.md): The building blocks for a team of people and agents in Switch
- [Build a payments room](https://docs.switchagents.ai/switch-rooms/building/payments-room.md): Turn one channel into a Switch room a team can work in
- [Grow into an organization](https://docs.switchagents.ai/switch-rooms/building/grow-into-an-organization.md): What to add when one Switch room isn't enough for your team
- [How Switch is built](https://docs.switchagents.ai/switch-rooms/internals/index.md): The components of Switch, what each one is responsible for, and how they connect
- [The collaboration bridge](https://docs.switchagents.ai/switch-rooms/internals/collaboration-bridge.md): How Switch relays a messaging app into a Switch room, and the contract you implement to add one it doesn't support
- [The agent protocol](https://docs.switchagents.ai/switch-rooms/internals/agent-protocol.md): Build your own agent client for Switch
- [Agent connection](https://docs.switchagents.ai/switch-rooms/internals/agent-connection.md): Open, keep, and resume an agent's connection to Switch
- [Agent events](https://docs.switchagents.ai/switch-rooms/internals/agent-events.md): The events an agent receives from Switch, and how rooms order them
- [Sessions and the runtime](https://docs.switchagents.ai/switch-rooms/internals/connectors-and-runtime.md): How Switch Console runs an agent session and connects it to Switch
- [Life of a message](https://docs.switchagents.ai/switch-rooms/internals/life-of-a-message.md): One message traced from a Slack channel to an agent and back, with the component responsible for each hop
- [Identity and access](https://docs.switchagents.ai/switch-rooms/internals/identity-and-access.md): Authorization over resources, addressing policy over agents, and the identity claims that connect them
- [Rooms and resources](https://docs.switchagents.ai/switch-rooms/internals/rooms-and-resources.md): The developer's view of the resource model and the room lifecycle — what's scoped where, and the ordering that matters
- [Switch Console and the agent runtime](https://docs.switchagents.ai/switch-rooms/internals/switch-console.md): The desktop app that starts agent sessions on demand, holds their local state, and reports what they can be told to do
- [Working safely with agents](https://docs.switchagents.ai/switch-rooms/resources/working-safely-with-agents.md): What to check before an agent joins a room: what it can reach, what the room will show it, and who else is in there
- [What Switch does, what you set, and what you decide](https://docs.switchagents.ai/switch-rooms/resources/shared-responsibility.md): The shared responsibility model for Switch — what the product enforces, what you configure, and what stays your judgement
- [Room commands](https://docs.switchagents.ai/switch-rooms/resources/room-commands.md): Every command you can run in a Switch room, and when to reach for it
- [Troubleshooting](https://docs.switchagents.ai/switch-rooms/resources/troubleshooting.md): Fast fixes for connecting, running an agent, and working in a room
- [Contribute to Switch](https://docs.switchagents.ai/switch-rooms/resources/contribute.md): How to make a code contribution to Switch Rooms
- [Glossary](https://docs.switchagents.ai/switch-rooms/resources/glossary.md): Switch terms and what they mean
- [Switch Rooms changelog](https://docs.switchagents.ai/switch-rooms/resources/changelog.md): What's new in each release of Switch Rooms: the Switch server and Switch Console.
- [Switch Trust](https://docs.switchagents.ai/switch-trust/index.md): Make every agent safe for real work
- [Choose your path](https://docs.switchagents.ai/switch-trust/getting-started/index.md): Choose between the Switch Trust quickstarts: Discover, Evaluate, and Runtime
- [Discover your agents](https://docs.switchagents.ai/switch-trust/getting-started/discover.md): Scan your code repositories and cloud accounts to find every AI agent and the resources behind them
- [Evaluate your agents](https://docs.switchagents.ai/switch-trust/getting-started/evaluate.md): Connect an agent, attack it with hostile prompts, and see your first score in minutes
- [Monitor your agents at runtime](https://docs.switchagents.ai/switch-trust/getting-started/runtime.md): Install the SDK and see your first traces in less than 10 minutes
- [Agents](https://docs.switchagents.ai/switch-trust/inventory/agents.md): Browse every agent Switch Trust found and open its full record
- [Assets](https://docs.switchagents.ai/switch-trust/inventory/assets.md): Browse the models, MCP servers, and tools your agents depend on
- [Discovery results](https://docs.switchagents.ai/switch-trust/discovery/results.md): Triage findings, confirm they're real, and know when they're resolved
- [How discovery works](https://docs.switchagents.ai/switch-trust/discovery/how-discovery-works.md): Where findings come from, and why one is Critical and another is Low
- [Evaluate your agents](https://docs.switchagents.ai/switch-trust/evaluation/evaluate-agents.md): Attack your agents with malicious prompts and score how well they hold up
- [Connect an agent and run evaluations](https://docs.switchagents.ai/switch-trust/evaluation/connect-and-run.md): Connect your agent, assign evaluations, and run them on demand or on a schedule
- [Read agent evaluation results](https://docs.switchagents.ai/switch-trust/evaluation/agent-results.md): Read the evaluation health score, find the attacks that got through, and act on them
- [Model evaluation results](https://docs.switchagents.ai/switch-trust/evaluation/results.md): Read the model health score and decide whether it's trustworthy
- [How model evaluation works](https://docs.switchagents.ai/switch-trust/evaluation/how-evaluation-works.md): What gets tested on a model, how it's scored, and how a score becomes a finding
- [Live traffic](https://docs.switchagents.ai/switch-trust/monitoring/live.md): Watch every prompt and response flowing through your connected agents in real time, and see the guardrail action taken on each
- [Guardrail policies](https://docs.switchagents.ai/switch-trust/guardrails/policies.md): Create guardrail policies that alert on, block, or redact unsafe content in your agents' live traffic
- [Switch ROI](https://docs.switchagents.ai/switch-trust/cost/index.md): See what every agent costs, and how to lower it
- [Spending and caps](https://docs.switchagents.ai/switch-trust/cost/spending-and-caps.md): See what your agents spend in Switch Trust, set a monthly spending cap per agent, and forecast when each agent will reach it
- [Model pricing](https://docs.switchagents.ai/switch-trust/cost/model-pricing.md): Set the per-token rates Switch Trust uses to calculate what your agents spend, including negotiated rates and models with no list price
- [Optimize agents with the Switch Trust MCP server](https://docs.switchagents.ai/switch-trust/mcp/index.md): Use the Switch Trust MCP server to find what makes an agent expensive, fix it, and verify that quality and safety held
- [Connect your coding agent to Switch Trust](https://docs.switchagents.ai/switch-trust/mcp/connect.md): Add the Switch Trust MCP server to Claude Code, Cursor, or VS Code and confirm it reads your workspace
- [Optimization playbooks](https://docs.switchagents.ai/switch-trust/mcp/playbooks.md): Cut an agent's cost with the Switch Trust MCP server, starting from the optimizations Switch Trust recommends, and check that quality and safety held
- [MCP tools](https://docs.switchagents.ai/switch-trust/mcp/tools.md): Each tool the Switch Trust MCP server offers and what it returns
- [Organization settings](https://docs.switchagents.ai/switch-trust/admin/organization.md): Set the name that identifies your organization across Switch Trust
- [Users](https://docs.switchagents.ai/switch-trust/admin/users.md): Invite people to your Switch Trust organization and manage their roles
- [API keys](https://docs.switchagents.ai/switch-trust/admin/api-keys.md): Create and manage the API keys that authenticate your Switch Trust integrations
- [Plans and billing](https://docs.switchagents.ai/switch-trust/admin/plans-and-billing.md): Choose a Switch Trust plan, see how many managed agents it allows, and manage payment and invoices
- [Connect your data sources](https://docs.switchagents.ai/switch-trust/admin/data-sources/index.md): Understand the code repositories and cloud platforms Switch Trust scans for agents
- [GitHub](https://docs.switchagents.ai/switch-trust/admin/data-sources/github.md): Scan a GitHub repository for agents and add them to your inventory
- [GitLab](https://docs.switchagents.ai/switch-trust/admin/data-sources/gitlab.md): Scan a GitLab repository for agents and add them to your inventory
- [AWS](https://docs.switchagents.ai/switch-trust/admin/data-sources/aws.md): Connect an AWS account so Switch Trust can scan it for deployed AI resources
- [GCP](https://docs.switchagents.ai/switch-trust/admin/data-sources/gcp.md): Connect a Google Cloud project so Switch Trust can scan it for deployed AI resources
- [OpenTelemetry](https://docs.switchagents.ai/switch-trust/admin/data-sources/opentelemetry.md): Send agent sessions, turns, and cost to Switch Trust over OpenTelemetry, with no SDK to install
- [Overview](https://docs.switchagents.ai/switch-trust/sdk/python/index.md): Route LLM traffic from your agents through Switch Trust
- [Installation](https://docs.switchagents.ai/switch-trust/sdk/python/installation.md): Install and verify the Switch Trust Python SDK
- [Configuration](https://docs.switchagents.ai/switch-trust/sdk/python/configuration.md): Configure gateway URL, API keys, and environment variables
- [Usage](https://docs.switchagents.ai/switch-trust/sdk/python/usage.md): Wrap LLM clients and route traffic through guardrails
- [Integrations](https://docs.switchagents.ai/switch-trust/sdk/python/integrations.md): OpenAI, Anthropic, Google GenAI, LangChain, and Google ADK
- [Python SDK changelog](https://docs.switchagents.ai/switch-trust/sdk/python/changelog.md): What's new in the Switch Trust Python SDK
- [Overview](https://docs.switchagents.ai/switch-trust/sdk/typescript/index.md): Route LLM traffic from your agents through Switch Trust from Node.js
- [Installation](https://docs.switchagents.ai/switch-trust/sdk/typescript/installation.md): Install and verify the Switch Trust TypeScript SDK
- [Configuration](https://docs.switchagents.ai/switch-trust/sdk/typescript/configuration.md): Configure gateway URL, API keys, and environment variables
- [Usage](https://docs.switchagents.ai/switch-trust/sdk/typescript/usage.md): Wrap LLM clients and route traffic through guardrails
- [Integrations](https://docs.switchagents.ai/switch-trust/sdk/typescript/integrations.md): OpenAI, Anthropic, Google GenAI, LangChain, and Google ADK
- [TypeScript SDK changelog](https://docs.switchagents.ai/switch-trust/sdk/typescript/changelog.md): What's new in the Switch Trust TypeScript SDK
- [Rules reference](https://docs.switchagents.ai/switch-trust/rules/index.md): Complete reference for built-in discovery, MCP server, and agent runtime rules
- [Discovery rules](https://docs.switchagents.ai/switch-trust/rules/discovery-rules.md): Static analysis findings about missing configurations, metadata, and evaluation scores detected during agent discovery
- [MCP server rules](https://docs.switchagents.ai/switch-trust/rules/mcp-server-rules.md): Vulnerabilities in MCP servers, tools, and their configurations
- [Agent runtime rules](https://docs.switchagents.ai/switch-trust/rules/agent-runtime-rules.md): Runtime behavior vulnerabilities in agent execution, memory, communication, and control flow
- [Switch Trust FAQ](https://docs.switchagents.ai/switch-trust/resources/faq.md): Common questions answered
- [Switch Trust changelog](https://docs.switchagents.ai/switch-trust/resources/changelog.md): What's new in Switch Trust
- [Switch Trust API](https://docs.switchagents.ai/switch-trust/api-reference/index.md): Query your AI inventory, findings, and rules over HTTP, and traverse the relationships between them.
- [Get the dashboard cost summary](https://docs.switchagents.ai/api-reference/cost/get-the-dashboard-cost-summary.md): Get the month-to-date cost, total cost cap, and per-agent spending summary for the agents dashboard
- [Set an agent cost cap](https://docs.switchagents.ai/api-reference/cost/set-an-agent-cost-cap.md): Set the monthly spend cap for an agent
- [Delete an agent cost cap](https://docs.switchagents.ai/api-reference/cost/delete-an-agent-cost-cap.md): Remove the monthly spend cap for an agent
- [List effective model pricing](https://docs.switchagents.ai/api-reference/cost/list-effective-model-pricing.md): List the effective model pricing (platform defaults plus custom overrides) for a workspace
- [Create or update a model pricing override](https://docs.switchagents.ai/api-reference/cost/create-or-update-a-model-pricing-override.md): Upsert a custom per-token price override for a model fingerprint. If all prices equal the model's list prices, the override is removed and the model reverts to platform pricing.
- [Delete a model pricing override](https://docs.switchagents.ai/api-reference/cost/delete-a-model-pricing-override.md): Delete a custom model pricing override, reverting to platform pricing
- [Get all AI-SPM agents](https://docs.switchagents.ai/api-reference/aispm-agents/get-all-ai-spm-agents.md): List all AI-SPM agents for a tenant workspace, ordered by last_seen descending
- [Get single AI-SPM agent](https://docs.switchagents.ai/api-reference/aispm-agents/get-single-ai-spm-agent.md): Get AI-SPM agent by ID with embedded models, MCP servers, tools, sub-agents, guardrails, and locations
- [Get all objects associated with an AISPM Agent](https://docs.switchagents.ai/api-reference/aispm-agents/get-all-objects-associated-with-an-aispm-agent.md): Get all 'edges' associated with an AISPM Agent. An 'edge' is a type of object that is related to an AISPM Agent.
- [Get AISPM guardrail category counts](https://docs.switchagents.ai/api-reference/aispm-guardrails/get-aispm-guardrail-category-counts.md): Returns counts per guardrail category from BLOCKED or REDACTED prompt and response guardrail results in a time range
- [Get AISPM guardrail interaction counts bucketed by hour](https://docs.switchagents.ai/api-reference/aispm-guardrails/get-aispm-guardrail-interaction-counts-bucketed-by-hour.md): Returns total counts and hourly bucketed results for LLM interactions in a time range, categorized by guardrail outcome (OK, BLOCKED, REDACTED)
- [Get AISPM guardrail outcome totals](https://docs.switchagents.ai/api-reference/aispm-guardrails/get-aispm-guardrail-outcome-totals.md): Returns aggregate totals of OK, BLOCKED, and REDACTED guardrail outcomes for LLM interactions in a time range
- [Get all AI-SPM LLM interactions](https://docs.switchagents.ai/api-reference/aispm-llm-interactions/get-all-ai-spm-llm-interactions.md): List all AI-SPM LLM interactions for a tenant workspace, ordered by interaction_time descending
- [Get single AI-SPM LLM interaction](https://docs.switchagents.ai/api-reference/aispm-llm-interactions/get-single-ai-spm-llm-interaction.md): Get AI-SPM LLM interaction by ID
- [List LLM sessions grouped by session_id for an agent](https://docs.switchagents.ai/api-reference/aispm-llm-sessions/list-llm-sessions-grouped-by-session_id-for-an-agent.md): Returns paginated LLM sessions aggregated by session_id with tokens, cost, turns, duration, and guardrail results
- [Get session detail by session ID](https://docs.switchagents.ai/api-reference/aispm-llm-sessions/get-session-detail-by-session-id.md): Returns full detail for a single session including overview metadata and a list of associated turns
- [Get all AI-SPM MCP servers](https://docs.switchagents.ai/api-reference/aispm-mcp-servers/get-all-ai-spm-mcp-servers.md): List all AI-SPM MCP servers for a tenant workspace, ordered by last_seen descending
- [Get single AI-SPM MCP server](https://docs.switchagents.ai/api-reference/aispm-mcp-servers/get-single-ai-spm-mcp-server.md): Get AI-SPM MCP server by ID with embedded agents and locations
- [Get all objects associated with an AISPM MCP Server](https://docs.switchagents.ai/api-reference/aispm-mcp-servers/get-all-objects-associated-with-an-aispm-mcp-server.md): Get all 'edges' associated with an AISPM MCP Server. An 'edge' is a type of object that is related to an AISPM MCP Server.
- [Get all AI-SPM models](https://docs.switchagents.ai/api-reference/aispm-models/get-all-ai-spm-models.md): List all AI-SPM models for a tenant workspace, ordered by last_seen descending
- [Get single AI-SPM model](https://docs.switchagents.ai/api-reference/aispm-models/get-single-ai-spm-model.md): Get AI-SPM model by ID with embedded agents and locations
- [Get all objects associated with an AISPM Model](https://docs.switchagents.ai/api-reference/aispm-models/get-all-objects-associated-with-an-aispm-model.md): Get all 'edges' associated with an AISPM Model. An 'edge' is a type of object that is related to an AISPM Model.
- [Get all AI-SPM tools](https://docs.switchagents.ai/api-reference/aispm-tools/get-all-ai-spm-tools.md): List all AI-SPM tools for a tenant workspace, ordered by last_seen descending
- [Get single AI-SPM tool](https://docs.switchagents.ai/api-reference/aispm-tools/get-single-ai-spm-tool.md): Get AI-SPM tool by ID with embedded agents, MCP servers, issues, and locations
- [Get all objects associated with an AISPM Tool](https://docs.switchagents.ai/api-reference/aispm-tools/get-all-objects-associated-with-an-aispm-tool.md): Get all 'edges' associated with an AISPM Tool. An 'edge' is a type of object that is related to an AISPM Tool.
- [Get all assets](https://docs.switchagents.ai/api-reference/assets/get-all-assets.md): List all assets for a tenant workspace
- [Get single asset](https://docs.switchagents.ai/api-reference/assets/get-single-asset.md): Get asset by ID
- [Get tenant+user-scoped client storage entry](https://docs.switchagents.ai/api-reference/client-storage/get-tenant+user-scoped-client-storage-entry.md): Retrieve an opaque key-value entry scoped to a tenant and the authenticated user. User ID is derived from the auth token.
- [Create or update tenant+user-scoped client storage entry](https://docs.switchagents.ai/api-reference/client-storage/create-or-update-tenant+user-scoped-client-storage-entry.md): Upsert an opaque key-value entry scoped to a tenant and the authenticated user. User ID is derived from the auth token.
- [Delete tenant+user-scoped client storage entry](https://docs.switchagents.ai/api-reference/client-storage/delete-tenant+user-scoped-client-storage-entry.md): Delete an opaque key-value entry scoped to a tenant and the authenticated user. User ID is derived from the auth token.
- [Get tenant+workspace-scoped client storage entry](https://docs.switchagents.ai/api-reference/client-storage/get-tenant+workspace-scoped-client-storage-entry.md): Retrieve an opaque key-value entry scoped to a tenant, workspace, client, namespace, and key
- [Create or update tenant+workspace-scoped client storage entry](https://docs.switchagents.ai/api-reference/client-storage/create-or-update-tenant+workspace-scoped-client-storage-entry.md): Upsert an opaque key-value entry scoped to a tenant, workspace, client, namespace, and key
- [Delete tenant+workspace-scoped client storage entry](https://docs.switchagents.ai/api-reference/client-storage/delete-tenant+workspace-scoped-client-storage-entry.md): Delete an opaque key-value entry scoped to a tenant, workspace, client, namespace, and key
- [Get tenant-scoped client storage entry](https://docs.switchagents.ai/api-reference/client-storage/get-tenant-scoped-client-storage-entry.md): Retrieve an opaque key-value entry scoped to a tenant, client, namespace, and key
- [Create or update tenant-scoped client storage entry](https://docs.switchagents.ai/api-reference/client-storage/create-or-update-tenant-scoped-client-storage-entry.md): Upsert an opaque key-value entry scoped to a tenant, client, namespace, and key
- [Delete tenant-scoped client storage entry](https://docs.switchagents.ai/api-reference/client-storage/delete-tenant-scoped-client-storage-entry.md): Delete an opaque key-value entry scoped to a tenant, client, namespace, and key
- [Get user-scoped client storage entry](https://docs.switchagents.ai/api-reference/client-storage/get-user-scoped-client-storage-entry.md): Retrieve an opaque key-value entry scoped to the authenticated user (no tenant association). User ID is derived from the auth token.
- [Create or update user-scoped client storage entry](https://docs.switchagents.ai/api-reference/client-storage/create-or-update-user-scoped-client-storage-entry.md): Upsert an opaque key-value entry scoped to the authenticated user. User ID is derived from the auth token.
- [Delete user-scoped client storage entry](https://docs.switchagents.ai/api-reference/client-storage/delete-user-scoped-client-storage-entry.md): Delete an opaque key-value entry scoped to the authenticated user. User ID is derived from the auth token.
- [Get an agent endpoint](https://docs.switchagents.ai/api-reference/eval/get-an-agent-endpoint.md): Retrieve the agent endpoint configuration for an agent. Secret fields (endpoint_credential, endpoint_headers) are redacted on this public response.
- [Create or update an agent endpoint](https://docs.switchagents.ai/api-reference/eval/create-or-update-an-agent-endpoint.md): Upsert the agent endpoint configuration (URL, model type, credentials) used by the eval worker
- [Delete an agent endpoint](https://docs.switchagents.ai/api-reference/eval/delete-an-agent-endpoint.md): Delete the agent endpoint configuration for an agent
- [Get an agent evaluation summary](https://docs.switchagents.ai/api-reference/eval/get-an-agent-evaluation-summary.md): Get the per-agent health gauge, OWASP coverage, and health trend rollup powering the Evaluations-tab summary cards
- [List agent evaluations](https://docs.switchagents.ai/api-reference/eval/list-agent-evaluations.md): List agent evaluations (evaluations attached to an agent) with optional filtering and pagination
- [Create an agent evaluation](https://docs.switchagents.ai/api-reference/eval/create-an-agent-evaluation.md): Attach an evaluation to an agent, optionally on a recurring schedule
- [Get an agent evaluation by ID](https://docs.switchagents.ai/api-reference/eval/get-an-agent-evaluation-by-id.md): Retrieve a single agent evaluation by its UUID
- [Update an agent evaluation](https://docs.switchagents.ai/api-reference/eval/update-an-agent-evaluation.md): Replace an existing agent evaluation definition
- [Delete an agent evaluation](https://docs.switchagents.ai/api-reference/eval/delete-an-agent-evaluation.md): Detach an evaluation from an agent by its UUID
- [Trigger an agent evaluation run](https://docs.switchagents.ai/api-reference/eval/trigger-an-agent-evaluation-run.md): Request an on-demand evaluation run for an agent evaluation. Returns the pre-minted run ID.
- [Clear an agent evaluation run request](https://docs.switchagents.ai/api-reference/eval/clear-an-agent-evaluation-run-request.md): Reset the run_requested latch so the agent evaluation can be triggered again
- [List evaluation runs](https://docs.switchagents.ai/api-reference/eval/list-evaluation-runs.md): List evaluation runs for a workspace with optional filtering and pagination
- [Get an evaluation run by ID](https://docs.switchagents.ai/api-reference/eval/get-an-evaluation-run-by-id.md): Retrieve a single evaluation run by its UUID
- [Cancel an evaluation run](https://docs.switchagents.ai/api-reference/eval/cancel-an-evaluation-run.md): Request cancellation of a queued or running evaluation. The eval worker stops the run and writes the terminal 'cancelled' status; the agent evaluation assignment is left in place.
- [List evaluation run results](https://docs.switchagents.ai/api-reference/eval/list-evaluation-run-results.md): List the per-item results for an evaluation run with pagination
- [List evaluations](https://docs.switchagents.ai/api-reference/eval/list-evaluations.md): List evaluations for a workspace with optional filtering and pagination
- [Create an evaluation](https://docs.switchagents.ai/api-reference/eval/create-an-evaluation.md): Create a new evaluation definition
- [Get an evaluation by ID](https://docs.switchagents.ai/api-reference/eval/get-an-evaluation-by-id.md): Retrieve a single evaluation by its UUID
- [Update an evaluation](https://docs.switchagents.ai/api-reference/eval/update-an-evaluation.md): Replace an existing evaluation definition. Built-in evaluations cannot be updated.
- [Delete an evaluation](https://docs.switchagents.ai/api-reference/eval/delete-an-evaluation.md): Delete an evaluation by its UUID. Built-in evaluations cannot be deleted.
- [List external rules](https://docs.switchagents.ai/api-reference/rules/list-external-rules.md): List externally-sourced rules with optional name filtering
- [List all rules for a workspace](https://docs.switchagents.ai/api-reference/rules/list-all-rules-for-a-workspace.md): List all rules (static + external) for a tenant workspace with optional filtering and pagination
- [Get a single rule by ID](https://docs.switchagents.ai/api-reference/rules/get-a-single-rule-by-id.md): Get a single rule by its rule_id from the unified rules table (static + external)
- [Get results from single rule](https://docs.switchagents.ai/api-reference/rules/get-results-from-single-rule.md): Get results from single rule
- [List static rules](https://docs.switchagents.ai/api-reference/rules/list-static-rules.md): List built-in static rules with optional name filtering
- [List guardrail policies](https://docs.switchagents.ai/api-reference/guardrails/list-guardrail-policies.md): List AI-SPM guardrail policies for a workspace with optional filtering and pagination
- [Create a guardrail policy](https://docs.switchagents.ai/api-reference/guardrails/create-a-guardrail-policy.md): Create a new AI-SPM guardrail policy with detector configurations for user and assistant roles
- [Get a guardrail policy by ID](https://docs.switchagents.ai/api-reference/guardrails/get-a-guardrail-policy-by-id.md): Retrieve a single AI-SPM guardrail policy by its UUID
- [Update a guardrail policy](https://docs.switchagents.ai/api-reference/guardrails/update-a-guardrail-policy.md): Replace a guardrail policy's name, description, and detector configurations
- [Delete a guardrail policy](https://docs.switchagents.ai/api-reference/guardrails/delete-a-guardrail-policy.md): Delete an AI-SPM guardrail policy by its UUID
- [Get full details for a single instance](https://docs.switchagents.ai/api-reference/fine-issues/get-full-details-for-a-single-instance.md): Retrieve full details for a single instance by its ID, including rule metadata when available
- [List issues](https://docs.switchagents.ai/api-reference/issues/list-issues.md): List issues grouped by rule_id and severity with filtering, sorting, and pagination
- [Get a single issue](https://docs.switchagents.ai/api-reference/issues/get-a-single-issue.md): Retrieve a single issue by its ID
- [List objects for an issue](https://docs.switchagents.ai/api-reference/issues/list-objects-for-an-issue.md): List objects (e.g. assets, models) affected by a specific issue with pagination
- [List details (instances) for an issue object](https://docs.switchagents.ai/api-reference/issues/list-details-instances-for-an-issue-object.md): List instance-level details for a specific object within an issue, with pagination
- [Get a single issue object detail (instance)](https://docs.switchagents.ai/api-reference/issues/get-a-single-issue-object-detail-instance.md): Retrieve a single instance record for a specific issue, object, and detail ID
- [Get all instances associated with Issue](https://docs.switchagents.ai/api-reference/issues/get-all-instances-associated-with-issue.md): Get all issues
- [Get all locations](https://docs.switchagents.ai/api-reference/locations/get-all-locations.md): List all locations for a tenant workspace
- [Tenant-grain managed-agents summary (count / tier allowance)](https://docs.switchagents.ai/api-reference/managed-agents/tenant-grain-managed-agents-summary-count-tier-allowance.md): Tenant-wide summary for the "X / Y managed agents" gauge. count is the number of distinct agents under management across the tenant (all workspaces); limit and tier are the tenant's allowance and plan, and cancel_at_period_end/current_period_end report a pending downgrade, and subscription_status is…
- [List a tenant's managed agents](https://docs.switchagents.ai/api-reference/managed-agents/list-a-tenants-managed-agents.md): Lists a tenant/workspace's managed agents for display in the UI, paginated. Reports usage only; consumers needing the tier cap read it from the billing tier endpoint. Requires the same permission as listing discovered agents (view inventory).
- [Get all current scans for a sensor type](https://docs.switchagents.ai/api-reference/scans/get-all-current-scans-for-a-sensor-type.md): Get all scans marked current for a specific sensor type
- [Get all sensor types that have ever been used](https://docs.switchagents.ai/api-reference/inventory/get-all-sensor-types-that-have-ever-been-used.md)
- [Get Agent Framework snippets](https://docs.switchagents.ai/api-reference/agent-onboarding/get-agent-framework-snippets.md): Provide available snippets for agent framework integrations across supported languages
- [Create an agent](https://docs.switchagents.ai/api-reference/agent-onboarding/create-an-agent.md): Register a new agent by name, writing its identity directly and generating a fingerprint-based ID
- [Switch Trust CLI](https://docs.switchagents.ai/switch-trust-cli/index.md): Discover, evaluate, and measure your agents on your own machine
- [Scan your agent](https://docs.switchagents.ai/switch-trust-cli/scan/getting-started.md): Prove your agents are production ready in less than 10 minutes
- [Scan results](https://docs.switchagents.ai/switch-trust-cli/scan/scan-results.md): Read findings and prove you're ready to ship
- [How scanning works](https://docs.switchagents.ai/switch-trust-cli/scan/how-scanning-works.md): Static analysis and AI reasoning, then triage, so you see real issues, not false positives
- [Examples](https://docs.switchagents.ai/switch-trust-cli/scan/scan-examples.md): Practical usage examples for Switch Trust Scan
- [Eval your agent](https://docs.switchagents.ai/switch-trust-cli/eval/getting-started.md): Get proof your agent is ready for production
- [Eval results](https://docs.switchagents.ai/switch-trust-cli/eval/eval-results.md): Read your reliability score and prove you're ready to ship
- [How evaluation works](https://docs.switchagents.ai/switch-trust-cli/eval/how-evaluation-works.md): Evaluation types, detectors, and scoring explained
- [Configuration](https://docs.switchagents.ai/switch-trust-cli/eval/eval-configuration.md): Configure models, evaluations, and test assignments
- [Examples](https://docs.switchagents.ai/switch-trust-cli/eval/eval-examples.md): Practical usage examples for Switch Trust Eval
- [Guides](https://docs.switchagents.ai/switch-trust-cli/guides/index.md): End-to-end workflows and examples
- [Scan quickstart](https://docs.switchagents.ai/switch-trust-cli/guides/scan-quickstart.md): Prove your agents are production ready in less than 10 minutes
- [CI/CD integration](https://docs.switchagents.ai/switch-trust-cli/guides/ci-cd-integration.md): Integrate switch-trust-cli into your continuous integration pipeline
- [Commands](https://docs.switchagents.ai/switch-trust-cli/reference/commands.md): Complete command reference for Switch Trust CLI
- [Built-in evaluations](https://docs.switchagents.ai/switch-trust-cli/reference/builtin-evaluations.md): Complete reference of built-in evaluations
- [Environment variables](https://docs.switchagents.ai/switch-trust-cli/reference/env-vars.md): Configure Switch Trust CLI behavior with environment variables
- [Data privacy](https://docs.switchagents.ai/legal/cli-data-privacy.md): What data Switch Trust CLI sends to LLM providers
- [Troubleshooting](https://docs.switchagents.ai/switch-trust-cli/troubleshooting/common-issues.md): Fast fixes for installation, scan, and eval
- [FAQ](https://docs.switchagents.ai/switch-trust-cli/resources/faq.md): Common questions answered
- [Switch Trust CLI changelog](https://docs.switchagents.ai/switch-trust-cli/resources/changelog.md): What's new in Switch Trust CLI

## OpenAPI Specs

- [openapi](/switch-trust/api-reference/openapi.json)