Skip to main content
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, describes the responsibilities it carries. Reading positions needs workforce:read; creating, assigning and changing them needs org:manage.
Positions (dark)Positions (light)

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

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. 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.
  • Job roles — the jobs a position is attached to.
  • Agents — the agents that hold agent seats, and their readiness.
  • People — the people who hold seats.
  • Org Chart — the organization draft where archive, restore, moves and renames are published.