Skip to main content

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
include
enum<string>[]

Additional attributes that will be included in the response body. This query parameter can be added multiple times to include more attributes.

  • ai_impact — includes AI impact level and rationale per task.
  • hierarchy — includes the task's position in the work taxonomy (domain → subdomain → cluster → canonical task).
  • task_source — distinguishes standard work-taxonomy Tasks (vocabulary) from Tasks created through the POST /tasks endpoint (custom).
  • enrichment_status — includes the status of the task's asynchronous AI-impact enrichment (pending, complete, or failed).
  • linked_jobs — includes the complete set of Jobs each Task is assigned to, each with its validation_state, weekly_hours, and linked_skills (Skill ID and name). Assignments rejected via feedback are excluded; a Task that is not assigned to any Job has an empty list. Use the external_vendor query parameter to display the linked Skill names in an external vendor vocabulary (external_vendor is only accepted together with this include). Only accepted when limit is set to at most 200 — use starting_after pagination for larger reads.
Available options:
ai_impact,
hierarchy,
task_source,
enrichment_status,
linked_jobs
​
external_vendor
enum<string>
default:techwolf

The external vendor vocabulary you want to see the Skills displayed in. This will only work for vendors that are activated on your tenant.

Available options:
techwolf,
workday,
sap_attribute_library
Example:

"workday"

Body

application/json
​
limit
integer
default:50000

Number of Tasks to return per page.

Required range: 1 <= x <= 50000
Example:

50000

​
starting_after
string<slug>

The task_id of the last Task seen. Used for cursor-based pagination. Omit on the first request.

Maximum string length: 100
Example:

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

​
filters
(task_id_is_in_list · object | canonical_task_id_is_in_list · object)[]

A set of filters to apply on the exported Tasks.

Response

OK

​
has_next
boolean
required

True when there is more data after this page.

Example:

true

​
records
object[]
required

List of Task records.

​
next_starting_after
string<slug>

The cursor value to use as starting_after on the next request. Only present when has_next is true.

Maximum string length: 100
Example:

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