> ## Documentation Index > Fetch the complete documentation index at: https://docs.runaether.dev/llms.txt > Use this file to discover all available pages before exploring further. # Respond to a task ## OpenAPI ````yaml api-reference/openapi.v1.json POST /tasks/{taskID}/respond openapi: 3.1.0 info: title: Aether Public API version: 0.1.0 description: >- The versioned, public Aether REST API. Authenticate with an `aether_` platform API key or a session token. servers: - url: https://api.runaether.dev/v1 security: - bearerAuth: [] paths: /tasks/{taskID}/respond: post: tags: - tasks summary: Respond to a task operationId: respondToTask parameters: - in: path name: taskID required: true schema: format: uuid pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/RespondToTaskRequest' required: true responses: '202': content: application/json: schema: $ref: '#/components/schemas/RespondToTaskResponse' description: Accepted '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Bad Request '401': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unauthorized '402': content: application/json: schema: $ref: '#/components/schemas/WorkspaceRuntimeAdmissionError' description: Payment Required '403': content: application/json: schema: anyOf: - oneOf: - $ref: '#/components/schemas/ErrorResponse' - $ref: '#/components/schemas/WorkspaceRuntimeAdmissionError' - $ref: '#/components/schemas/OrgAuthorizationErrorResponse' description: Forbidden '404': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Not Found '408': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Request Timeout '409': content: application/json: schema: anyOf: - $ref: '#/components/schemas/ErrorResponse' - $ref: '#/components/schemas/TaskCreatorDeletedErrorResponse' - $ref: '#/components/schemas/TaskStalePendingInputErrorResponse' description: Conflict '413': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Request Entity Too Large '422': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unprocessable Entity '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Internal Server Error '503': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Service Unavailable components: schemas: RespondToTaskRequest: additionalProperties: false properties: client_message_id: format: uuid type: string context: $ref: '#/components/schemas/PromptContext' interaction_mode: enum: - default - plan type: string message: minLength: 1 type: string queue_for_later: type: boolean reasoning_effort: enum: - ultra - max - xhigh - high - medium - low - ultrathink - ultracode - none type: string tool_response: $ref: '#/components/schemas/RespondTaskToolResponse' required: - message type: object RespondToTaskResponse: additionalProperties: false properties: message_id: format: uuid type: string required: - message_id type: object ErrorResponse: additionalProperties: false properties: code: type: string error: minLength: 1 type: string errors: items: $ref: '#/components/schemas/ErrorDetail' type: array required: - error type: object WorkspaceRuntimeAdmissionError: additionalProperties: false properties: code: type: string error: minLength: 1 type: string org_id: format: uuid type: string tier: type: string vm_size: type: string required: - error - code - tier - vm_size - org_id type: object OrgAuthorizationErrorResponse: additionalProperties: false properties: code: enum: - org_membership_required - org_role_insufficient - org_suspended - account_deleting type: string error: minLength: 1 type: string required: - error - code type: object TaskCreatorDeletedErrorResponse: additionalProperties: false properties: code: enum: - task_creator_deleted type: string error: minLength: 1 type: string required: - error - code type: object TaskStalePendingInputErrorResponse: additionalProperties: false properties: code: enum: - stale_pending_input type: string current_tool_id: minLength: 1 type: string error: minLength: 1 type: string required: - error - code type: object PromptContext: additionalProperties: false properties: attachments: items: $ref: '#/components/schemas/Attachment' maxItems: 10 type: array files: items: $ref: '#/components/schemas/FileReference' type: array type: object RespondTaskToolResponse: oneOf: - $ref: '#/components/schemas/AskUserToolResponse' - $ref: '#/components/schemas/ProposePlanToolResponse' - $ref: '#/components/schemas/FencedAskUserToolResponse' - $ref: '#/components/schemas/FencedProposePlanToolResponse' ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object Attachment: additionalProperties: false properties: data: minLength: 1 type: string filename: minLength: 1 type: string mediaType: minLength: 1 type: string required: - filename - mediaType - data type: object FileReference: additionalProperties: false properties: include: type: boolean path: minLength: 1 type: string selection: $ref: '#/components/schemas/FileSelection' required: - path - include type: object AskUserToolResponse: additionalProperties: false properties: data: additionalProperties: false properties: answers: additionalProperties: items: format: int64 minimum: -1 type: integer type: array type: object customAnswers: additionalProperties: type: string type: object required: - answers type: object tool_name: enum: - ask_user type: string required: - tool_name - data type: object ProposePlanToolResponse: additionalProperties: false properties: data: additionalProperties: false properties: approved: type: boolean feedback: type: string required: - approved type: object tool_name: enum: - propose_plan type: string required: - tool_name - data type: object FencedAskUserToolResponse: additionalProperties: false properties: data: additionalProperties: false properties: answers: additionalProperties: items: format: int64 minimum: -1 type: integer type: array type: object customAnswers: additionalProperties: type: string type: object required: - answers type: object expected_input_digest: description: >- SHA-256 of the complete pending input encoded with Go encoding/json (UseNumber, sorted object keys, compact UTF-8, HTML escaping). Preserve original read-time input bytes and numeric lexemes. Requires expected_tool_id. Supply both preconditions to fence payload changes under a reused tool ID. pattern: ^[0-9a-f]{64}$ type: string expected_tool_id: description: >- Exact pending tool ID; checked under lock after client_message_id replay resolution. pattern: \S type: string tool_name: enum: - ask_user type: string required: - tool_name - data - expected_tool_id type: object FencedProposePlanToolResponse: additionalProperties: false properties: data: additionalProperties: false properties: approved: type: boolean feedback: type: string required: - approved type: object expected_input_digest: description: >- SHA-256 of the complete pending input encoded with Go encoding/json (UseNumber, sorted object keys, compact UTF-8, HTML escaping). Preserve original read-time input bytes and numeric lexemes. Requires expected_tool_id. Supply both preconditions to fence payload changes under a reused tool ID. pattern: ^[0-9a-f]{64}$ type: string expected_tool_id: description: >- Exact pending tool ID; checked under lock after client_message_id replay resolution. pattern: \S type: string tool_name: enum: - propose_plan type: string required: - tool_name - data - expected_tool_id type: object FileSelection: additionalProperties: false properties: endLine: format: int64 minimum: 1 type: integer startLine: format: int64 minimum: 1 type: integer required: - startLine - endLine type: object securitySchemes: bearerAuth: bearerFormat: JWT scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.