> ## Documentation Index > Fetch the complete documentation index at: https://docs.maia.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get agent details > Retrieves details for a specific agent ## OpenAPI ````yaml /openapi/public-api-endpoint-reference.yaml get /v1/agents/{agentId} openapi: 3.1.0 info: title: Maia Public REST API version: '1.0' servers: - description: EU1 url: https://eu1.api.matillion.com/dpc - description: US1 url: https://us1.api.matillion.com/dpc security: - bearerAuth: [] tags: - description: Manage Schedules name: Schedules - description: Manage Connections name: Connections - description: Operations for managing Project Variables name: Project Variables - description: Manage Pipelines name: Pipelines - description: Review pipelines against quality rules name: Pipeline Quality Review - description: Execute tests within a project name: Test Execution - description: Manage your AI agent tasks name: AI Agent Tasks - description: SCIM endpoints for user/group permission management name: Directory Integration - description: Publish shared pipeline artifacts name: Shared Pipeline Artifacts - description: Manage Repositories name: Repositories - description: Report on Credit Consumption name: Consumption - description: Manage Artifacts name: Artifacts - description: Operations for data lineage and governance name: Data Lineage - description: Manage Streaming Pipelines name: Streaming Pipelines - description: Execute a pipeline name: Pipeline Execution - description: '' name: Environments - description: '' name: Projects - description: Manage Agents name: Agents - description: Operations for managing Environment-level Overrides of Project Variables name: Project Variable Environment Overrides - description: Query audit events name: Audit Events - description: Connector Profiles name: Connectors paths: /v1/agents/{agentId}: get: tags: - Agents summary: Get agent details description: Retrieves details for a specific agent operationId: getAgent parameters: - description: The ID of the agent to retrieve in: path name: agentId required: true schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/AgentInfo' description: Success '400': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' example: type: https://api.matillion.com/problems/bad-request title: Bad Request status: 400 detail: Failed to read request. Please check your request body. instance: /v1/agents/{agentId} description: Wrong request parameters used '403': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' example: type: https://api.matillion.com/problems/forbidden title: Forbidden status: 403 detail: You do not have permission to access this resource. instance: /v1/agents/{agentId} description: Forbidden '404': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' example: type: https://api.matillion.com/problems/not-found title: Not Found status: 404 detail: The requested agent does not exist. instance: /v1/agents/{agentId} description: Agent not found '500': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' example: type: https://api.matillion.com/problems/internal-server-error title: Internal Server Error status: 500 detail: Unexpected error occurred while processing the request. instance: /v1/agents/{agentId} description: Unexpected error occurred components: schemas: AgentInfo: type: object properties: agentId: type: string description: The ID of the Agent example: 3fa85f64-5717-4562-b3fc-2c963f66afa6 agentStatus: type: string description: The reported status of the Agent example: running agentType: type: string description: The type of Agent example: data_productivity_cloud cloudProvider: type: string description: The cloud provider the Agent is hosted in example: aws connected: type: boolean description: Whether the Agent is connected example: true deployment: type: string description: The deployment type of the Agent example: fargate description: type: string description: The description set for the Agent example: An AWS Agent enableAutoUpdates: type: boolean description: Whether the Agent is set to automatically update example: true name: type: string description: The name of the Agent example: AWS Agent pausedUntil: type: string description: >- The date and time the Agent will be unpaused automatically. Only returned if the Agent is currently paused example: '2025-01-01T00:00:00.000Z' restrictedAccess: type: boolean description: Whether the Agent is restricted to a specific set of projects example: true versionDetails: $ref: '#/components/schemas/VersionDetails' description: The version details of the Agent ProblemDetail: type: object properties: detail: type: string instance: type: string status: type: integer format: int32 title: type: string type: type: string format: uri violations: type: array items: type: string VersionDetails: type: object properties: agentUpdateAvailable: type: boolean description: Whether an update is available for the agent example: false agentVersion: type: string description: The reported version of the agent example: 1.0.0 support: type: string description: Whether the agent is supported or unsupported enum: - SUPPORTED - UNSUPPORTED example: SUPPORTED trackName: type: string description: The name of the version track the Agent is on example: current trackReleaseDate: type: string description: The date the latest version of the version track was released example: '2025-01-01T00:00:00.000Z' trackVersion: type: string description: The latest version of the version track the agent is on example: 1.0.0 securitySchemes: bearerAuth: bearerFormat: JWT description: a valid bearer token scheme: bearer type: http ````