> ## Documentation Index > Fetch the complete documentation index at: https://lightsage.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List Tasks > List the persisted daily tasks for the organization. Returns existing tasks filtered by workflow `status`, along with per-status counts. Each task includes an `execution_prompt` with the context an AI agent needs to execute it. If `action_date` is omitted, the response spans persisted tasks across generation dates. This reads existing tasks; it does not generate a new batch. ## OpenAPI ````yaml /openapi.json get /v1/tasks openapi: 3.1.0 info: title: Lightsage Public API description: Public API for Lightsage CLI and external integrations. version: 1.0.0 servers: - url: https://api.lightsage.com description: Production security: [] paths: /v1/tasks: get: tags: - Tasks summary: List Tasks description: >- List the persisted daily tasks for the organization. Returns existing tasks filtered by workflow `status`, along with per-status counts. Each task includes an `execution_prompt` with the context an AI agent needs to execute it. If `action_date` is omitted, the response spans persisted tasks across generation dates. This reads existing tasks; it does not generate a new batch. operationId: tasks_list parameters: - name: action_date in: query required: false schema: type: string format: date description: >- Action-queue date to read (YYYY-MM-DD). Omit to read persisted tasks across all generation dates. title: Action Date description: >- Action-queue date to read (YYYY-MM-DD). Omit to read persisted tasks across all generation dates. - name: status in: query required: false schema: enum: - active - todo - new - in_progress - completed - done - dismissed - all type: string description: >- Which slice of the queue to return. The default active view returns todo/new and in-progress tasks. Use todo/new, in_progress, done, dismissed, completed, or all for a narrower or broader slice. default: active title: Status description: >- Which slice of the queue to return. The default active view returns todo/new and in-progress tasks. Use todo/new, in_progress, done, dismissed, completed, or all for a narrower or broader slice. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ListTasksResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - LightsageApiKeyAuth: [] components: schemas: ListTasksResponse: properties: action_date: type: string title: Action Date status: type: string enum: - active - todo - new - in_progress - completed - done - dismissed - all title: Status batch_number: anyOf: - type: integer - type: 'null' title: Batch Number latest_batch_number: type: integer title: Latest Batch Number default: 0 data: items: $ref: '#/components/schemas/PublicTask' type: array title: Data count: type: integer title: Count active_count: type: integer title: Active Count default: 0 in_progress_count: type: integer title: In Progress Count default: 0 completed_count: type: integer title: Completed Count default: 0 done_count: type: integer title: Done Count default: 0 dismissed_count: type: integer title: Dismissed Count default: 0 history_count: type: integer title: History Count default: 0 has_history: type: boolean title: Has History default: false can_fetch_next_batch: type: boolean title: Can Fetch Next Batch default: false generated_at: anyOf: - type: string - type: 'null' title: Generated At type: object required: - action_date - status - count title: ListTasksResponse description: A batch of daily tasks plus the queue's status counts. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError PublicTask: properties: id: type: string title: Id action_date: type: string title: Action Date batch_number: type: integer title: Batch Number rank: type: integer title: Rank source_key: type: string title: Source Key task_type: type: string title: Task Type title: type: string title: Title why: type: string title: Why next_action: type: string title: Next Action description: anyOf: - type: string - type: 'null' title: Description execution_prompt: type: string title: Execution Prompt description: Paste-ready instructions for an AI agent to execute this task. reasoning: anyOf: - type: string - type: 'null' title: Reasoning evidence: additionalProperties: true type: object title: Evidence score: type: number title: Score effort: type: string title: Effort priority: anyOf: - type: string - type: 'null' title: Priority status: type: string title: Status assignee_user_id: anyOf: - type: string - type: 'null' title: Assignee User Id function_area: anyOf: - type: string - type: 'null' title: Function Area action_type: anyOf: - type: string - type: 'null' title: Action Type source: anyOf: - type: string - type: 'null' title: Source source_type: type: string title: Source Type source_refs: additionalProperties: true type: object title: Source Refs metadata: additionalProperties: true type: object title: Metadata created_at: anyOf: - type: string - type: 'null' title: Created At updated_at: anyOf: - type: string - type: 'null' title: Updated At additionalProperties: true type: object required: - id - action_date - batch_number - rank - source_key - task_type - title - why - next_action - execution_prompt - score - effort - status - source_type title: PublicTask description: A single persisted daily task in the public contract shape. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: LightsageApiKeyAuth: type: apiKey in: header name: X-Lightsage-Api-Key ````