POST
/
v1
/
tasks
Create a task
curl --request POST \
  --url https://api.steuerboard.com/v1/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-client-id: <x-client-id>' \
  --data '{
  "title": "Task Upload Documents",
  "text": "Upload the documents",
  "dueDate": "2021-01-01T00:00:00Z",
  "workspaceId": "cmf41ajzv003706un4i99q19z"
}'
{
  "id": "cmf41ajzv003706un4i99q19z",
  "title": "Task 1",
  "text": "Upload the documents",
  "status": "OPEN",
  "dueDate": "2021-01-01T00:00:00Z",
  "workspaceId": "cmf41ajzv003706un4i99q19z",
  "createdById": "cmf41ajzv003706un4i99q19z",
  "actorType": "USER",
  "parentId": "cmf41ajzv003706un4i99q19z",
  "destinationFolderId": "cmf41ajzv003706un4i99q19z",
  "createdAt": "2021-01-01T00:00:00Z",
  "updatedAt": "2021-01-01T00:00:00Z"
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication

Headers

​
x-client-id
string<cuid>
required

The ID of the client

Example:

"cmf41ajzv003706un4i99q19z"

Body

application/json

Task create

​
title
string
required

The title of the task

Example:

"Task Upload Documents"

​
workspaceId
string<cuid>
required

The ID of the workspace

Example:

"cmf41ajzv003706un4i99q19z"

​
text
string

The text of the task

Example:

"Upload the documents"

​
dueDate
string

The due date of a task

Example:

"2021-01-01T00:00:00Z"

Response

Task created successfully

​
id
string<cuid>
required

The ID of the task

Example:

"cmf41ajzv003706un4i99q19z"

​
title
string
required

The title of the task

Example:

"Task 1"

​
text
string | null
required

The text of the task

Example:

"Upload the documents"

​
status
enum<string>
required

The status of the task

Available options:
IN_PROGRESS,
ACCEPTED,
OPEN,
IN_REVIEW,
DECLINED
Example:

"OPEN"

​
dueDate
string<date-time> | null
required

The due date of a task

Example:

"2021-01-01T00:00:00Z"

​
workspaceId
string<cuid>
required

The ID of the workspace

Example:

"cmf41ajzv003706un4i99q19z"

​
createdById
string<cuid> | null
required

The ID of the creator

Example:

"cmf41ajzv003706un4i99q19z"

​
actorType
enum<string>
required

The type of the actor

Available options:
USER,
SYSTEM,
AI,
API
Example:

"USER"

​
parentId
string<cuid> | null
required

The ID of the parent task

Example:

"cmf41ajzv003706un4i99q19z"

​
destinationFolderId
string<cuid> | null
required

The ID of the destination folder where assigned files will be stored

Example:

"cmf41ajzv003706un4i99q19z"

​
createdAt
string<date-time>
required

The date and time of the creation for the task

Example:

"2021-01-01T00:00:00Z"

​
updatedAt
string<date-time>
required

The date and time of the last update for the task

Example:

"2021-01-01T00:00:00Z"