> ## Documentation Index > Fetch the complete documentation index at: https://docs.neo.projectdiscovery.io/llms.txt > Use this file to discover all available pages before exploring further. # List tasks > List the current user's own tasks with cursor-based pagination and optional status/scheduled filters. Team-visible tasks owned by teammates are excluded from this list by default, but may still be accessed directly by ID when authorized. ## OpenAPI ````yaml https://neo.api.projectdiscovery.io/api/openapi.json get /api/v1/tasks openapi: 3.1.0 info: contact: name: ProjectDiscovery url: https://neo.projectdiscovery.io description: Neo API Server - Security agent orchestration platform license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0 title: Neo API version: 1.0.0 servers: - description: Production url: https://neo.api.projectdiscovery.io - description: Local development url: http://localhost:8080 security: [] tags: - description: Task execution and management name: Tasks - description: Agent listing and management name: Agents - description: Public agent directory name: Agent Directory - description: User file storage management name: Files - description: User working memory management name: Memory - description: Scheduled and recurring task management name: Schedules - description: Knowledge base and semantic search name: Knowledge - description: Encrypted user credentials and API keys name: Secrets - description: Neo API key management for programmatic access name: API Keys - description: User profile and account information name: User - description: Task and LLM usage tracking name: Usage - description: Bring Your Own Key provider management name: BYOK - description: Model discovery and capabilities name: Models - description: Third-party integrations name: Integrations - description: Skill knowledge documents for agent prompts name: Skills - description: Team management and member invitations name: Teams - description: Prompt library management and discovery name: Prompts - description: Slack bot integration for workspace installation and OAuth name: Slack - description: GitHub integration for PR reviews and repository management name: GitHub - description: Vulnerability issue tracking and management name: Issues - description: Subscription billing and plans name: Billing - description: Project management and member assignments name: Projects - description: SSH key pair generation and management for remote server access name: SSH Keys - description: Codebase structural analysis and mapping name: Codemaps - description: AI-generated codebase documentation and security analysis name: CodeWiki - description: Captured HTTP traffic query and replay name: Network Events paths: /api/v1/tasks: get: tags: - Tasks summary: List tasks description: >- List the current user's own tasks with cursor-based pagination and optional status/scheduled filters. Team-visible tasks owned by teammates are excluded from this list by default, but may still be accessed directly by ID when authorized. operationId: get-v1-tasks parameters: - description: Number of tasks to return (max 100) in: query name: limit required: false schema: default: 20 maximum: 100 minimum: 1 type: integer - description: Cursor for pagination - return tasks after this ID (newer) in: query name: starting_after required: false schema: format: uuid type: string - description: Cursor for pagination - return tasks before this ID (older) in: query name: ending_before required: false schema: format: uuid type: string - description: Filter by task status in: query name: status required: false schema: enum: - active - completed - error - pending type: string - description: Filter by scheduled status in: query name: is_scheduled required: false schema: enum: - 'true' - 'false' type: string - description: >- Filter tasks by project ID. If omitted, returns only the current user's personal tasks. in: query name: project_id required: false schema: format: uuid type: string - description: Search query for tasks. Behavior depends on search_type parameter. in: query name: search required: false schema: maxLength: 500 type: string - description: | Search type: - title: Case-insensitive substring match on task title (default) - semantic: AI-powered semantic search across task messages in: query name: search_type required: false schema: default: title enum: - title - semantic type: string - description: > Filter by task source. Defaults to 'web' when not provided, which hides integration-sourced tasks (github, slack, linear) from the default list. Pass a specific source to list only tasks from that integration. in: query name: source required: false schema: enum: - web - github - slack - linear type: string - description: >- Field to sort tasks by. Defaults to updated_at so recently-active tasks surface first. in: query name: order_by required: false schema: default: updated_at enum: - created_at - updated_at type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/TaskListResponse' description: Task list with pagination info '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Bad request (e.g., both starting_after and ending_before provided) '401': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unauthorized '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Internal server error security: - BearerAuth: [] - ApiKeyAuth: [] components: schemas: TaskListResponse: properties: has_more: description: Whether there are more results available type: boolean tasks: items: $ref: '#/components/schemas/TaskSummary' type: array total: description: >- Total number of tasks matching the current filters (ignores pagination cursor) type: integer required: - tasks - has_more type: object ErrorResponse: properties: code: description: > Stable machine-readable error code — branch on this rather than matching the human `error`/`message` strings. Domain codes include `user_spending_cap_reached`, `project_spending_cap_reached`, and `insufficient_neo_credits`; otherwise it mirrors the error kind (e.g. `forbidden`, `invalid_request`, `not_exists`, `already_exists`). example: user_spending_cap_reached type: string error: example: Bad request type: string error_id: description: Correlation id for a specific error instance, when present. type: string kind: description: Coarse error category (e.g. "forbidden request", "invalid request"). example: forbidden request type: string message: description: | Human-readable detail (the kind prefixed to the error). For display, not for branching. type: string required: - error type: object TaskSummary: properties: created_at: description: When the task was created format: date-time type: string created_by: description: Email of user who created the task format: email type: string id: description: Task ID format: uuid type: string is_isolated: description: >- Whether the task runs in an ephemeral sandbox with no prior user context. type: boolean is_scheduled: description: Whether this task is scheduled type: boolean pending_approval_count: description: Number of tool calls awaiting user approval (0 when not suspended) type: integer project_id: description: Project ID if task is project-scoped (null for personal tasks) format: uuid type: string schedule_info: $ref: '#/components/schemas/ScheduleInfo' source: description: Source of the task (web, github, slack, linear, jira) enum: - web - github - slack - linear - jira type: string status: description: Current status of the task enum: - active - completed - error - pending - aborted - suspended type: string title: description: Task title type: string updated_at: description: When the task was last updated (stream run, rename, etc.) format: date-time type: string visibility: description: Who can access this task. enum: - public - private - unlisted - team - support type: string required: - id - title - created_at - updated_at - status - is_scheduled - source type: object ScheduleInfo: properties: execution_count: description: Total number of executions type: integer execution_info: $ref: '#/components/schemas/ExecutionInfo' last_executed_at: description: When the schedule was last executed format: date-time nullable: true type: string next_execution_at: description: When the schedule will next execute format: date-time nullable: true type: string scan_frequency: description: Frequency for recurring schedules enum: - hourly - daily - weekly - monthly nullable: true type: string schedule_id: description: Schedule ID format: uuid type: string schedule_name: description: Human-readable schedule name nullable: true type: string schedule_status: description: Current status of the schedule enum: - active - paused - completed - failed type: string schedule_type: description: Type of schedule enum: - recurring - one_time type: string start_time: description: Scheduled start time nullable: true type: string required: - schedule_id - schedule_type - schedule_status - execution_count type: object ExecutionInfo: properties: completed_at: description: When the execution completed format: date-time nullable: true type: string execution_id: description: Execution ID format: uuid type: string scheduled_at: description: When the execution was scheduled format: date-time type: string started_at: description: When the execution started format: date-time type: string status: description: Execution status enum: - pending - running - completed - failed type: string required: - execution_id - scheduled_at - started_at - status type: object securitySchemes: BearerAuth: bearerFormat: JWT description: JWT authentication token scheme: bearer type: http ApiKeyAuth: description: Neo API key (neo_sk_* prefix) in: header name: X-Api-Key type: apiKey ````