---
title: "Get Agent Details"
method: GET
path: "/agent/v1/agents/{agentId}"
tags: ["Agents"]
---

# Get Agent Details

`GET /agent/v1/agents/{agentId}`

## Request

- Base URL: `https://api.zoominfo.com/gtm`
- URL: `https://api.zoominfo.com/gtm/agent/v1/agents/{agentId}`
- Auth: OAuth 2
  - Authorization code: `https://login.zoominfo.com`
  - Token URL: `https://okta-login.zoominfo.com/oauth2/default/v1/token` scopes: `api:agent:read`

Retrieves the full details for a specific agent, including the inputs
required to run it. Call this endpoint before starting a run. The expected
input is defined in `inputSchema`, which describes the message parts the
agent accepts, such as `text` or structured `data`, and whether each part is
required.

For structured input, the `schema` defines the payload that must be provided
in the corresponding `data` part of
[Start Agent Run](ref:agentscontroller_startagentrun). `inputSchema` is
returned only by this endpoint and is not included in
[List Agents](ref:agentscontroller_listagents). It is omitted when the agent
does not define an input contract.

## Path parameters

- `agentId` string, required

## Response `200`

Success

- AgentDetailResponse: Response containing a single agent's full details.
  - `data` AgentDetail, required: An agent catalog entry with full input contract and trigger metadata.
    - `id` string, required: The unique identifier for the resource
    - `type` string, required: The type of the resource
    - `attributes` AgentDetailAttributes, required: Full agent detail: everything from the list entry plus the declared input contract and trigger metadata.
      - `name` string, required: Display name of the agent.
      - `description` string, required: What the agent does.
      - `version` string: Semantic version of the agent definition. Omitted when the owning runtime does not version its agents.
      - `iconUrl` string, uri: URL of the agent's icon image.
      - `active` boolean, required: Whether the agent is currently active and runnable.
      - `managedBy` 'ZOOMINFO' | 'TENANT', required: Who operates the agent. ZoomInfo-managed agents are available to every eligible tenant; tenant agents (customer-built Agent Teams) are visible only within the owning tenant.
      - `tags` string[]: Tags assigned to the agent. Customer-assigned for tenant agents; curated defaults for ZoomInfo-managed agents.
      - `capabilities` AgentCapabilities, required: Execution capabilities declared by the agent.
        - `executionModes` AgentExecutionMode[], required: Execution modes this agent supports; each maps to an invocation endpoint.
        - `defaultInputModes` string[], required: MIME types accepted as run input.
        - `defaultOutputModes` string[], required: MIME types the agent can produce.
        - `interactive` boolean: OPTIONAL. Whether the agent can pause awaiting input (`TASK_STATE_INPUT_REQUIRED` / `TASK_STATE_AUTH_REQUIRED`) and be resumed by a follow-up run that sets `taskId`. `false` or absent (the case for every agent today) means runs are single-shot.
      - `inputSchema` AgentPartSchema[]: This agent's declared input contract: an ARRAY of part schemas mirroring the run message's parts. A chat agent declares exactly [{kind: "text", required: true}]; an agent with structured input adds a data entry whose `schema` types that part's payload; an Agent Team declares one required data entry (Teams take no text part). ABSENT means no declared contract. Validated before a run is created -- see Start Agent Run.
        - `kind` 'text' | 'data' | 'file', required: Which part this entry declares: text | data | file.
        - `required` boolean: Whether a part of this kind must be present. Defaults to false.
        - `description` string: Field help for consoles and adapters (e.g. the prompt's placeholder).
        - `schema` object: Data entries only: one standard JSON Schema (draft 2020-12) over the data part's payload -- the structured argument object for THIS agent. Plain JSON Schema, so standard validators and form generators apply directly.
      - `triggerType` 'MANUAL' | 'SCHEDULED', required: How runs of this agent are initiated.
      - `scheduledDate` string, date-time: Next scheduled occurrence; present only when `triggerType` is `SCHEDULED`.
    - `meta` AgentMeta: Audit metadata for an agent catalog entry. Creator/modifier fields are present for tenant agents only.
      - `createdAt` string, date-time: When the agent was created.
      - `updatedAt` string, date-time: When the agent definition last changed.
      - `createdBy` string: User id that created the agent (tenant agents).
      - `modifiedBy` string: User id that last modified the agent (tenant agents).

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests

---

[API](https://skmtc.dev/zoominfo/apis/agent-api-v1.md) - [All operations](https://skmtc.dev/zoominfo/apis/agent-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/zoominfo/apis/agent-api-v1/revisions/01784a5ae274?raw)