Tasks

List all agent tasks

Changed on Nov 3, 2026

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

get/v1/tasks

Request

Base URL
https://api.jasper.ai
URL
https://api.jasper.ai/v1/tasks
Auth
- API key in header X-API-Key
- or OAuth 2
  Authorization code: https://api.jasper.ai/oauth2/authorize
  Token URL: https://api.jasper.ai/oauth2/token scopes: user:read

Query parameters

sizenumber

Example:100

Number of agent tasks to return per page

pagenumber

Example:1

Page number (1-indexed)

scope'USER' | 'WORKSPACE' | 'PUBLIC'

Example:PUBLIC

Filter by agent task scope: PUBLIC or WORKSPACE

includeContextItemsboolean

Include context items (input fields) in the response for the task to be executed by the agent. Default is false.

includeCategoriesboolean

Include categories for the agent tasks in the response. Default is false.

searchTermstring

Example:blog

Search term to filter agent tasks by name, description, categories, or tags. Performs partial case-insensitive matching.

Response

Successfully retrieved list of agent tasks

requestIdstring

resourcestring

paginationobject

Example response

{
  "requestId": "07008c5a-f916-4bdc-bfda-e8f6c328f7c5",
  "resource": "tasks",
  "data": [
    {
      "id": "agt_0190f3a1b2c34d5e6f7a8b9c0d1e2f3a",
      "name": "Grammar Checker",
      "appUrl": "https://app.jasper.ai/studio/962e4d4c-ffdc-4c7a-83e3-8f4e715004cf",
      "description": "Ensure your text is free from grammar errors to enhance clarity and professionalism",
      "contextItems": [
        {
          "id": "5e9f3d7b-9ec6-44e7-b752-3977fef34c18",
          "name": "Original text",
          "type": "TEXTAREA",
          "question": "What text do you want to check?",
          "options": [
            "grammar",
            "writing"
          ]
        }
      ],
      "version": 1,
      "scope": "PUBLIC",
      "updatedAt": "2024-10-29T03:47:44.468Z",
      "createdAt": "2024-10-02T03:51:26.020Z",
      "categories": []
    }
  ],
  "pagination": {
    "totalRecords": 100,
    "page": 1,
    "pageSize": 25,
    "next": "2",
    "prev": null
  }
}

Changes

Nov 3, 20263d5be7408661 Revision changes
- breaking
  the //// response's property type changed from string to object for status
- breaking
  the // response's property type changed from string to object for status
- breaking
  the // response's property type changed from string to object for status
- breaking
  the // response's property type changed from string to object for status
- breaking
  the // response's property type changed from string to object for status
- info
  added the required property // to the response with the status

Operation history