> ## Documentation Index > Fetch the complete documentation index at: https://docs.threetone.in/llms.txt > Use this file to discover all available pages before exploring further. # List agent deployments > List the traffic split history of an agent, newest first ## OpenAPI ````yaml /api-reference/openapi.json get /v1/convai/agents/{agent_id}/deployments openapi: 3.1.0 info: title: Threetone API description: >- APIs for the Threetone Agents Platform and shared workspace resources. Authenticate programmatic requests with an API key in the x-api-key header. version: '1.0' servers: - url: https://api.threetone.in description: Production security: [] paths: /v1/convai/agents/{agent_id}/deployments: get: tags: - Agents Platform summary: List agent deployments description: List the traffic split history of an agent, newest first operationId: list_agent_deployments_route parameters: - name: agent_id in: path required: true schema: type: string description: The id of an agent. This is returned on agent creation. examples: - agent_3701k3ttaq12ewp8b7qv5rfyszkz embed: true title: Agent Id description: The id of an agent. This is returned on agent creation. - name: page in: query required: false schema: type: integer minimum: 1 description: Page number, starting at 1 default: 1 title: Page description: Page number, starting at 1 - name: page_size in: query required: false schema: type: integer maximum: 100 minimum: 1 description: How many results at most should be returned default: 30 title: Page Size description: How many results at most should be returned - name: x-api-key in: header required: false schema: anyOf: - type: string - type: 'null' description: >- Your API key for programmatic access. Send it in the x-api-key header; you can create and manage keys from the Developers page. title: X-Api-Key description: >- Your API key for programmatic access. Send it in the x-api-key header; you can create and manage keys from the Developers page. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ListResponse_AgentDeploymentHistoryItem_' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: ListResponse_AgentDeploymentHistoryItem_: properties: meta: $ref: '#/components/schemas/ListResponseMeta' default: {} results: items: $ref: '#/components/schemas/AgentDeploymentHistoryItem' type: array title: Results type: object required: - results title: ListResponse[AgentDeploymentHistoryItem] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ListResponseMeta: properties: total: anyOf: - type: integer - type: 'null' title: Total page: anyOf: - type: integer - type: 'null' title: Page page_size: anyOf: - type: integer - type: 'null' title: Page Size type: object title: ListResponseMeta AgentDeploymentHistoryItem: properties: id: type: string title: Id description: ID of the deployment traffic_percentage_branch_id_map: additionalProperties: type: number type: object title: Traffic Percentage Branch Id Map description: Map of branch IDs to traffic percentages examples: - agtbrch_8901k4t9z5defmb8vh3e9361y7nj: 50 deployed_at_unix_secs: type: integer title: Deployed At Unix Secs description: Unix timestamp of when the traffic split was applied is_active: type: boolean title: Is Active description: Whether this is the live traffic split source: anyOf: - $ref: '#/components/schemas/AgentDeploymentSource' - type: 'null' description: >- What caused this traffic split change. Null for deployments created before this was recorded. access_info: anyOf: - $ref: '#/components/schemas/ResourceAccessInfo' - type: 'null' description: Access information for the deployment, including who created it type: object required: - id - deployed_at_unix_secs - is_active title: AgentDeploymentHistoryItem ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError AgentDeploymentSource: type: string enum: - manual - branch_merge - duplicate title: AgentDeploymentSource ResourceAccessInfo: properties: is_creator: type: boolean title: Is Creator description: Whether the user making the request is the creator of the agent creator_name: type: string title: Creator Name description: Name of the agent's creator creator_email: type: string title: Creator Email description: Email of the agent's creator role: type: string enum: - admin - editor - commenter - viewer title: Role description: The role of the user making the request anonymous_access_level_override: anyOf: - type: string enum: - admin - editor - commenter - viewer - type: 'null' title: Anonymous Access Level Override description: >- The access level for anonymous users. If None, the resource is not shared publicly. access_source: anyOf: - type: string enum: - creator - explicit - workspace_admin - workspace_default - type: 'null' title: Access Source description: >- Why the requesting user has access to this resource. 'creator' = caller is the owner. 'explicit' = caller (or one of their workspace groups) is listed in role_to_group_ids beyond the workspace-wide everyone group. 'workspace_default' = the workspace-wide everyone group is listed in role_to_group_ids (every non-anon workspace member, including admins, sees this resource). 'workspace_admin' = caller is a workspace admin and the admin seat is the *only* path to access; reserved for docs nobody else can see. Lets the UI disclose why an admin-bypass viewer sees a doc that wasn't explicitly shared with them. type: object required: - is_creator - creator_name - creator_email - role title: ResourceAccessInfo example: access_source: creator creator_email: john.doe@example.com creator_name: John Doe is_creator: true role: admin ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.