Apps (Subspaces)

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 folder, or in the home folder of a workspace.

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

folderIdstringRequired

Folder/Workspace/Space ID

Responses

200

Projects

application/json

4XX

Error description

application/json

get

HTTPcURLJavaScriptPython

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

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

Generate Agent in Folder

post

Generate agent based on input text prompts

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

folderIdstringRequired

Body

textstringRequired

Responses

200

Default response

application/json

4XX

Error description

application/json

post

HTTPcURLJavaScriptPython

POST /api/v1/folders/{folderId}/agent-generate HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_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",
          "prompt": "text",
          "id": "text",
          "mode": "default"
        }
      ],
      "description": "text",
      "tone": "authoritative",
      "avatar": {
        "type": "emoji",
        "data": {
          "value": "text"
        }
      },
      "knowledgeEnabled": true,
      "language": "text"
    }
  }
}

Create Agent in Folder

post

Create an agent in a folder, or in the home folder of a workspace.

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

folderIdstringRequired

Body

namestringRequired

dataany ofRequired

or

Responses

200

Default response

application/json

4XX

Error description

application/json

post

HTTPcURLJavaScriptPython

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

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

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

Get Folder Agents

get

Get agents in a folder.

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

folderIdstringRequired

Query parameters

limitnumberOptionalDefault: 20

pagenumberOptionalDefault: 1

Responses

200

Agents

application/json

4XX

Error description

application/json

get

HTTPcURLJavaScriptPython

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

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

Get Folder Medias

get

Get medias in a folder

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

folderIdstringRequired

Query parameters

limitnumberOptionalDefault: 100

pagenumberOptionalDefault: 1

Responses

200

Medias

application/json

4XX

Error description

application/json

get

HTTPcURLJavaScriptPython

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

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

Get Folder Project Templates

get

Get projects templates in a folder.

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

folderIdstringRequired

Query parameters

limitnumberOptionalDefault: 20

pagenumberOptionalDefault: 1

Responses

200

Project Templates

application/json

4XX

Error description

application/json

get

HTTPcURLJavaScriptPython

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

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