> ## Documentation Index > Fetch the complete documentation index at: https://docs.atollhq.com/llms.txt > Use this file to discover all available pages before exploring further. # Read the manageable local runner fleet > Human-session only. Returns one current or most recently disconnected installation for each agent the caller can manage, with safe presence, lease, project-access, heartbeat, and unambiguous execution context. Repository mappings are read from the canonical project endpoint and local paths, secrets, prompts, process IDs, and raw logs are never returned. ## OpenAPI ````yaml /openapi.json get /api/orgs/{id}/runners openapi: 3.1.0 info: title: Atoll API version: 1.0.0 description: >- REST API for Atoll project management, agent collaboration, strategy tracking, and integrations. servers: - url: https://atollhq.com description: Production security: - bearerAuth: [] tags: - name: Authentication - name: Organizations - name: Projects - name: Project access - name: Issues - name: Issue details - name: Milestones - name: Artifacts - name: Strategy - name: Members and agents - name: Planning - name: Setup - name: Integrations and billing - name: Notifications and public - name: Private inbox - name: Agent executions - name: Human attention paths: /api/orgs/{id}/runners: get: tags: - Members and agents summary: Read the manageable local runner fleet description: >- Human-session only. Returns one current or most recently disconnected installation for each agent the caller can manage, with safe presence, lease, project-access, heartbeat, and unambiguous execution context. Repository mappings are read from the canonical project endpoint and local paths, secrets, prompts, process IDs, and raw logs are never returned. operationId: get_api_orgs_id_runners parameters: - name: id in: path required: true schema: type: string description: Organization identifier responses: '200': description: Manageable runner fleet content: application/json: schema: $ref: '#/components/schemas/RunnerFleetResponse' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '500': $ref: '#/components/responses/ServerError' security: - bearerAuth: [] components: schemas: RunnerFleetResponse: type: object required: - runners properties: runners: type: array items: $ref: '#/components/schemas/RunnerFleetItem' additionalProperties: false RunnerFleetItem: type: object required: - runner - agent - project_access - heartbeat_policy_summary - current_work - execution properties: runner: $ref: '#/components/schemas/RunnerInstallation' agent: type: object required: - id - display_name - avatar_url - personal_owner_member_id - project_ids properties: id: type: string format: uuid display_name: type: - string - 'null' avatar_url: type: - string - 'null' personal_owner_member_id: type: - string - 'null' format: uuid project_ids: type: array items: type: string format: uuid additionalProperties: false project_access: type: object required: - mode - project_ids properties: mode: type: string enum: - inherited - explicit project_ids: type: array items: type: string format: uuid additionalProperties: false heartbeat_policy_summary: type: - object - 'null' additionalProperties: true current_work: oneOf: - $ref: '#/components/schemas/RunnerFleetCurrentWork' - type: 'null' execution: type: - object - 'null' additionalProperties: true additionalProperties: false Error: type: object description: >- Common error responses contain error. Shared missing-auth and unknown-API responses also contain a stable code. properties: error: type: string code: type: string required: - error examples: - error: Unauthorized code: unauthorized - error: Not found code: not_found additionalProperties: true RunnerInstallation: type: object required: - id - org_id - agent_member_id - instance_id - display_name - host_id - platform - arch - capabilities - client_version - intake_state - last_seen_at - disconnected_at - created_at - updated_at - presence_state properties: id: type: string format: uuid org_id: type: string format: uuid agent_member_id: type: string format: uuid instance_id: type: string format: uuid display_name: type: string description: Server-derived platform and architecture label host_id: type: - string - 'null' maxLength: 255 description: Server-bound host routing identity platform: type: string enum: - darwin - linux - windows arch: type: string enum: - arm64 - x64 - amd64 capabilities: type: array items: type: string enum: - codex - git client_version: type: string intake_state: type: string enum: - active - paused last_seen_at: type: string format: date-time disconnected_at: type: - string - 'null' format: date-time created_at: type: string format: date-time updated_at: type: string format: date-time presence_state: type: string enum: - connected - stale - offline additionalProperties: false RunnerFleetCurrentWork: type: object required: - lease_id - claim_kind - state - last_progress - last_error_code - expires_at - restricted - issue properties: lease_id: type: string format: uuid claim_kind: type: string enum: - issue - attention_resume state: type: string last_progress: type: - string - 'null' last_error_code: type: - string - 'null' expires_at: type: string format: date-time restricted: type: boolean issue: type: - object - 'null' additionalProperties: true additionalProperties: false responses: Unauthorized: description: Missing or invalid authentication content: application/json: schema: $ref: '#/components/schemas/Error' Forbidden: description: Authenticated but not allowed content: application/json: schema: $ref: '#/components/schemas/Error' ServerError: description: Unexpected server error content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: sk_atoll_ ````