Skip to main content
Search Tasks
curl --request GET \
  --url https://{tenant_name}.{region}.techwolf.ai/tasks/search \
  --header 'Authorization: Bearer <token>'
[ { "task_id": "56dcdb53-264e-f380-50bf-5179e2d082af", "task_name": "Write unit tests for backend services" }, { "task_id": "8c1e4313-cb49-9055-74c9-5976970fa335", "task_name": "Write integration tests for the payment API" } ]

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
query
string
required

The search query to match against task names. Typically a short partial term — fuzzy matching expands it across stored task names.

Maximum string length: 100
​
limit
integer
default:10

Maximum number of results to return.

Required range: 1 <= x <= 100
​
include
enum<string>[]

Additional attributes that will be included in each result. This query parameter can be added multiple times to include more attributes. By default none of these are returned.

  • 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).
Available options:
ai_impact,
hierarchy,
task_source,
enrichment_status

Response

OK

​
task_id
string<slug>
required

Unique identifier of the task.

Maximum string length: 100
Example:

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

​
task_name
string
required

Name/description of the task.

Example:

"Write unit tests for backend services"

​
ai_impact
object

AI impact level and rationale for this task. Only present when include=ai_impact.

​
hierarchy
object

Position of this task in the work taxonomy (domain → subdomain → cluster → canonical task). Only present when include=hierarchy. domain_name is always populated; subdomain_name, cluster_name, and canonical_task_name may be null depending on the depth of the work taxonomy.

​
task_source
enum<string>

Origin of the task. Only present when include=task_source.

Available options:
vocabulary,
custom
Example:

"vocabulary"

​
enrichment_status
enum<string>

Status of the task's asynchronous AI-impact enrichment. Only present when include=enrichment_status.

Available options:
pending,
complete,
failed
Example:

"complete"