Skip to main content
Get the Task Profile for a Job
curl --request GET \
  --url https://{tenant_name}.{region}.techwolf.ai/job_architecture/jobs/{job_external_id}/task_profile \
  --header 'Authorization: Bearer <token>'
{ "external_id": "a3903505-eb84-42dc-a79f-5e7b1fe897b7", "tasks": [ { "task_id": "conduct-machine-learning-experiments", "task": "Conduct machine learning experiments", "validation_state": "validated", "weekly_hours": 5, "ai_impact": { "level": "H1", "rationale": "Highly automatable with AI-powered experiment tooling" }, "linked_skills": [ { "skill_id": "4b85469d-6729-4d70-9876-a0faa2a2f63b", "skill": "Python" }, { "skill_id": "c110316a-41d3-46ef-a35e-dbb27785b1c8", "skill": "Machine Learning" } ], "source_data": [ { "external_id": "a3903505-eb84-42dc-a79f-5e7b1fe897b7" } ] }, { "task_id": "review-model-outputs", "task": "Review model outputs", "validation_state": "suggested", "ai_impact": { "level": "H3", "rationale": "Requires human judgment to evaluate model quality" }, "linked_skills": [ { "skill_id": "c110316a-41d3-46ef-a35e-dbb27785b1c8", "skill": "Machine Learning" } ], "source_data": [ { "external_id": "a3903505-eb84-42dc-a79f-5e7b1fe897b7" } ] } ] }

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
job_external_id
string
required

The external identifier of the Job.

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.
  • source_data — includes the job profile data entries behind each task.
  • linked_skills — includes Skills linked to each task, with Skill ID and name. Use the external_vendor query parameter to display Skill names in an external vendor vocabulary.
  • rejected_tasks — includes tasks that were rejected via PATCH feedback (excluded by default).
  • weekly_hours — includes the estimated number of hours spent on each task per week.
Available options:
ai_impact,
source_data,
linked_skills,
rejected_tasks,
weekly_hours
​
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"

​
response_format
enum<string>
default:list

The format of the response profile.

Available options:
list,
hierarchy
Example:

"list"

Response

OK

The default Task Profile result is returned. The profile consists of a flat list of Tasks assigned to the Job.

​
external_id
string
required

The Job's external_id.

Example:

"a3903505-eb84-42dc-a79f-5e7b1fe897b7"

​
tasks
object[]
required

List of tasks in the Job's profile.