DocsAccount and teamsWorkspaces and members

Workspaces and members

A workspace holds a project's boards, policies, workflows and integrations. Invite people to it and give each of them a role that says what they can do.

How it fits together

Your accountplan, usage and billing are shared here
Workspace · Greenhouse clients, policies, workflows, integrations, audit log
Members · each with one or more roles, everywhere or in this workspace only
Workspace · Workshop

Invite someone

  1. Open Members from the workspace menu and choose Invite.
  2. Enter their email and pick a role. They get a link that works once.
  3. They sign in or sign up, and land in the workspace.
OwnerEvery workspace has one owner, who can't be removed. To leave a workspace you own, transfer ownership first.

Roles

Roles are sets of permissions. Every account starts with two: User, who can see everything in a workspace but change nothing, and Admin, who can do everything. Make your own for anything in between, like a role that can send commands but not edit workflows.

A role given everywhere applies in every workspace of the account; one given in a workspace applies only there.

PermissionLets youUserAdmin
clients.readSee clients, readings and state
clients.updateRename, tag and pause clients
clients.commandSend commands
clients.pingPing a client
clients.firmwareSend firmware updates
clients.manageApprove, delete and rotate secrets
policies.readSee policies
policies.manageCreate, change and disable policies
templates.readSee message templates
templates.manageChange message templates
workflows.readSee workflows and runs
workflows.createCreate workflows
workflows.updateEdit and publish workflows
workflows.executeRun, cancel and signal runs
workflows.deleteDeprecate and delete workflows
integrations.readSee integrations
integrations.manageAdd, change and delete integrations
logs.readRead the audit log and comms
users.readSee members
users.manageInvite, change and remove members
roles.readSee roles
roles.manageCreate and change roles
workspace.joinJoin workspaces of the account

When you're not allowed

A workspace you aren't in answers WORKSPACE_FORBIDDEN, whether or not it exists. Inside a workspace, a missing permission answers PERMISSION_UNAUTHORIZED, and the console hides or greys out what you can't do.

Plan limits

Free includes 1 workspace and 1 member, Maker 3 and 3, Pro 10 and 10, Team 25 and 25, Business 50 and 50. See Plans and billing.