---
title: "Set A2A Exposure"
method: PUT
path: "/api/agents/{agent_id}/a2a-exposure"
tags: ["agents"]
---

# Set A2A Exposure

`PUT /api/agents/{agent_id}/a2a-exposure`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/agents/{agent_id}/a2a-exposure`
- Auth: none declared

Publish this agent on the public A2A surface, or withdraw it.

Gated on config authority, not mere visibility: turning this on makes the
agent reachable by any authenticated external A2A caller, and its turns are
billed to its owner by default. Only someone who can configure the agent
may make that call.

## Path parameters

- `agent_id` string, uuid, required

## Headers

- `x-impersonate-identity-id` string, nullable

## Request body

- A2AExposureUpdate
  - `a2a_exposed` boolean, nullable
  - `mcp_exposed` boolean, nullable
  - `mcp_allowed_tools` string[], nullable
  - `mcp_allowed_record_collections` string[], nullable

## Response `200`

Successful Response

- A2AExposureResponse
  - `a2a_exposed` boolean, required
  - `mcp_exposed` boolean, required
  - `agent_card_url` string, nullable
  - `mcp_url` string, nullable
  - `mcp_allowed_tools` string[]
  - `mcp_allowed_record_collections` string[]

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thinqos/apis/thinqos-api.md) · [All operations](https://skmtc.dev/thinqos/apis/thinqos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thinqos/apis/thinqos-api/revisions/5387b4ded614?raw)