Skip to main content

Authorizations

Authorization
string
header
required

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

Scopes

read

allows reading resources

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"