Skip to main content
POST
/
job_architecture
/
changes
Bulk generate Job changes
curl --request POST \
  --url https://{tenant_name}.{region}.techwolf.ai/job_architecture/changes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "change_type": "add_job_description",
  "context": {
    "instructions": "Please use inclusive language and highlight remote work opportunities",
    "reference_job_ids": [
      "5cbdbdbe-5f44-4423-8157-5fgqsef7b834c",
      "62d2c013-ab77-410e-b5fb-2f96eed9c1db"
    ],
    "sections_to_include": [
      "Summary",
      "Responsibilities"
    ],
    "use_internal_job_data": true
  },
  "job_ids": [
    "a3903505-eb84-42dc-a79f-5e7b1fe897b7"
  ]
}
'
{
  "batch_id": "01JZ54E33R9F4154Z8WCTYVSHT"
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
change_type
enum<string>
required

Type of change made to a Job.

Available options:
add_job_description
Example:

"add_job_description"

​
context
object
required

Additional context information for Job changes

​
job_ids
string<uuid>[]
required

List of Job external IDs to create changes for

The unique ID in your system, consisting of alphanumeric characters, hyphens and underscores.

Required string length: 1 - 100

Response

Accepted

​
batch_id
string
required

Unique identifier for the batch of created Job changes

Example:

"01JZ54E33R9F4154Z8WCTYVSHT"