WorkRoad

Creates a task for the key's user.

Required scopes: tasks:create

Authorization

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*string

Length2 <= length <= 64

description?string

Lengthlength <= 512

dueDate?string

ISO-8601 due date.

Formatdate-time

type?string

Task type; defaults to Generic when omitted.

Length2 <= length <= 32

Default"Generic"

subject?string

Subject id owned by the user.

Match

^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Formatuuid

Response Body

`application/json`

curl -X POST "https://example.com/tasks" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'

{  "data": {    "id": "4d3c2b1a-0f9e-4d8c-9b7a-6f5e4d3c2b1a",    "name": "Finish lab report",    "description": "Include the error analysis.",    "type": "Generic",    "subject": "5f0c1d2e-3a4b-4c5d-8e6f-7a8b9c0d1e2f",    "dueDate": "2026-02-10T17:00:00.000Z",    "completed": false,    "created": "2026-01-15T09:30:00.000Z",    "updated": "2026-02-01T12:00:00.000Z"  }}

Create a task

Authorization

Request Body

Response Body

201application/json

400application/json

401application/json

403application/json

404application/json

405application/json

409application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`