> ## Documentation Index > Fetch the complete documentation index at: https://docs.worksong.ai/llms.txt > Use this file to discover all available pages before exploring further. # GET /api/tasks ## OpenAPI ````yaml /api/worksong.openapi.json get /api/tasks openapi: 3.1.0 info: title: Worksong API version: 042e65d5f227 description: >- The HTTP API behind the Worksong apps, generated from the code at the commit below. Request and response shapes come from the shared zod contract; an operation marked `x-gaps` has a part the generator could not resolve. x-source: worksong-ai/worksong@042e65d5f2275493f60f879c7970dcfdeceb7e0e servers: - url: https://app.worksong.ai security: - bearerAuth: [] tags: - name: Approvals - name: Audit - name: Avatar generator - name: Bootstrap - name: Bot compute limit - name: Bot mcp servers - name: Bots - name: Calls - name: Connections - name: Contacts - name: Conversations - name: Coupons - name: Day grants - name: Desktop - name: Entity files - name: Files - name: Github - name: Insights - name: Login - name: Mcp servers - name: Me - name: Me bot messaging - name: Me chat header - name: Me daily limit - name: Me time zone - name: Memory - name: Message delete - name: Messages - name: Notifications - name: Optimize prompt - name: Phone - name: Places - name: Projects - name: Public file links - name: Push - name: Queue - name: Reactions - name: Register - name: Rooms - name: Routes - name: Routines - name: Runs - name: Skills - name: Tasks - name: Transcribe - name: Tts - name: Webhooks - name: Whats new - name: Whatsapp - name: Workspace files paths: /api/tasks: get: tags: - Tasks summary: GET /api/tasks operationId: get_api_tasks parameters: - name: limit in: query required: false schema: default: 50 type: integer minimum: 1 maximum: 100 - name: cursor in: query required: false schema: type: string minLength: 1 maxLength: 512 - name: status in: query required: false schema: type: string enum: - pending - queued - in_progress - waiting - blocked - resuming - completed - failed - cancelled - name: open in: query required: false schema: type: boolean - name: archived in: query required: false schema: type: boolean - name: botId in: query required: false schema: type: string format: uuid - name: since in: query required: false schema: type: string format: date-time - name: until in: query required: false schema: type: string format: date-time - name: q in: query required: false schema: type: string minLength: 1 maxLength: 200 - name: order in: query required: false schema: default: created type: string enum: - created - updated - name: scope in: query required: false schema: type: string enum: - mine - all - assigned - created - review - name: search in: query required: false schema: type: string minLength: 1 maxLength: 200 responses: '200': description: Success content: application/json: schema: type: object properties: items: type: array items: type: object properties: id: type: string format: uuid number: type: integer exclusiveMinimum: 0 maximum: 2147483647 botId: type: string format: uuid title: type: string minLength: 1 maxLength: 200 description: type: string maxLength: 20000 status: type: string enum: - pending - queued - in_progress - waiting - blocked - resuming - completed - failed - cancelled progress: type: string maxLength: 20000 result: anyOf: - type: string maxLength: 100000 - type: 'null' blockedReason: anyOf: - type: string maxLength: 4000 - type: 'null' originatingConversationId: anyOf: - type: string format: uuid - type: 'null' originatingSessionId: anyOf: - type: string minLength: 1 maxLength: 200 pattern: ^[A-Za-z0-9._:-]+$ - type: 'null' originatingRunId: anyOf: - type: string format: uuid - type: 'null' workConversationId: anyOf: - type: string format: uuid - type: 'null' startedAt: anyOf: - type: string format: date-time - type: 'null' completedAt: anyOf: - type: string format: date-time - type: 'null' lastActivityAt: type: string format: date-time createdAt: type: string format: date-time updatedAt: type: string format: date-time artifacts: default: [] maxItems: 16 type: array items: type: object properties: id: type: string format: uuid filename: type: string minLength: 1 maxLength: 255 mimeType: type: string minLength: 1 maxLength: 128 byteSize: type: integer minimum: 0 maximum: 9007199254740991 available: type: boolean createdAt: type: string format: date-time required: - id - filename - mimeType - byteSize - available - createdAt additionalProperties: false escalation: anyOf: - type: object properties: id: type: string format: uuid cycle: type: integer minimum: 1 maximum: 9007199254740991 reason: type: string minLength: 1 maxLength: 4000 attempts: type: string minLength: 1 maxLength: 20000 userActionRequired: type: string minLength: 1 maxLength: 4000 context: anyOf: - type: string maxLength: 20000 - type: 'null' checkpoint: type: object properties: workConversationId: anyOf: - type: string format: uuid - type: 'null' workSessionId: anyOf: - type: string minLength: 1 maxLength: 200 pattern: ^[A-Za-z0-9._:-]+$ - type: 'null' workRunId: anyOf: - type: string format: uuid - type: 'null' transcriptSeq: anyOf: - type: integer minimum: 0 maximum: 9007199254740991 - type: 'null' originatingConversationId: anyOf: - type: string format: uuid - type: 'null' required: - workConversationId - workSessionId - workRunId - transcriptSeq - originatingConversationId additionalProperties: false resolution: anyOf: - type: string maxLength: 20000 - type: 'null' escalatedAt: type: string format: date-time resolvedAt: anyOf: - type: string format: date-time - type: 'null' required: - id - cycle - reason - attempts - userActionRequired - context - checkpoint - resolution - escalatedAt - resolvedAt additionalProperties: false - type: 'null' resumeAt: anyOf: - type: string format: date-time - type: 'null' createdBy: type: string enum: - agent - user review: anyOf: - type: object properties: state: type: string enum: - pending - approved - changes_requested decidedAt: anyOf: - type: string format: date-time - type: 'null' required: - state - decidedAt additionalProperties: false - type: 'null' archivedAt: anyOf: - type: string format: date-time - type: 'null' required: - id - botId - title - description - status - progress - result - blockedReason - originatingConversationId - originatingSessionId - originatingRunId - workConversationId - startedAt - completedAt - lastActivityAt - createdAt - updatedAt - artifacts additionalProperties: false nextCursor: anyOf: - type: string minLength: 1 maxLength: 512 - type: 'null' required: - items - nextCursor additionalProperties: false 4XX: description: Error. A problem object with a status and a message. security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.