> ## 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.

# How It Works

## Data Flow

* Publishing a Job's primary description in the TechWolf Console triggers a
  real-time push: TechWolf converts the description to Workday rich text and
  updates the matching Job Profile through Workday's `Submit_Job_Profile` web
  service ([Human\_Resources, v46.1 <Icon icon="link" iconType="solid" />](https://community.workday.com/sites/default/files/file-hosting/productionapi/Human_Resources/v46.1/Human_Resources.html)). Only Job Profiles whose Job is known to
  TechWolf and carries a published TechWolf description are synchronized —
  TechWolf overwrites those descriptions in Workday with the published version
  on our side, and leaves every other Job Profile in your tenant as is.
* A weekly reconciliation pass re-checks every job in scope and re-applies the
  published description wherever Workday has drifted.
* Before every update, TechWolf reads the current Workday description
  [`Get_Job_Profiles` v46.1 <Icon icon="link" iconType="solid" />](https://community.workday.com/sites/default/files/file-hosting/productionapi/Human_Resources/v46.1/Get_Job_Profiles.html)
  and only writes when it differs from the published version — an unchanged
  description produces no Workday write at all.

## What Is Written

Each update submits only the `Job_Description` field of
`Job_Profile_Basic_Data`. Skill qualifications and all other job-profile fields
are separate elements of the Workday payload and are never included. The
integration never creates job profiles (an update for a profile that no longer
exists in Workday is skipped, not re-created) and never deletes anything — a job
removed from TechWolf simply stops being updated.

## Business Process Behavior

Every update is a *Manage Job Profile* business process event initiated by the
Integration System User and completed automatically as an external load — each
one is recorded in the profile's process history like any other change.

* If a Manage Job Profile event started by one of your admins is still pending
  on a profile, the integration's update is deflected by Workday. TechWolf
  records it as skipped and retries on the next cycle — the sync for that
  profile simply pauses until your event completes or is canceled. TechWolf
  never cancels or overrides events in your tenant.
* TechWolf confirms every update by re-reading the profile after the write; an
  update is only considered successful once the re-read shows the published
  description.

## Recoverability

Every update is an effective-dated Manage Job Profile event, so Workday's change
history retains the prior description of every profile — nothing is destroyed by
an update. A Workday admin can rescind or correct any event to reverse it, and
your TechWolf team can assist with broader restores on request.