> ## Documentation Index > Fetch the complete documentation index at: https://docs.monaco.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a Task > Gets a single task by its `task_id`. ## OpenAPI ````yaml https://api.monaco.com/openapi.json get /v1/tasks/{task_id} openapi: 3.1.0 info: title: Monaco Public API description: Public API for Monaco version: 1.0.0 servers: - url: https://api.monaco.com security: [] paths: /v1/tasks/{task_id}: get: tags: - Tasks summary: Get a Task description: Gets a single task by its `task_id`. operationId: get_task parameters: - name: task_id in: path required: true schema: type: string format: uuid title: Task Id responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PublicItemResponse_TaskResponse_' example: data: id: tsk_abc123 account_id: acc_def456 opportunity_id: opp_ghi789 title: Send follow-up proposal description: Send the updated pricing proposal to the procurement team task_type: General Action Item assignee: id: usr_abc123 first_name: Jane last_name: Smith status: Done due_at: '2025-07-01T17:00:00Z' completed_at: '2025-06-28T11:00:00Z' created_at: '2025-06-15T10:30:00Z' updated_at: '2025-06-28T11:00:00Z' message_draft: recipients: - name: Jane Smith email: jane@acme.com cc: - name: John Doe email: john@acme.com subject: Pricing follow-up body: Hi Jane, following up on the proposal we discussed... meta: timestamp: '2026-04-21T12:00:00Z' 4XX: description: Client error content: application/json: schema: $ref: '#/components/schemas/PublicErrorResponse' components: schemas: PublicItemResponse_TaskResponse_: properties: data: $ref: '#/components/schemas/TaskResponse' meta: $ref: '#/components/schemas/ResponseMeta' type: object required: - data title: PublicItemResponse[TaskResponse] PublicErrorResponse: properties: error: $ref: '#/components/schemas/ErrorDetail' type: object required: - error title: PublicErrorResponse TaskResponse: properties: id: type: string title: Id description: Unique identifier for the task examples: - tsk_abc123 account_id: anyOf: - type: string - type: 'null' title: Account Id description: ID of the associated account examples: - acc_def456 opportunity_id: anyOf: - type: string - type: 'null' title: Opportunity Id description: ID of the associated opportunity examples: - opp_ghi789 title: anyOf: - type: string - type: 'null' title: Title description: Title of the task examples: - Send follow-up proposal description: anyOf: - type: string - type: 'null' title: Description description: Detailed description of the task examples: - Send the updated pricing proposal to the procurement team task_type: anyOf: - type: string - type: 'null' title: Task Type description: Type of task examples: - General Action Item assignee: anyOf: - $ref: '#/components/schemas/OwnerInfo' - type: 'null' description: User assigned to the task status: anyOf: - type: string - type: 'null' title: Status description: Current status of the task examples: - To Do due_at: anyOf: - type: string format: date-time - type: 'null' title: Due At description: Due date and time for the task examples: - '2025-07-01T17:00:00Z' completed_at: anyOf: - type: string format: date-time - type: 'null' title: Completed At description: Date and time the task was completed examples: - '2025-06-28T11:00:00Z' created_at: type: string format: date-time title: Created At description: Date and time the task was created examples: - '2025-06-15T10:30:00Z' updated_at: type: string format: date-time title: Updated At description: Date and time the task was last updated examples: - '2025-06-16T10:30:00Z' message_draft: anyOf: - $ref: '#/components/schemas/MessageDraft' - type: 'null' description: >- Draft message contents. Populated on single-task GET and create/update responses for `task_type=EMAIL`; always omitted from list responses. type: object required: - id - created_at - updated_at title: TaskResponse ResponseMeta: properties: timestamp: type: string format: date-time title: Timestamp description: Server timestamp of the response type: object title: ResponseMeta ErrorDetail: properties: code: type: string title: Code description: Machine-readable error code examples: - not_found message: type: string title: Message description: Human-readable error message examples: - Resource not found type: object required: - code - message title: ErrorDetail OwnerInfo: properties: id: type: string title: Id description: Unique identifier of the user examples: - usr_abc123 first_name: anyOf: - type: string - type: 'null' title: First Name description: First name of the user examples: - Jane last_name: anyOf: - type: string - type: 'null' title: Last Name description: Last name of the user examples: - Smith type: object required: - id title: OwnerInfo MessageDraft: properties: recipients: items: $ref: '#/components/schemas/EmailRecipient' type: array title: Recipients description: Primary recipients (To) of the email cc: anyOf: - items: $ref: '#/components/schemas/EmailRecipient' type: array - type: 'null' title: Cc description: Carbon-copy recipients of the email subject: type: string title: Subject description: Subject line of the email examples: - Pricing follow-up body: type: string title: Body description: Body of the email (plain text or HTML) examples: - Hi Jane, following up on the proposal we discussed... sent_at: anyOf: - type: string - type: 'null' title: Sent At description: ISO timestamp the email was sent (read-only; ignored on write). type: object required: - recipients - subject - body title: MessageDraft description: Draft message contents stored on a task with `task_type=EMAIL`. EmailRecipient: properties: name: type: string title: Name description: Display name of the recipient examples: - Jane Smith email: type: string title: Email description: Email address of the recipient examples: - jane@acme.com type: object required: - name - email title: EmailRecipient ````