> ## Documentation Index > Fetch the complete documentation index at: https://ago.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # List Tasks > List tasks, most recently updated first. Archived tasks are excluded unless `include_archived=true`. Paginate with `next_cursor`. Sort with `updated`, `created`, `deadline`, `priority`, or `manual` (board order). ## OpenAPI ````yaml /openapi-v1.json get /api/v1/tasks openapi: 3.1.0 info: title: AGO Public API version: 1.0.0 description: Programmatic access to your AGO workspace. servers: - url: https://{tenant_id}.api.useago.com description: AGO Public API v1 variables: tenant_id: default: your-tenant-id description: Your AGO tenant identifier security: [] paths: /api/v1/tasks: get: tags: - Tasks summary: List Tasks description: >- List tasks, most recently updated first. Archived tasks are excluded unless `include_archived=true`. Paginate with `next_cursor`. Sort with `updated`, `created`, `deadline`, `priority`, or `manual` (board order). operationId: list_tasks parameters: - in: query name: queue schema: anyOf: - type: string - type: 'null' description: mine, review, unowned, or all title: Queue required: false description: mine, review, unowned, or all - in: query name: owner schema: anyOf: - type: string - type: 'null' description: me, none, or a user id (comma-separate several) title: Owner required: false description: me, none, or a user id (comma-separate several) - in: query name: status schema: anyOf: - type: string - type: 'null' description: Status keys, comma-separated title: Status required: false description: Status keys, comma-separated - in: query name: category schema: anyOf: - type: string - type: 'null' description: todo, in_progress, done, canceled (comma-separated) title: Category required: false description: todo, in_progress, done, canceled (comma-separated) - in: query name: label_id schema: anyOf: - type: string - type: 'null' description: Label ids or none, comma-separated title: Label Id required: false description: Label ids or none, comma-separated - in: query name: priority schema: anyOf: - type: string - type: 'null' title: Priority required: false - in: query name: source schema: anyOf: - type: string - type: 'null' title: Source required: false - in: query name: due_before schema: anyOf: - format: date type: string - type: 'null' title: Due Before required: false - in: query name: due_after schema: anyOf: - format: date type: string - type: 'null' title: Due After required: false - in: query name: overdue schema: anyOf: - type: boolean - type: 'null' title: Overdue required: false - in: query name: q schema: anyOf: - type: string - type: 'null' description: >- Case-insensitive match on the title, or a task identifier such as TASK-12 title: Q required: false description: >- Case-insensitive match on the title, or a task identifier such as TASK-12 - in: query name: include_archived schema: default: false title: Include Archived type: boolean required: false - in: query name: archived_only schema: default: false title: Archived Only type: boolean required: false - in: query name: show_all schema: default: false title: Show All type: boolean required: false - in: query name: conversation_id schema: anyOf: - format: uuid type: string - type: 'null' title: Conversation Id required: false - in: query name: ticket_id schema: anyOf: - format: uuid type: string - type: 'null' title: Ticket Id required: false - in: query name: feedback_id schema: anyOf: - format: uuid type: string - type: 'null' title: Feedback Id required: false - in: query name: message_id schema: anyOf: - format: uuid type: string - type: 'null' title: Message Id required: false - in: query name: knowledge_update_request_id schema: anyOf: - format: uuid type: string - type: 'null' title: Knowledge Update Request Id required: false - in: query name: sort schema: default: updated title: Sort type: string required: false - in: query name: cursor schema: anyOf: - type: string - type: 'null' title: Cursor required: false - in: query name: limit schema: default: 50 title: Limit type: integer required: false responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TaskListOut' security: - ScopedAPIKeyAuth: [] components: schemas: TaskListOut: properties: object: default: list title: Object type: string data: items: $ref: '#/components/schemas/TaskOut' title: Data type: array has_more: title: Has More type: boolean next_cursor: anyOf: - type: string - type: 'null' description: Pass as `cursor` to fetch the next page. title: Next Cursor total: anyOf: - type: integer - type: 'null' description: Matching tasks; only on the first page. title: Total required: - data - has_more title: TaskListOut type: object TaskOut: properties: id: title: Id type: string identifier: anyOf: - type: string - type: 'null' description: Short handle such as TASK-12, accepted wherever a task id is. title: Identifier title: title: Title type: string description: default: '' title: Description type: string status: $ref: '#/components/schemas/TaskStatusRef' priority: title: Priority type: string deadline: anyOf: - format: date type: string - type: 'null' title: Deadline owner: anyOf: - $ref: '#/components/schemas/TaskUserRef' - type: 'null' labels: items: $ref: '#/components/schemas/TaskLabelOut' title: Labels type: array links: items: $ref: '#/components/schemas/TaskLinkOut' title: Links type: array source: title: Source type: string created_by: anyOf: - $ref: '#/components/schemas/TaskUserRef' - type: 'null' revision: title: Revision type: integer created_at: format: date-time title: Created At type: string updated_at: format: date-time title: Updated At type: string finished_at: anyOf: - format: date-time type: string - type: 'null' title: Finished At archived_at: anyOf: - format: date-time type: string - type: 'null' title: Archived At admin_url: title: Admin Url type: string required: - id - title - status - priority - labels - links - source - revision - created_at - updated_at - admin_url title: TaskOut type: object TaskStatusRef: properties: key: title: Key type: string label: title: Label type: string category: description: todo, in_progress, done, or canceled title: Category type: string role: anyOf: - type: string - type: 'null' description: '"review" for the review column' title: Role required: - key - label - category title: TaskStatusRef type: object TaskUserRef: properties: id: title: Id type: string name: anyOf: - type: string - type: 'null' title: Name email: anyOf: - type: string - type: 'null' title: Email required: - id title: TaskUserRef type: object TaskLabelOut: properties: id: title: Id type: string name: title: Name type: string color: title: Color type: string required: - id - name - color title: TaskLabelOut type: object TaskLinkOut: properties: id: title: Id type: string target_type: title: Target Type type: string target_id: title: Target Id type: string context: $ref: '#/components/schemas/TaskLinkContext' deleted: description: True when the linked record was deleted; the link stays as history. title: Deleted type: boolean admin_url: anyOf: - type: string - type: 'null' title: Admin Url required: - id - target_type - target_id - context - deleted title: TaskLinkOut type: object TaskLinkContext: properties: conversation_id: anyOf: - type: string - type: 'null' title: Conversation Id message_id: anyOf: - type: string - type: 'null' title: Message Id title: TaskLinkContext type: object securitySchemes: ScopedAPIKeyAuth: type: apiKey in: header name: X-API-Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.