> ## Documentation Index > Fetch the complete documentation index at: https://docs.lighton.ai/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve a single agent > Get detailed information about a specific agent (ChatSettings) by ID. Access control: Sys-admin users can access all agents from all companies. Company admin users can access all agents from their company. Regular users can only access agents linked to groups they belong to. ## OpenAPI ````yaml /api-reference/openapi-v3.yaml get /api/v3/agents/{id} openapi: 3.1.0 info: title: LightOn API version: 3.15.0 (v3) description: >- LightOn gives you an API to search, parse, and ingest documents at scale. Build knowledge-retrieval pipelines without managing vector databases or OCR models. servers: - url: https://paradigm.lighton.ai security: [] tags: - name: Agents description: Operations about agents - name: Threads description: Operations about agents conversation threads - name: Tools description: Operations about native tools - name: Models description: Operations about AI models - name: MCP description: Operations about MCP servers - name: Sources description: Operations about sources used by agents conversation threads - name: Artifacts description: Operations about artifacts generated by agents conversation threads - name: Agent description: >- Operations about agents (deprecated). Please use the 'Agents' API component instead. - name: Files description: Operations about files - name: Facets description: Operations about facets - name: Tags description: Operations about tags - name: Workspaces description: Operations about workspaces - name: Files Processing description: Operations about files processing - name: Users description: Operations about users - name: API Keys description: Operations about API keys - name: User Groups description: Operations about user groups - name: SCIM description: Operations about SCIM paths: /api/v3/agents/{id}: get: tags: - Agents summary: Retrieve a single agent description: >- Get detailed information about a specific agent (ChatSettings) by ID. Access control: Sys-admin users can access all agents from all companies. Company admin users can access all agents from their company. Regular users can only access agents linked to groups they belong to. operationId: api_v3_agents_retrieve parameters: - in: path name: id schema: type: integer description: ID of the agent to retrieve required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/AgentSchema' description: '' '404': content: application/json: schema: description: Agent not found or not accessible description: '' '503': description: >- API is under maintenance. Check `GET /api/v3/system/status` for active periods and retry. content: application/json: schema: $ref: '#/components/schemas/ServiceMaintenance503' security: - bearerAuth: [] components: schemas: AgentSchema: type: object properties: id: type: integer name: type: string description: type: - string - 'null' instructions: type: - string - 'null' company: $ref: '#/components/schemas/CompanySchema' group: $ref: '#/components/schemas/GroupSchema' workspaces: type: array items: $ref: '#/components/schemas/WorkspaceSchema' tools: $ref: '#/components/schemas/AgentToolsSchema' is_default: type: boolean ownership: type: string scope_workspaces_by_group: type: boolean scoped_workspace_ids: type: array items: type: integer ml_model: type: - string - 'null' format: uuid ml_model_alias: type: - string - 'null' format: uuid is_current_user_favorite: type: boolean created_at: type: string format: date-time updated_at: type: string format: date-time required: - company - created_at - description - group - id - instructions - is_current_user_favorite - is_default - ml_model - ml_model_alias - name - ownership - scope_workspaces_by_group - scoped_workspace_ids - tools - updated_at - workspaces ServiceMaintenance503: type: object description: >- Returned by the maintenance middleware when the requested endpoint is blocked. required: - detail - error - mode properties: detail: type: string example: System is under maintenance. error: type: string example: service_maintenance mode: type: string enum: - full_shutdown - warning_banner description: >- `full_shutdown` blocks all traffic; `warning_banner` also blocks and shows a dismissible toast. reason: type: string description: Operator-supplied maintenance reason, if any. started_at: type: string format: date-time endpoint_category_names: type: array items: type: string description: >- Non-empty only for category-scoped periods. Empty means all endpoints are affected. CompanySchema: type: object properties: id: type: integer name: type: string allow_ephemeral_mode: type: boolean is_sharing_enabled: type: boolean required: - allow_ephemeral_mode - id - is_sharing_enabled - name GroupSchema: type: object properties: name: type: string id: type: integer required: - id - name WorkspaceSchema: type: object properties: id: type: integer name: type: string category: type: string file_count: type: integer summaries: type: array items: $ref: '#/components/schemas/WorkspaceSummarySchema' default: [] required: - category - file_count - id - name AgentToolsSchema: type: object properties: native: type: array items: $ref: '#/components/schemas/NativeToolSchema' mcp_servers: type: array items: $ref: '#/components/schemas/MCPServerSchema' required: - mcp_servers - native WorkspaceSummarySchema: type: object properties: language: type: string summary: type: string required: - language - summary NativeToolSchema: type: object properties: id: type: string name: type: string object: type: string default: tool required: - id - name MCPServerSchema: type: object properties: id: type: string name: type: string object: type: string default: mcp_server required: - id - name securitySchemes: bearerAuth: type: http scheme: bearer description: >- Bearer authentication header of the form `Bearer `, where `` is your auth token. ````