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

# Position

A `Position` is a durable workforce seat. It can be planned, open, filled, or
closed, and it may belong to a workforce plan before a worker exists.

### Attributes

<ResponseField name="id" type="string">
  Unique identifier for the position, e.g. `pos_kP9r2NqW6mT4`.
</ResponseField>

<ResponseField name="object" type="string">
  The object type. Always `position`.
</ResponseField>

<ResponseField name="name" type="string">
  Optional display name for the planned seat.
</ResponseField>

<ResponseField name="status" type="string">
  Position status. One of `draft`, `approved`, `open`, `filled`, or `closed`.
</ResponseField>

<ResponseField name="plan" type="string">
  Workforce plan ID, if the position belongs to a plan.
</ResponseField>

<ResponseField name="job" type="string">
  Job catalog ID for the position.
</ResponseField>

<ResponseField name="worker" type="string">
  Worker ID when the position has been filled.
</ResponseField>

<ResponseField name="location" type="object">
  Position location.
</ResponseField>

<ResponseField name="employer" type="object">
  Employer model for the position. `type` is `employee` or `contractor`.
</ResponseField>

<ResponseField name="starts" type="string">
  Position start date.
</ResponseField>

<ResponseField name="ends" type="string">
  Position end date, if known.
</ResponseField>

<ResponseField name="compensation" type="object">
  Compensation input used for planning and calculations.
</ResponseField>

<ResponseField name="manager" type="string">
  Manager worker ID.
</ResponseField>

<ResponseField name="department" type="string">
  Department ID.
</ResponseField>

<ResponseField name="metadata" type="object">
  Set of key-value pairs attached to the position.
</ResponseField>

<ResponseField name="created" type="string">
  Timestamp of when the position was created.
</ResponseField>

<ResponseField name="updated" type="string">
  Timestamp of when the position was last updated.
</ResponseField>