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

# Workforce plan

A `Workforce::Plan` is a persistent hiring or headcount scenario. It groups
positions over a planning window and can point to the latest immutable workforce
calculation snapshot.

### Attributes

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

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

<ResponseField name="name" type="string">
  Human-readable plan name.
</ResponseField>

<ResponseField name="status" type="string">
  Plan status. One of `draft`, `approved`, or `archived`.
</ResponseField>

<ResponseField name="starts" type="string">
  Start date for the planning window.
</ResponseField>

<ResponseField name="ends" type="string">
  End date for the planning window.
</ResponseField>

<ResponseField name="frequency" type="string">
  Planning frequency. Currently `monthly`.
</ResponseField>

<ResponseField name="currency" type="string">
  Three-letter ISO currency code used for plan-level calculation rollups.
</ResponseField>

<ResponseField name="positions" type="array">
  Positions currently attached to the plan.
</ResponseField>

<ResponseField name="calculation" type="string">
  ID of the latest calculation snapshot attached to the plan.
</ResponseField>

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

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

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