Media

Media — Taskade REST API v1 reference: GET /medias/{mediaId}. Parameters, authentication, and response schema.

Summary of Endpoints

Get Media

get

Get media with id

Authorizations

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

mediaIdstringRequired

Responses

200

Media

application/json

Media

okboolean · enumRequiredPossible values:

4XX

Error description

application/json

get/medias/{mediaId}

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

{
  "ok": true,
  "item": {
    "id": "abc123DEF456",
    "space_id": "abc123DEF456",
    "kind": "example"
  }
}

Delete Media

delete

Delete a media

Authorizations

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

mediaIdstringRequired

Responses

200

Successful Media deletion

application/json

Successful Media deletion

okboolean · enumRequiredPossible values:

4XX

Error description

application/json

delete/medias/{mediaId}

DELETE /api/v1/medias/{mediaId} HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true
}

Download Media

get

Download the binary content of a media file. Returns the file with the original Content-Type and Content-Disposition headers.

Authorizations

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

mediaIdstringRequired

The SpaceMedia record ID.

Responses

4XX

Error description

application/json

Error description

okboolean · enumRequiredPossible values:

messagestringRequired

codestringRequired

statusMessagestringRequired

get/medias/{mediaId}/download

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

4XX

Error description

{
  "ok": false,
  "message": "text",
  "code": "text",
  "statusMessage": "text"
}

Upload Media to Space

post

Upload a media file to a space (root workspace or subspace / app). Send the file as the raw request body with the appropriate Content-Type header (e.g. image/png, application/pdf, application/octet-stream). Pass the original filename as the filename query parameter.

Authorizations

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

spaceIdstringRequired

The space ID to upload media into (can be a root workspace or a subspace / app).

Query parameters

filenamestringRequired

Original filename of the uploaded file (e.g. "photo.png").

Responses

200

Uploaded media file details

application/json

Uploaded media file details

okboolean · enumRequiredPossible values:

4XX

Error description

application/json

post/medias/spaces/{spaceId}/upload

POST /api/v1/medias/spaces/{spaceId}/upload?filename=text HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true,
  "item": {
    "mediaId": "abc123DEF456",
    "fileId": "abc123DEF456",
    "kind": "example",
    "downloadUrl": "https://example.com"
  }
}

Download Media from Space

get

Download all media files from a space as a ZIP archive. Each file is stored as {mediaId}/metadata.json (id, kind, name, mimetype, size) and {mediaId}/original (binary content).

Authorizations

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

spaceIdstringRequired

The space (subspace / app) ID to download all media from.

Responses

4XX

Error description

application/json

Error description

okboolean · enumRequiredPossible values:

messagestringRequired

codestringRequired

statusMessagestringRequired

get/medias/spaces/{spaceId}/download

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

4XX

Error description

{
  "ok": false,
  "message": "text",
  "code": "text",
  "statusMessage": "text"
}