List Job Architecture Changes
curl --request GET \
  --url https://{tenant_name}.{region}.techwolf.ai/job_architecture/changes \
  --header 'Authorization: Bearer <token>'
{
  "count": 2,
  "results": [
    {
      "external_id": "6129e3f1-663f-44ea-aa3f-2ce1077b834c",
      "change_type": "add_job_description",
      "change_status": "suggested",
      "change_data": {
        "job_id": "72d2c013-ab77-410e-b5fb-2f96eed9c1db",
        "job_description": "The Front-End Developer is responsible for implementing visual elements that users interact with on the company's web applications..."
      },
      "context": {
        "instructions": "Please update the Job description to be more inclusive and highlight remote work opportunities",
        "reference_job_ids": [
          "5cbdbdbe-5f44-4423-8157-5fgqsef7b834c"
        ],
        "sections_to_include": [
          "Summary",
          "Responsibilities",
          "Qualifications"
        ],
        "use_internal_job_data": true
      }
    },
    {
      "external_id": "22d2c013-ab77-410e-b5fb-2f96eed9c1db",
      "change_type": "add_job_description",
      "change_status": "saved",
      "change_data": {
        "job_id": "62d2c013-ab77-410e-b5fb-2f96eed9c1db",
        "job_description": "The Customer Service Representative is responsible for providing exceptional support to customers by addressing inquiries, resolving complaints, and ensuring overall customer satisfaction...",
        "job_description_id": "123e4567-e89b-12d3-a456-426614174000"
      },
      "context": {
        "instructions": null,
        "reference_job_ids": [
          "62d2c013-ab77-410e-b5fb-2f96eed9c1db"
        ],
        "sections_to_include": [
          "Summary",
          "Responsibilities"
        ],
        "use_internal_job_data": false
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
limit
integer
default:100

The maximal number of entities returned, ordered by the last_updated field and external_id.

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

50

​
offset
integer
default:0

The applied offset for returned entities, results starting from offset up to offset + limit.

Required range: x >= 0
​
job_id
string<uuid>[]

Filter the changes by Job External IDs. This parameter can be added multiple times to include more Jobs.

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

​
include
enum<string>[]

Additional data to include in the response. Use 'context' to include context information for each change.

Response

OK

​
count
integer
required

Total number of Job architecture changes.

Required range: x >= 0
Example:

2

​
results
Job changes · object[]
required

Subset of Job changes starting from offset up to offset + limit.

Example:
[
  {
    "external_id": "6129e3f1-663f-44ea-aa3f-2ce1077b834c",
    "change_type": "add_job_description",
    "change_status": "suggested",
    "change_data": {
      "job_id": "72d2c013-ab77-410e-b5fb-2f96eed9c1db",
      "job_description": "The Front-End Developer is responsible for implementing visual elements that users interact with on the company's web applications..."
    },
    "context": {
      "instructions": "Please update the Job description to be more inclusive and highlight remote work opportunities",
      "reference_job_ids": ["5cbdbdbe-5f44-4423-8157-5fgqsef7b834c"],
      "sections_to_include": [
        "Summary",
        "Responsibilities",
        "Qualifications"
      ],
      "use_internal_job_data": true
    }
  },
  {
    "external_id": "22d2c013-ab77-410e-b5fb-2f96eed9c1db",
    "change_type": "add_job_description",
    "change_status": "saved",
    "change_data": {
      "job_id": "62d2c013-ab77-410e-b5fb-2f96eed9c1db",
      "job_description": "The Customer Service Representative is responsible for providing exceptional support to customers by addressing inquiries, resolving complaints, and ensuring overall customer satisfaction...",
      "job_description_id": "123e4567-e89b-12d3-a456-426614174000"
    },
    "context": {
      "instructions": null,
      "reference_job_ids": ["62d2c013-ab77-410e-b5fb-2f96eed9c1db"],
      "sections_to_include": ["Summary", "Responsibilities"],
      "use_internal_job_data": false
    }
  }
]