API Documentation

API Versioning

AI Integration

Taxonomy

Employees

Job Families

Jobs

Peer Groups

Vacancies

Courses

Skill Clusters

External Companies

Skills

Tasks

Organisational Structure

Custom Properties

Matchmaking

Matching Configuration

Export

Reports

Version

Validate Tasks

curl --request POST \
  --url https://{tenant_name}.{region}.techwolf.ai/tasks/validate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tasks": [
    {
      "task_name": "Review quarterly performance reports for direct reports"
    },
    {
      "task_name": "Run"
    }
  ]
}
'

{
  "results": [
    {
      "task_name": "Review quarterly performance reports for direct reports",
      "status": "valid",
      "rejection_reasons": [],
      "similar_tasks": []
    },
    {
      "task_name": "Run",
      "status": "rejected:formatting",
      "rejection_reasons": [
        {
          "code": "too_short"
        },
        {
          "code": "too_few_words"
        }
      ],
      "similar_tasks": []
    }
  ]
}

Task validation

Validate Tasks

Validate a batch of 1-15 candidate Task names before persisting them, without creating anything. Each candidate is screened with fast whole-string quality heuristics and a near-duplicate lookup against your existing Tasks.

Quality heuristics are hard rejections. A candidate that trips one or more heuristics gets status: "rejected:formatting" and a rejection_reasons list naming the failing codes (too_short, too_long, too_few_words, low_letter_ratio).
Near-duplicate detection is advisory only. similar_tasks lists existing Tasks similar to the candidate (highest similarity first), populated only for candidates that pass the quality heuristics and empty otherwise. It never rejects on its own, so the caller decides whether a match is a true duplicate.

A candidate that passes the heuristics has status: "valid" and an empty rejection_reasons, even when similar_tasks is non-empty.

Validate Tasks

curl --request POST \
  --url https://{tenant_name}.{region}.techwolf.ai/tasks/validate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tasks": [
    {
      "task_name": "Review quarterly performance reports for direct reports"
    },
    {
      "task_name": "Run"
    }
  ]
}
'

{
  "results": [
    {
      "task_name": "Review quarterly performance reports for direct reports",
      "status": "valid",
      "rejection_reasons": [],
      "similar_tasks": []
    },
    {
      "task_name": "Run",
      "status": "rejected:formatting",
      "rejection_reasons": [
        {
          "code": "too_short"
        },
        {
          "code": "too_few_words"
        }
      ],
      "similar_tasks": []
    }
  ]
}

Authorizations

Authorization

string

header

required

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

Body

application/json

tasks

object[]

required

Candidate Tasks to validate. Between 1 and 15 per request; requests with more than 15 are rejected with 422.

Required array length: 1 - 15 elements

Show child attributes

Response

results

object[]

required

One result per input Task, in the same order as the request.

Show child attributes

Search Tasks Overview

⌘I