curl --request POST \
  --url https://{tenant_name}.{region}.techwolf.ai/job_architecture/suggestions/interactions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "interactions": [
    {
      "suggestion_id": "550e8400-e29b-41d4-a716-446655440000",
      "state": "accepted"
    },
    {
      "suggestion_id": "660e8400-e29b-41d4-a716-446655440001",
      "state": "rejected"
    }
  ]
}
'

[
  {
    "title": "400 Bad Request",
    "description": "The request body was not structured correctly."
  }
]

[
  {
    "title": "401 Unauthorized",
    "description": "OAuth access token is missing, invalid or expired."
  }
]

[
  {
    "title": "403 Forbidden",
    "description": "You don't have access to this resource."
  }
]

[
  {
    "title": "405 Method Not Allowed",
    "description": "This method is not allowed for the requested URL."
  }
]

"max connections reached: <limit>"

[
  {
    "title": "503 Service Unavailable",
    "description": "The Skill Engine API is currently not available. Please contact TechWolf or try again later."
  }
]

Suggestions

Bulk Accept or Reject Job Architecture Suggestions

Accept or reject multiple suggestions in a single request.

Use the category query parameter to choose between skill suggestions (default) and task suggestions.

Skill suggestions (category=skills):

When a skill suggestion is accepted, the corresponding change is applied to the job’s governed skill profile:

add_job_skill: Adds the skill to the job’s skill profile with validation_state: validated
remove_job_skill: Marks the skill as rejected on the job’s skill profile
set_job_skill_proficiency: Updates the skill’s proficiency level
set_job_skill_criticality: Updates the skill’s critical flag

Task suggestions (category=tasks):

When a task suggestion is accepted, the task is added to the job’s task profile:

add_job_task: Adds the task to the job’s task profile

The data.weekly_hours field is required for all task suggestion interactions.

Side Effects (skill suggestions only):

Accepting a set_job_skill_proficiency or set_job_skill_criticality suggestion will automatically accept the corresponding add_job_skill suggestion for the same skill if it exists.

Overriding Values (skill suggestions only):

When accepting a set_job_skill_proficiency suggestion, you can optionally provide a different proficiency_level in the data field to override the suggested value.
When accepting a set_job_skill_criticality suggestion, you can optionally provide a different critical value in the data field to override the suggested value.

curl --request POST \
  --url https://{tenant_name}.{region}.techwolf.ai/job_architecture/suggestions/interactions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "interactions": [
    {
      "suggestion_id": "550e8400-e29b-41d4-a716-446655440000",
      "state": "accepted"
    },
    {
      "suggestion_id": "660e8400-e29b-41d4-a716-446655440001",
      "state": "rejected"
    }
  ]
}
'

[
  {
    "title": "400 Bad Request",
    "description": "The request body was not structured correctly."
  }
]

[
  {
    "title": "401 Unauthorized",
    "description": "OAuth access token is missing, invalid or expired."
  }
]

[
  {
    "title": "403 Forbidden",
    "description": "You don't have access to this resource."
  }
]

[
  {
    "title": "405 Method Not Allowed",
    "description": "This method is not allowed for the requested URL."
  }
]

"max connections reached: <limit>"

[
  {
    "title": "503 Service Unavailable",
    "description": "The Skill Engine API is currently not available. Please contact TechWolf or try again later."
  }
]

Authorizations

Authorization

string

header

required

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

Query Parameters

Body

application/json

Skills
Tasks

Request body for bulk accepting or rejecting job architecture suggestions.

interactions

object[]

required

List of suggestion interactions to process.

Minimum array length: 1

Show child attributes

Example:

[
  {
    "suggestion_id": "550e8400-e29b-41d4-a716-446655440000",
    "state": "accepted"
  },
  {
    "suggestion_id": "660e8400-e29b-41d4-a716-446655440001",
    "state": "rejected"
  },
  {
    "suggestion_id": "770e8400-e29b-41d4-a716-446655440002",
    "state": "accepted",
    "data": { "proficiency_level": 3 }
  }
]

Response

No Content - All interactions were processed successfully.

Overview Overview

⌘I

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

Bulk Accept or Reject Job Architecture Suggestions

Authorizations

Query Parameters

Body

Response