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

# Update a position

> Update a workforce position.

### Parameters

<ParamField path="id" type="string" required>
  ID of the position.
</ParamField>

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

<ParamField body="status" type="string">
  Position status.
</ParamField>

<ParamField body="plan" type="string">
  Workforce plan ID.
</ParamField>

<ParamField body="location" type="object">
  Position location.
</ParamField>

<ParamField body="employer" type="object">
  Employer model for the position. Supported types are `employee` and
  `contractor`.
</ParamField>

<ParamField body="starts" type="string">
  Position start date.
</ParamField>

<ParamField body="ends" type="string">
  Position end date.
</ParamField>

<ParamField body="compensation" type="object">
  Compensation input for the position.
</ParamField>

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

### Returns

Returns the updated [Position object](/reference/positions/object).