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

# Positions

> List positions by status and holder, create one by form or with the Position Architect, allow agents to hold it, assign an agent, set its prompt, and manage its assignments, archive and restore.

**Workforce → Organization → Positions** (`/workforce/positions`) lists the positions in your organization. A position is a seat in an org unit, held by a person or an agent or vacant; its job, set from [Job roles](https://docs.gloo.com/forge/console/workforce/job-roles.md), describes the responsibilities it carries. Reading positions needs `workforce:read`; creating, assigning and changing them needs `org:manage`.

![Positions (light)](https://mintcdn.com/gloo-b243725a/ahnDPYAsbo1iROpN/forge/images/console/workforce/positions-light.png?fit=max\&auto=format\&n=ahnDPYAsbo1iROpN\&q=85\&s=016861b8d3738500dfc80e287f1128de)

Positions — Forge Console at `/workforce/positions`

## What you can do

* Filter the list by **Position status** (**Active positions**, **Archived positions** or **All positions**) and by who holds the seat: **All**, **Agent**, **Person**, **Vacant** or **Agent seats**.
* Create a position with **New Position**.
* Turn agent assignment on or off for a position, and **Assign** an agent to an agent-assignable seat.
* Add or edit a position's prompt, and unassign its current holder, from the row's **Position actions** menu.
* Open a position to read its details and manage its assignment history, archive or restore it.

## The positions list

| Column | What it shows |
| - | - |
| **Title** | The position's title and description |
| **Team** | The org unit the position sits in |
| **Job** | The job role the position is attached to |
| **Status** | `OPEN`, `FILLED` or another status, such as `INACTIVE` for an archived position |
| **Agent** | A switch: on when an agent may hold the seat. Archived positions cannot be switched |
| **Current Assignee** | The person or agent in the seat. An agent holder carries a readiness pill that links to its **Ready to run** checklist |
| **Actions** | **Assign**, and the **Position actions** menu |

**Agent seats** keeps agent-held positions and vacant positions that allow an agent. **Assign** is disabled until agent assignment is on, and opens a picker of active agent workers. Turning agent assignment on does not assign an agent by itself.

The **Position actions** menu offers **Add prompt** or **Edit prompt**, and on a filled position, **Unassign**, which asks you to confirm. A position prompt is position-specific context, for example "You are on the Growth team. Prioritize acquisition experiments this sprint."

## Creating a position

**New Position** opens **Create position** (`/workforce/positions/create`) with two choices:

* **Manual form** — fill in the title, description, team, reporting structure, job and whether an agent may hold the seat.
* **Position Architect** — describe the position in plain language. The Architect asks clarifying questions and creates the record.

## Position detail

Open a position (`/workforce/positions/<positionId>`) to see:

* **Details** — status, job, who holds the seat, team (linked to the org unit) and whether it is agent-assignable.
* **Current Assignment** — the holder, with **View Agent** or **View Profile**.
* **Configuration** — whether a prompt is set.
* Assignment history — each assignment with its holder, org unit, dates and whether it is open-ended, ended or superseded. With `org:manage` you can **Add assignment**, **Edit dates / kind** (`PRIMARY` or `SECONDARY`), **Vacate / end**, or **Reassign primary**. A seat can stay unassigned.
* **Archive position** or **Restore position**, which previews what depends on the position before you confirm. The change is saved to the organization draft; follow **Review and publish draft** to publish it on the [Org Chart](https://docs.gloo.com/forge/console/workforce/org-chart). **Move / rename in organization draft** goes there too.

A position that no longer exists, or that you cannot see, shows **Position not found**.

## Key state to watch

* **Vacant positions** — open seats with no holder.
* **Readiness pills** on agent holders — an agent that is not ready cannot do the seat's work.
* **Agent seats with agent assignment off** — **Assign** stays disabled until it is turned on.

## Related surfaces

* [Job roles](https://docs.gloo.com/forge/console/workforce/job-roles.md) — the jobs a position is attached to.
* [Agents](https://docs.gloo.com/forge/console/workforce/agents) — the agents that hold agent seats, and their readiness.
* [People](https://docs.gloo.com/forge/console/workforce/people.md) — the people who hold seats.
* [Org Chart](https://docs.gloo.com/forge/console/workforce/org-chart) — the organization draft where archive, restore, moves and renames are published.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.