---
title: "List all agent tasks"
method: GET
path: "/v1/tasks"
tags: ["Tasks"]
---

# List all agent tasks

`GET /v1/tasks`

Retrieve all agent tasks available in your workspace including public agent tasks and custom workspace agent tasks

## Query parameters

- `size` number
- `page` number
- `scope` 'USER' | 'WORKSPACE' | 'PUBLIC'
- `includeContextItems` boolean
- `includeCategories` boolean
- `searchTerm` string

## Response `200`

Successfully retrieved list of agent tasks

- TasksListResponseDto
  - `requestId` string
  - `resource` string
  - `data` TaskResource[]
    - `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
  - `pagination` object

## Other responses

- `500` — Internal server error. Unable to get agent tasks.

---

[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)