---
title: "Get agent task by ID"
method: GET
path: "/v1/tasks/{id}"
tags: ["Tasks"]
---

# Get agent task by ID

`GET /v1/tasks/{id}`

Retrieve a specific agent task by its unique identifier

## Path parameters

- `id` string, required

## Query parameters

- `version` number

## Response `200`

Successfully retrieved agent task

- TaskResponseDto
  - `requestId` string
  - `resource` string
  - `data` TaskResource, required
    - `id` string, required — Stable, public-facing identifier for the agent task. The internal UUID is also accepted anywhere this id is required.
    - `name` string, required — Name of the agent task
    - `description` string, required — Short description of the agent task
    - `contextItems` TaskContextItem[] — Context items required by the agent task
      - `id` string, required — Unique identifier for the context item
      - `name` string, required — Name of the context item
      - `type` 'TEXTAREA' | 'INPUT' | 'TAGS_INPUT' | 'SELECT' | 'MULTISELECT' | 'CUSTOM' | 'KNOWLEDGE' | 'IMAGE_ID' | 'TOOL' | 'CHECKBOX', required — Type of the context item
      - `question` string — Question prompt for the context item
      - `options` string[] — List of options for the context item
      - `tooltip` string, nullable — Tooltip text for the context item
      - `required` boolean — Whether this context item is required
      - `value` object — Value of the context item
    - `generationSkillId` string, nullable — Associated generation skill ID
    - `version` number, required — Version number of the agent task
    - `scope` 'USER' | 'WORKSPACE' | 'PUBLIC', required — Scope of the agent task (PUBLIC for those available to all users, WORKSPACE for those custom to your workspace)
    - `updatedAt` string, required — Timestamp when the agent task was last updated
    - `createdAt` string, required — Timestamp when the agent task was created
    - `longDescription` string, nullable — Extended description of the agent task in markdown format
    - `publishedAt` string, nullable — Timestamp when the agent task was published
    - `customFields` object, nullable — Custom fields associated with the agent task
    - `theme` string, nullable — Theme of the agent task
    - `categories` string[], nullable — Categories the agent task belongs to

## Other responses

- `404` — Agent task not found. The specified app ID may not exist or you may not have access to it.
- `500` — Internal server error. Unable to get agent task.

---

[API](https://skmtc.net/jasper/apis/jasper-api.md) · [All operations](https://skmtc.net/jasper/apis/jasper-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jasper/jasper-api/revisions/438914d9525e/schema)