Workday · Schema

Position

Represents a position in Workday. A position defines a role within a supervisory organization and can be filled by a worker.

Cloud ComputingEnterprise SoftwareFinancial ManagementHCMSaaS

Properties

Name	Type	Description
id	string	The Workday ID of the position.
descriptor	string	A display descriptor for the position.
positionID	string	The position reference ID (e.g., P-00001).
jobProfile	object	The job profile associated with this position.
jobProfileName	string	The name of the job profile.
businessTitle	string	The business title for this position.
supervisoryOrganization	object	The supervisory organization this position belongs to.
worker	object	The worker currently filling this position, if any.
positionTimeType	object	The time type for the position (e.g., Full Time, Part Time).
workerType	object	The worker type for this position (e.g., Employee, Contingent Worker).
workerSubType	object	The worker sub-type for the position.
location	object	The primary work location for the position.
compensationGrade	object	The compensation grade associated with this position.
payRateType	object	The pay rate type (e.g., Salary, Hourly).
isFilled	boolean	Whether the position is currently filled by a worker.
isAvailableForRecruit	boolean	Whether the position is available for recruiting.
isClosed	boolean	Whether the position has been closed.
isFrozen	boolean	Whether the position is frozen.
headcountCount	integer	The headcount for this position.
availableDate	stringnull	The date the position becomes available.
earliestHireDate	stringnull	The earliest allowed hire date.
href	string	A link to the full position resource.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://workday.com/schemas/position.json",
  "title": "Position",
  "description": "Represents a position in Workday. A position defines a role within a supervisory organization and can be filled by a worker.",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The Workday ID of the position."
    },
    "descriptor": {
      "type": "string",
      "description": "A display descriptor for the position."
    },
    "positionID": {
      "type": "string",
      "description": "The position reference ID (e.g., P-00001)."
    },
    "jobProfile": {
      "$ref": "#/$defs/ResourceReference",
      "description": "The job profile associated with this position."
    },
    "jobProfileName": {
      "type": "string",
      "description": "The name of the job profile."
    },
    "businessTitle": {
      "type": "string",
      "description": "The business title for this position."
    },
    "supervisoryOrganization": {
      "$ref": "#/$defs/ResourceReference",
      "description": "The supervisory organization this position belongs to."
    },
    "worker": {
      "$ref": "#/$defs/ResourceReference",
      "description": "The worker currently filling this position, if any."
    },
    "positionTimeType": {
      "$ref": "#/$defs/ResourceReference",
      "description": "The time type for the position (e.g., Full Time, Part Time)."
    },
    "workerType": {
      "$ref": "#/$defs/ResourceReference",
      "description": "The worker type for this position (e.g., Employee, Contingent Worker)."
    },
    "workerSubType": {
      "$ref": "#/$defs/ResourceReference",
      "description": "The worker sub-type for the position."
    },
    "location": {
      "$ref": "#/$defs/ResourceReference",
      "description": "The primary work location for the position."
    },
    "compensationGrade": {
      "$ref": "#/$defs/ResourceReference",
      "description": "The compensation grade associated with this position."
    },
    "payRateType": {
      "$ref": "#/$defs/ResourceReference",
      "description": "The pay rate type (e.g., Salary, Hourly)."
    },
    "isFilled": {
      "type": "boolean",
      "description": "Whether the position is currently filled by a worker."
    },
    "isAvailableForRecruit": {
      "type": "boolean",
      "description": "Whether the position is available for recruiting."
    },
    "isClosed": {
      "type": "boolean",
      "description": "Whether the position has been closed."
    },
    "isFrozen": {
      "type": "boolean",
      "description": "Whether the position is frozen."
    },
    "headcountCount": {
      "type": "integer",
      "description": "The headcount for this position."
    },
    "availableDate": {
      "type": ["string", "null"],
      "format": "date",
      "description": "The date the position becomes available."
    },
    "earliestHireDate": {
      "type": ["string", "null"],
      "format": "date",
      "description": "The earliest allowed hire date."
    },
    "href": {
      "type": "string",
      "format": "uri",
      "description": "A link to the full position resource."
    }
  },
  "required": ["id", "descriptor"],
  "$defs": {
    "ResourceReference": {
      "type": "object",
      "description": "A reference to a Workday resource.",
      "properties": {
        "id": {
          "type": "string",
          "description": "The Workday ID of the referenced resource."
        },
        "descriptor": {
          "type": "string",
          "description": "A display descriptor for the referenced resource."
        },
        "href": {
          "type": "string",
          "format": "uri",
          "description": "A link to the referenced resource."
        }
      }
    }
  }
}