> ## Documentation Index > Fetch the complete documentation index at: https://developers.conveyour.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a task > Returns one task, with related-record detail attached. ## OpenAPI ````yaml /api-reference/specs/tasks.json get /api/tasks/{id} openapi: 3.1.0 info: title: ConveYour API — Tasks description: >- Actionable items. Two separate resources: org-level tasks assigned to users or teams, and contact-level tasks attached to an individual contact. version: 1.0.0 servers: - url: https://{subdomain}.conveyour.com description: Your organization's ConveYour instance variables: subdomain: default: acme description: >- Your organization's slug — the subdomain you sign in on. Replace `acme` with yours: if you sign in at `bigco.conveyour.com`, enter `bigco`. security: - conveyourToken: [] paths: /api/tasks/{id}: get: tags: - Tasks summary: Get a task description: Returns one task, with related-record detail attached. operationId: getTask parameters: - name: id in: path required: true schema: type: string description: The task ID. - $ref: '#/components/parameters/teams' responses: '200': description: Success. content: application/json: schema: allOf: - $ref: '#/components/schemas/Envelope' - type: object properties: data: $ref: '#/components/schemas/TaskFull' '403': description: >- Forbidden — the token is missing, expired, or not permitted for this HTTP method. **These endpoints enforce no named permission**, so a 403 here never carries a `permission` field. '404': description: Not found. components: parameters: teams: name: teams[] in: query description: >- Team scope for the request, as one or more team ObjectIds. The brackets are required: PHP keeps only the last value for a repeated plain key, so `teams=A&teams=B` silently resolves to B alone. On requests with a JSON body you may send `teams` (no brackets) in the body instead. **Values that are not valid ObjectIds are silently ignored** — a mistyped team ID behaves as if no team was sent. See the [teams section of the API conventions guide](/guides/api-conventions#team-scoping). style: form explode: true schema: type: array items: type: string example: - 64a1b2c3d4e5f6a7b8c9d0ff schemas: Envelope: type: object description: The common response envelope shared by all ConveYour endpoints. properties: status: type: string enum: - ok - failed description: '`ok` on success, `failed` on error.' message: type: string description: Human-readable description of the result. data: description: >- The response payload — an object or an array depending on the endpoint. TaskFull: allOf: - $ref: '#/components/schemas/Task' - type: object description: >- Single-record reads and updates add related-record detail via formatModelFull(). Only records that still exist are included — a related record that has been deleted is silently dropped from both arrays. properties: related_records: type: array items: type: string description: One `ClassName@ObjectId` key per surviving related record. related_record_summary: type: array items: type: object description: >- Populated **only for related Triggers**. For any other related record type getModelSummary() returns an empty object, so expect `{}` entries in this array. properties: id: type: string description: Trigger ID. type: type: string enum: - trigger description: Always `trigger` when populated. title: type: string description: The trigger name. related_record_key: type: string description: The `ClassName@ObjectId` key for this record. trigger_type: type: string description: The trigger type. campaign_id: type: string description: Campaign the trigger belongs to. description: >- One entry per surviving related record, positionally matching `related_records`. Only Trigger records produce fields; others are `{}`. Task: type: object description: An org-level task. properties: id: type: string description: Task ID. org_id: type: integer description: Owning organization. name: type: string description: Task name. Required. status: type: string enum: - not_started - planning - todo - doing - reviewing - ready - done default: not_started description: Workflow status. Defaults to not_started. body: type: string description: Task body. Stored as HTML. assigned_to: type: array items: type: integer description: User IDs assigned to the task. related_records: type: array items: type: string description: >- Related record keys in the form `ClassName@ObjectId`, e.g. `Trigger@5aa705061c337a665c8b457c`. Note these cannot be saved on create; send them in a follow-up update. resources: type: array items: type: object properties: type: type: string enum: - url description: Resource type. value: type: string description: Resource value. description: Other resources attached to the task. slug: type: string description: Slug. Hidden in the UI; unique per team. meta: type: object description: Arbitrary metadata. Hidden in the UI. created_at: type: string description: Creation timestamp. updated_at: type: string description: Last update timestamp. required: - name securitySchemes: conveyourToken: type: apiKey in: header name: x-conveyour-token description: >- Your API key token. Contacts endpoints require a **Server-only — Full API** key — see [Authentication](/quickstart). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.