---
title: "Run Agent Team"
method: POST
path: "/agent/v1/agent-teams/{agentTeamId}/runs"
tags: ["Agent Teams"]
---

# Run Agent Team

`POST /agent/v1/agent-teams/{agentTeamId}/runs`

## Request

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

Triggers an Agent Team run. Any Agent Team can be run manually using this endpoint, even if the
Agent Team is marked with inactive.

Agent Teams run asynchronously, so this endpoint returns the Agent Team run with the id created 
and the initial run status. Poll [Get Agent Team Results](ref:agentteamscontroller_getagentteamrun)
to get status updates on the Agent Team run.

## Path parameters

- `agentTeamId` string, required

## Request body

- RunAgentTeamRequestBody: Request body for running an Agent Team.
  - `data` RunAgentTeamRequest, required: Agent Team run request resource.
    - `type` string, required: The type of the resource
    - `attributes` RunAgentTeamRequestAttributes, required: Attributes for an Agent Team run request.
      - `inputs` AgentTeamInput[]: Optional list of named input values to pass to the Agent Team.
        - `name` string, required: Name of the Agent Team input.
        - `value` string, required: Value supplied for the input.

## Response `202`

Accepted

- AgentTeamRunResponse: Response containing a single Agent Team run.
  - `data` AgentTeamRun, required: Model describing an Agent Team run
    - `id` string, required: The unique identifier for the resource
    - `type` string, required: The type of the resource
    - `attributes` AgentTeamRunAttributes, required: Attributes describing an Agent Team run
      - `agentTeamId` string, required: The unique identifier of the Agent Team associated with this run.
      - `status` 'QUEUED' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'STOPPING', required: Lifecycle states for an Agent Team run.
      - `inputs` AgentTeamInput[]: The inputs provided for this run of the Agent Team
        - `name` string, required: Name of the Agent Team input.
        - `value` string, required: Value supplied for the input.
      - `output` string: Final or in-progress output for the Agent Team run. This field is omitted for runs that have not yet produced output.
    - `meta` AgentTeamRunMeta: Metadata information for an Agent Team run
      - `createdAt` string, date-time, required: The UTC date time when the Agent Team run was created
      - `createdBy` integer, required: The id of the user that executed this Agent Team run
      - `updatedAt` string, date-time, required: The UTC date time when the Agent Team run was last updated
      - `completedAt` string, date-time: The UTC date time when the Agent Team run completed
      - `totalCredits` integer: The total number of credits consumed by this Agent Team run. This value is only provided after the Agent Team has successfully finished executing

## 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)