> ## 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. # Register or refresh the authenticated agent runner > Agent-only self route. A different recent installation for the same agent returns 409; an installation silent for 10 minutes can be taken over. Refreshes are limited to 60 per agent per minute. ## OpenAPI ````yaml /openapi.json put /api/orgs/{id}/runners/self 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/self: put: tags: - Members and agents summary: Register or refresh the authenticated agent runner description: >- Agent-only self route. A different recent installation for the same agent returns 409; an installation silent for 10 minutes can be taken over. Refreshes are limited to 60 per agent per minute. operationId: put_api_orgs_id_runners_self parameters: - name: id in: path required: true schema: type: string description: Organization identifier requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/RunnerInstallationInput' responses: '200': description: Runner installation registered content: application/json: schema: $ref: '#/components/schemas/RunnerInstallationResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '409': description: Another recent runner installation is active for this agent content: application/json: schema: type: object required: - error - code properties: error: type: string code: type: string enum: - RUNNER_INSTALLATION_CONFLICT additionalProperties: false '429': description: Runner presence refresh rate limit exceeded headers: Retry-After: schema: type: integer content: application/json: schema: type: object required: - error - code - retryAfterSeconds - limit - currentCount properties: error: type: string code: type: string enum: - RATE_LIMITED retryAfterSeconds: type: integer minimum: 1 limit: type: integer minimum: 1 currentCount: type: integer minimum: 1 additionalProperties: false '500': $ref: '#/components/responses/ServerError' '503': description: Runner presence rate limit check failed content: application/json: schema: type: object required: - error - code properties: error: type: string code: type: string enum: - RATE_LIMIT_CHECK_FAILED additionalProperties: false security: - bearerAuth: [] components: schemas: RunnerInstallationInput: type: object description: >- Strict agent-only runner registration body. Organization and agent member IDs are derived from authentication. required: - instanceId - platform - arch - capabilities - clientVersion properties: instanceId: type: string format: uuid hostId: type: string minLength: 1 maxLength: 255 platform: type: string enum: - darwin - linux - windows arch: type: string enum: - arm64 - x64 - amd64 capabilities: type: array maxItems: 2 uniqueItems: true items: type: string enum: - codex - git clientVersion: type: string pattern: ^[0-9]{1,5}\.[0-9]{1,5}\.[0-9]{1,5}$ additionalProperties: false RunnerInstallationResponse: type: object required: - runner properties: runner: oneOf: - $ref: '#/components/schemas/RunnerInstallation' - type: 'null' additionalProperties: false 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 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 responses: BadRequest: description: Invalid request content: application/json: schema: $ref: '#/components/schemas/Error' 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_ ````