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

basicAcceptReject

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"
    }
  ]
}
'

400

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

Authorizations

Authorization · string · header · required

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

Query Parameters

category · enum<string> · default: skills

The type of suggestions to export or interact with. If not specified, the default category (skills) will be used.

Available options: skills, tasks

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

204

No Content - All interactions were processed successfully.