Folders

Folders — Taskade REST API v1 reference: GET /folders/{folderId}/projects. Parameters, authentication, and response schema.

A Subspace is the top-level container for every AI-powered application you build on Taskade. It's more than just a folder; it's the complete, self-contained ecosystem for your app, holding its unique Knowledge, Intelligence, and Action layers.

When you generate an app or create one manually, you are creating a Subspace. Everything related to that app—its data (Projects), its logic (Agents), and its workflows (Automations)—is organized within it.

These endpoints allow you to manage the Subspaces in your workspace.

Summary of Endpoints

Get Folder Projects

get

Get all projects in a team, or in the home team of a workspace.

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

folderIdstringRequired

Folder/Workspace/Space ID

Responses

200

Projects

application/json

Projects

okboolean · enumRequiredPossible values:

4XX

Error description

application/json

get/folders/{folderId}/projects

HTTPcURLJavaScriptPython

GET /api/v1/folders/{folderId}/projects HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true,
  "items": [
    {
      "id": "text",
      "name": "text"
    }
  ]
}

Generate Agent in Folder

post

Generate agent based on input text prompts

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

folderIdstringRequired

Body

application/json

textstringRequired

Responses

200

Default response

application/json

okboolean · enumRequiredPossible values:

4XX

Error description

application/json

post/folders/{folderId}/agent-generate

HTTPcURLJavaScriptPython

POST /api/v1/folders/{folderId}/agent-generate HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "text": "text"
}

{
  "ok": true,
  "item": {
    "id": "text",
    "name": "text",
    "space_id": "text",
    "data": {
      "commands": [
        {
          "name": "text",
          "description": "text",
          "prompt": "text",
          "id": "text",
          "mode": "default"
        }
      ],
      "description": "text",
      "tone": "authoritative",
      "avatar": {
        "type": "emoji",
        "data": {
          "value": "text"
        }
      },
      "knowledgeEnabled": true,
      "language": "text",
      "inputPlaceholder": "text"
    }
  }
}

Create Agent in Folder

post

Create an agent in a team or workspace.

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

folderIdstringRequired

Body

application/json

namestringRequired

dataany ofRequired

or

Responses

200

Default response

application/json

okboolean · enumRequiredPossible values:

4XX

Error description

application/json

post/folders/{folderId}/agents

HTTPcURLJavaScriptPython

POST /api/v1/folders/{folderId}/agents HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 304

{
  "name": "text",
  "data": {
    "type": "data",
    "data": {
      "commands": [
        {
          "name": "text",
          "description": "text",
          "prompt": "text",
          "id": "text",
          "mode": "default"
        }
      ],
      "description": "text",
      "tone": "authoritative",
      "avatar": {
        "type": "emoji",
        "data": {
          "value": "text"
        }
      },
      "knowledgeEnabled": true,
      "language": "text",
      "inputPlaceholder": "text"
    }
  }
}

{
  "ok": true,
  "item": {
    "id": "text",
    "name": "text",
    "space_id": "text",
    "data": {
      "commands": [
        {
          "name": "text",
          "description": "text",
          "prompt": "text",
          "id": "text",
          "mode": "default"
        }
      ],
      "description": "text",
      "tone": "authoritative",
      "avatar": {
        "type": "emoji",
        "data": {
          "value": "text"
        }
      },
      "knowledgeEnabled": true,
      "language": "text",
      "inputPlaceholder": "text"
    }
  }
}

Get Folder Agents

get

Get agents in a folder.

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

folderIdstringRequired

Query parameters

limitnumberOptionalDefault: 20

pagenumberOptionalDefault: 1

Responses

200

Agents

application/json

Agents

okboolean · enumRequiredPossible values:

4XX

Error description

application/json

get/folders/{folderId}/agents

HTTPcURLJavaScriptPython

GET /api/v1/folders/{folderId}/agents HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true,
  "items": [
    {
      "id": "text",
      "name": "text",
      "space_id": "text",
      "data": {
        "commands": [
          {
            "name": "text",
            "description": "text",
            "prompt": "text",
            "id": "text",
            "mode": "default"
          }
        ],
        "description": "text",
        "tone": "authoritative",
        "avatar": {
          "type": "emoji",
          "data": {
            "value": "text"
          }
        },
        "knowledgeEnabled": true,
        "language": "text",
        "inputPlaceholder": "text"
      }
    }
  ]
}

Get Folder Medias

get

Get medias in a folder

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

folderIdstringRequired

Query parameters

limitnumberOptionalDefault: 100

pagenumberOptionalDefault: 1

Responses

200

Medias

application/json

Medias

okboolean · enumRequiredPossible values:

4XX

Error description

application/json

get/folders/{folderId}/medias

HTTPcURLJavaScriptPython

GET /api/v1/folders/{folderId}/medias HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true,
  "items": [
    {
      "id": "text",
      "space_id": "text",
      "kind": "text"
    }
  ]
}

Get Folder Project Templates

get

Get projects templates in a folder.

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

folderIdstringRequired

Query parameters

limitnumberOptionalDefault: 20

pagenumberOptionalDefault: 1

Responses

200

Project Templates

application/json

Project Templates

okboolean · enumRequiredPossible values:

4XX

Error description

application/json

get/folders/{folderId}/project-templates

HTTPcURLJavaScriptPython

GET /api/v1/folders/{folderId}/project-templates HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true,
  "items": [
    {
      "id": "text",
      "name": "text"
    }
  ]
}