Skip to main content
Get the Task Profile for an Employee
curl --request GET \
  --url https://{tenant_name}.{region}.techwolf.ai/employees/{employee_external_id}/task_profile \
  --header 'Authorization: Bearer <token>'
{
  "external_id": "61a6e076-d780-11ec-9d64-0242ac120002",
  "tasks": [
    {
      "task_id": "write-unit-tests",
      "task": "Write unit tests",
      "validation_state": "validated",
      "weekly_hours": 5,
      "ai_impact": {
        "level": "H2",
        "rationale": "Portions can be automated via LLM test generation"
      },
      "source_events": [
        {
          "external_id": "5cbdbdbe-5f44-4423-8157-520f8a2f429a",
          "event_type": "project"
        }
      ]
    },
    {
      "task_id": "review-pull-requests",
      "task": "Review pull requests",
      "validation_state": "suggested",
      "ai_impact": {
        "level": "H3",
        "rationale": "Requires human judgment for code quality assessment"
      },
      "source_events": [
        {
          "external_id": "5cbdbdbe-5f44-4423-8157-520f8a2f429a",
          "event_type": "project"
        }
      ]
    }
  ]
}

Authorizations

Authorization
string
header
required

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

Path Parameters

employee_external_id
string
required

The external identifier of the Employee.

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_events — includes the source events behind each task.
  • 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_events,
rejected_tasks,
weekly_hours
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 Employee.

external_id
string
required

The Employee's external_id.

Example:

"61a6e076-d780-11ec-9d64-0242ac120002"

tasks
object[]
required

List of tasks in the Employee's profile.