Skip to main content
Create a custom task
curl --request POST \
  --url https://{tenant_name}.{region}.techwolf.ai/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "task_name": "Review quarterly performance reports for direct reports",
  "source": "workforce-planning-import"
}
'
{
  "task_id": "56dcdb53-264e-f380-50bf-5179e2d082af",
  "task_name": "Review quarterly performance reports for direct reports"
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
​
task_name
string
required

The composed task name. Must satisfy the same structural heuristics enforced by POST /tasks/validate (length 15–320, ≥3 words, ≤30% non-letter characters); a candidate that fails them is rejected with 422.

Example:

"Review quarterly performance reports for direct reports"

​
source
string | null

Optional free-text label recording where this Task originated (for example the system or workflow that created it). Stored with the Task for attribution and not returned by the read endpoints.

Maximum string length: 100
Example:

"workforce-planning-import"

Response

Created

​
task_id
string<uuid>
required

Unique identifier of a Task.

Example:

"56dcdb53-264e-f380-50bf-5179e2d082af"

​
task_name
string
required

The stored task name.

Example:

"Review quarterly performance reports for direct reports"