> ## Documentation Index
> Fetch the complete documentation index at: https://developers.techwolf.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Jobs

## Jobs datasource specification

This page describes the file-based datasource specification for syncing **Jobs**
and their **Vacancies** into TechWolf when no standardized connector (such as
Workday or SAP SuccessFactors) is available. It defines the files TechWolf
expects, the fields within each file, and which fields are required.

Use this specification when a customer exports Job data from any source system
to flat files. As long as the data can be shaped into the files below, TechWolf
can ingest it.

Jobs are referenced by Employees: the Employee Baseline points to a Job through
`assigned_position`, and Internal Work History points to a Job through `job_id`
(see the
[Employees](/integrations/datasource-integrations/non-standard-datasource-integrations/employees)
specification). A Job referenced there must be synced through the Job
Information file below.

For the broader picture of how file-based integrations work and how they compare
to API-based connectors, see
[Key concepts](/integrations/datasource-integrations/datasources-key-concepts).

The delivery flow over SFTP and S3, the file locations, and how to read the
field tables below are described in
[Technical data flow](/integrations/datasource-integrations/non-standard-datasource-integrations/technical-data-flow).

<AccordionGroup>
  <Accordion title="Job Information" icon="briefcase">
    The baseline Job file. **Required.** Contains the Jobs (and their architecture
    hierarchy) that TechWolf infers skills for.

    File on S3:
    `.../file_based/TechWolf_Job_Information/TechWolf_Job_Information_[yyyy][MM][dd]_[HH][mm][ss].csv`

    | TechWolf field | Required | Key | Max chars | Notes |
    | - | - | - | - | - |
    | job\_id | Required | Primary key | 100 | External ID of the file. ID of the Job. |
    | job\_title | Required | | 255 | |
    | job\_description | Recommended | | No limit | |
    | skill\_requirements | Recommended | | No limit | |
    | job\_hierarchy\_level\_1 | Recommended | | 255 | Top level of the Job architecture. |
    | job\_hierarchy\_level\_2 | Recommended | | 255 | |
    | job\_hierarchy\_level\_2\_ID | Recommended | | 100 | |
    | job\_hierarchy\_level\_2\_description | Recommended | | No limit | |
    | active | Recommended | | n/a | Job assumed to be active if no value is given. |
  </Accordion>

  <Accordion title="Job Vacancies" icon="magnifying-glass">
    Open Vacancies (Job Requisitions) linked to Jobs. **Highly recommended.**
    Vacancy text is a strong signal for skill inference.

    File on S3:
    `.../file_based/TechWolf_Job_Requisition/TechWolf_Job_Requisition_[yyyy][MM][dd]_[HH][mm][ss].csv`

    | TechWolf field | Required | Key | Max chars | Notes |
    | - | - | - | - | - |
    | requisition\_id | Required | Primary key | 100 | External ID of the file. ID of the Vacancy. |
    | job\_id | Recommended | Foreign key | 100 | Job linked to the Vacancy, used for skill inference. |
    | job\_title | Required | | 255 | |
    | job\_description | Required | | No limit | |
    | job\_requisition\_inactive | Recommended | | n/a | |
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.