---
title: "Get Agent Team Details"
method: GET
path: "/agent/v1/agent-teams/{agentTeamId}"
tags: ["Agent Teams"]
---

# Get Agent Team Details

`GET /agent/v1/agent-teams/{agentTeamId}`

## Request

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

Fetch an Agent Team by id, returning the full Agent Team details. The Agent Team details include configured input
parameters that are required when executing an Agent Team using the [Run Agent Team](ref:agentteamscontroller_runagentteam) endpoint.

Use [List Agent Teams](ref:agentteamscontroller_listagentteams) to find an Agent Team if you don't already know the identifier
you are looking to get details for.

## Path parameters

- `agentTeamId` string, required

## Response `200`

Success

- AgentTeamDetailResponse: Response for a single Agent Team with input parameter details
  - `data` AgentTeamDetail, required: Agent Team resource with full input parameter details.
    - `id` string, required: The unique identifier for the resource
    - `type` string, required: The type of the resource
    - `attributes` AgentTeamDetailAttributes, required: Public Agent Team details.
      - `name` string, required: Name of the Agent Team.
      - `description` string: Human-readable description of the Agent Team. This field is omitted when no objective or description is defined.
      - `triggers` AgentTeamTriggerType[], required: The trigger types associated with this Agent Team
      - `active` boolean, required: Flag indicating whether the Agent Team's triggers are active or not. Agent Teams that are inactive can still be triggered manually
      - `tags` string[]: The names of the tags associated with this Agent Team.
      - `inputs` InputParameter[]: The input parameters defined for this Agent Team.
        - `name` string, required: The name of the input parameter. This will be provided in the `name` attribute for the `RunAgentTeamRequest`
        - `required` boolean, required: Indicates whether the parameter is required to start the Agent Team run
        - `type` 'STRING', required
    - `meta` AgentTeamMeta: Metadata information for an Agent Team
      - `createdAt` string, date-time, required: The timestamp when this Agent Team was created
      - `createdBy` integer, required: The id of the user that created this Agent Team
      - `updatedAt` string, date-time, required: The timestamp for the last time this Agent Team was updated
      - `creditsUsed` integer, required: The total amount of AI Credits consumed by this Agent Team over its lifespan
      - `lastRunDate` string, date-time: The date of the last successful run of this Agent Team

## Other responses

- `400`: Bad Request
- `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)