Folders

Summary of Endpoints

Get Folder Projects

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

GEThttps://www.taskade.com/api/v1/folders/{folderId}/projects

Authorization

oAuthAuthorizationCode

Path parameters

folderId*string

Folder/Workspace/Space ID

Response

2004XX

Projects

Body

application/json

ok*enum

true

items*array of nullable all of

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://www.taskade.com/api/v1/folders/{folderId}/projects', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

2004XX

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

Generate Agent in Folder

Generate agent based on input text prompts

POSThttps://www.taskade.com/api/v1/folders/{folderId}/agent-generate

Authorization

oAuthAuthorizationCode

Path parameters

folderId*string

Body

application/json

text*string

Response

2004XX

Default response

Body

application/json

ok*enum

true

item*object

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://www.taskade.com/api/v1/folders/{folderId}/agent-generate', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "text": "text"
    }),
});
const data = await response.json();

Response

2004XX

{
  "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

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

POSThttps://www.taskade.com/api/v1/folders/{folderId}/agents

Authorization

oAuthAuthorizationCode

Path parameters

folderId*string

Body

application/json

name*string

data*any of

objectobject

Response

2004XX

Default response

Body

application/json

ok*enum

true

item*object

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://www.taskade.com/api/v1/folders/{folderId}/agents', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "text",
      "data": {
        "type": "data",
        "data": {
          "commands": [
            {
              "name": "text",
              "prompt": "text",
              "id": "text",
              "mode": "default"
            }
          ],
          "tone": "authoritative",
          "avatar": {
            "type": "emoji",
            "data": {
              "value": "text"
            }
          }
        }
      }
    }),
});
const data = await response.json();

Response

2004XX

{
  "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 agents in a folder.

GEThttps://www.taskade.com/api/v1/folders/{folderId}/agents

Authorization

oAuthAuthorizationCode

Path parameters

folderId*string

Query parameters

Response

2004XX

Agents

Body

application/json

ok*enum

true

items*array of nullable all of

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://www.taskade.com/api/v1/folders/{folderId}/agents', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

2004XX

{
  "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 medias in a folder

GEThttps://www.taskade.com/api/v1/folders/{folderId}/medias

Authorization

oAuthAuthorizationCode

Path parameters

folderId*string

Query parameters

Response

2004XX

Medias

Body

application/json

ok*enum

true

items*array of nullable all of

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://www.taskade.com/api/v1/folders/{folderId}/medias', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

2004XX

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

Get Folder Project Templates

Get projects templates in a folder.

GEThttps://www.taskade.com/api/v1/folders/{folderId}/project-templates

Authorization

oAuthAuthorizationCode

Path parameters

folderId*string

Query parameters

Response

2004XX

Project Templates

Body

application/json

ok*enum

true

items*array of nullable all of

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://www.taskade.com/api/v1/folders/{folderId}/project-templates', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

2004XX

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