Skip to main content

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.

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

​
id
string
Unique identifier for the position, e.g. pos_kP9r2NqW6mT4.
​
object
string
The object type. Always position.
​
name
string
Optional display name for the planned seat.
​
status
string
Position status. One of draft, approved, open, filled, or closed.
​
plan
string
Workforce plan ID, if the position belongs to a plan.
​
job
string
Job catalog ID for the position.
​
worker
string
Worker ID when the position has been filled.
​
location
object
Position location.
​
employer
object
Employer model for the position. type is employee or contractor.
​
starts
string
Position start date.
​
ends
string
Position end date, if known.
​
compensation
object
Compensation input used for planning and calculations.
​
manager
string
Manager worker ID.
​
department
string
Department ID.
​
metadata
object
Set of key-value pairs attached to the position.
​
created
string
Timestamp of when the position was created.
​
updated
string
Timestamp of when the position was last updated.