Skip to main content
Get the task-based match score between two task sets
curl --request POST \
  --url https://{tenant_name}.{region}.techwolf.ai/tasks/matching \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "source_tasks": [
    {
      "task_id": "a7844da2-b2b2-42da-818a-006785d8e78d",
      "weekly_hours": 8
    },
    {
      "task_id": "dc6b2225-fa29-4c4b-8102-b218b70a8287"
    }
  ],
  "target_tasks": [
    {
      "task_id": "d7b51744-5c02-4274-85ac-d6fe1a480a85"
    },
    {
      "task_id": "960bc9a9-cbaa-4c84-8539-7c0755b27ef9",
      "weekly_hours": 4
    }
  ]
}
'
{
  "score": 0.42
}

Documentation Index

Fetch the complete documentation index at: https://developers.techwolf.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

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

Body

application/json

A pair of task sets to compare. Both sides are explicit lists of existing tasks, each optionally weighted by weekly hours; the match score is computed directly from their task embeddings.

source_tasks
object[]
required

Source task set. Must contain between 1 and 100 tasks; every task_id must reference an existing Task in the system.

Required array length: 1 - 100 elements
Example:
[
  {
    "task_id": "a7844da2-b2b2-42da-818a-006785d8e78d",
    "weekly_hours": 8
  },
  {
    "task_id": "dc6b2225-fa29-4c4b-8102-b218b70a8287"
  }
]
target_tasks
object[]
required

Target task set. Must contain between 1 and 100 tasks; every task_id must reference an existing Task in the system.

Required array length: 1 - 100 elements
Example:
[
  {
    "task_id": "d7b51744-5c02-4274-85ac-d6fe1a480a85"
  },
  {
    "task_id": "960bc9a9-cbaa-4c84-8539-7c0755b27ef9",
    "weekly_hours": 4
  }
]

Response

OK

An ad-hoc task-based match result between two task sets.

score
number<float>
required

The symmetric task-based match score between the two task sets, expressed as a number between 0 and 1.

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

0.42