Skip to content
Hexel StudioDocs

Permissions

The IAM actions the Titan Harness checks, and what each organization role can do by default.

Every harness request is checked against your organization's policies. The organization comes from the access token; X-Workspace-Id and X-Environment-Id select where the request acts and never grant access by themselves.

Organization roles give harness access by default: Owners have every action, Admins have every harness:* action, Members can apply agents and work with their own tasks, and Viewers can read. For a service user, attach a policy with only the actions it needs.

ActionWhat it allowsOwnerAdminMemberViewer
harness:agent:readList agents, versions and channels✓✓✓✓
harness:agent:applyApply a spec bundle as a new version✓✓✓
harness:agent:promotePoint and roll back channels; promotions✓✓
harness:task:createCreate tasks, estimates and forks✓✓✓
harness:task:readRead tasks, runs, events and the attention inbox✓✓ownown
harness:task:steerSteer a task and answer its questions✓✓own
harness:task:controlPause, resume, retry and cancel tasks; cancel swarms and resolve members✓✓own
harness:task:deleteDelete tasks✓✓own
harness:approval:decideForward an approval decision to Titan✓✓own
harness:task:adminAct on every person's tasks, not only your own✓✓
harness:swarm:runStart swarms✓✓✓
harness:artifact:readList and download artifacts✓✓ownown
harness:trigger:manageCreate, change, delete and fire triggers✓✓
harness:webhook:manageCreate, change, delete and test webhooks✓✓
harness:environment:adminData retention settings and legal holds✓✓
harness:audit:readCreate and download evidence packs✓✓
harness:agent:checkPost CI check results (promotions, on request)✓✓

"own" means the task the person created: without harness:task:admin, a caller sees and acts only on their own tasks.

Some actions need more than one permission:

  • A trigger's PUT and :fire also need harness:task:create: its tasks are its maker's.
  • A fork needs harness:task:read and harness:task:create.
  • A swarm estimate needs harness:task:create and harness:swarm:run.
  • Deciding an approval also needs Titan to accept your decision (Approvals and autonomy).
  • Downloading an evidence pack also needs Titan permissions (Evidence packs).