> ## 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. # Get task details > Retrieve task metadata and all messages for a specific task ## OpenAPI ````yaml https://neo.api.projectdiscovery.io/api/openapi.json get /api/v1/tasks/{id} 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/{id}: get: tags: - Tasks summary: Get task details description: Retrieve task metadata and all messages for a specific task operationId: get-v1-tasks-id parameters: - description: Task ID in: path name: id required: true schema: format: uuid type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/TaskDetailsResponse' description: Task details with messages '401': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unauthorized '404': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Task not found security: - BearerAuth: [] - ApiKeyAuth: [] components: schemas: TaskDetailsResponse: properties: messages: description: Array of task messages items: additionalProperties: true type: object type: array read_only: description: >- True when viewer has read-only access (e.g. team member viewing a team task) type: boolean stream: $ref: '#/components/schemas/StreamInfo' streamUrls: description: Presigned URLs for stream content items: $ref: '#/components/schemas/StreamUrl' type: array streams: description: >- Each agent run for this task, oldest first. Run settings are included when available. items: $ref: '#/components/schemas/TaskStreamSummary' type: array task: $ref: '#/components/schemas/TaskInfo' required: - task - messages 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 StreamInfo: properties: hasStream: description: Whether the task has an active or completed stream type: boolean last_seq: description: | Sequence number through which the response's assistant message is already materialized (when a live snapshot was built). The UI should resume SSE from last_seq + 1 to avoid replaying chunks. format: int64 type: integer run_config: $ref: '#/components/schemas/TaskRunConfig' streamId: description: ID of the most recent stream type: string streamStatus: description: Status of the most recent stream (active, completed, error, aborted) type: string required: - hasStream type: object StreamUrl: properties: status: description: Stream status type: string streamId: description: Stream ID type: string url: description: Presigned URL to fetch stream content format: uri type: string required: - streamId - url type: object TaskStreamSummary: properties: completed_at: description: When the stream run finished, if applicable format: date-time type: string created_at: description: When the stream run started format: date-time type: string run_config: $ref: '#/components/schemas/TaskRunConfig' status: description: Stream status (active, completed, error, aborted, suspended, etc.) type: string stream_id: description: Stream run ID format: uuid type: string required: - stream_id - status - created_at type: object TaskInfo: properties: completion_delivery: description: >- Present when the task was created with an explicit completion_delivery value. enum: - webhook - artifact type: string created_at: format: date-time type: string created_by: description: Email of user who created the task format: email type: string 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 has an associated schedule. type: boolean model: description: Model used when the task was first created. type: string project_id: description: Project ID if task is project-scoped (null for personal tasks) format: uuid type: string schedule_info: $ref: '#/components/schemas/ScheduleInfo' secret_names: description: >- Secret names selected for this task. Secret values are never returned. items: type: string type: array source: description: Origin of the task (web UI, GitHub, Slack, Linear, Jira). enum: - web - github - slack - linear - jira type: string status: description: Current status of the task (derived from the latest stream) enum: - active - completed - error - pending - aborted - suspended type: string title: type: string updated_at: format: date-time type: string visibility: enum: - public - private - unlisted - team - support type: string required: - id - created_at - title - visibility - status type: object TaskRunConfig: description: >- Settings used for this agent run, such as model, mode, and agent routing. properties: agent_id: description: Agent that handled this run, when a specific agent was requested. type: string agent_ids: description: Agents allowed for this run when using agent swarm mode. items: type: string type: array ask_question: description: Whether ask_question tool was enabled for this run. type: boolean auto_execute: description: Whether plan mode auto-executes without user approval. type: boolean max_iterations: description: Max execution-verification loop iterations for this run. maximum: 5 minimum: 0 type: integer max_steps: description: Max LLM steps for execution mode on this run. maximum: 200 minimum: 4 type: integer mode: description: Execution mode for this run. enum: - agent - chat - plan type: string model: description: Model used for this run. type: string sandbox_id: description: Sandbox pinned for this run, when specified at create time. format: uuid type: string 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 ````