Workspaces

Workspaces — Taskade REST API v1 reference: GET /workspaces. Parameters, authentication, and response schema.

Summary of Endpoints

Workspaces

get

See More

Get all workspaces for a user

Authorizations

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Workspaces

application/json

Workspaces

okboolean · enumRequiredPossible values:

4XX

Error description

application/json

get/workspaces

GET /api/v1/workspaces HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true,
  "items": [
    {
      "id": "abc123DEF456",
      "name": "Sales Pipeline"
    }
  ]
}

Folders

get

Get all folders for a workspace

Authorizations

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

workspaceIdstringRequired

Responses

200

Folders

application/json

Folders

okboolean · enumRequiredPossible values:

4XX

Error description

application/json

get/workspaces/{workspaceId}/folders

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

{
  "ok": true,
  "items": [
    {
      "id": "abc123DEF456",
      "name": "Sales Pipeline"
    }
  ]
}

Projects

post

Create a project in a workspace

Authorizations

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

workspaceIdstringRequired

Body

contentTypestring · enumRequiredPossible values:

contentstringRequired

Responses

200

Successful Project creation

application/json

Successful Project creation

okboolean · enumRequiredPossible values:

4XX

Error description

application/json

post/workspaces/{workspaceId}/projects

POST /api/v1/workspaces/{workspaceId}/projects HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 48

{
  "contentType": "text/markdown",
  "content": "text"
}

{
  "ok": true,
  "item": {
    "id": "abc123DEF456",
    "name": "Sales Pipeline"
  }
}