access

See the workflow guide for examples. Global flags such as --json go before the command; see global options.

openship access

Manage workspaces, members, invitations and resource grants

openship access [options] [command]

Subcommand	Purpose
`workspaces`	List accessible workspaces and whether this credential can select an organization
`organization`	Show the current organization and member count
`create-team [options] <name>`	Create a team workspace; select its ID with the global --organization option
`resources [options] <type>`	List resources available for permission grants
`members`	Manage membership in the selected workspace
`grants`	Manage per-resource access grants
`invitations`	Manage workspace invitations

Create a team workspace; select its ID with the global --organization option

openship access create-team [options] <name>

Argument	Meaning
`name`	Workspace name

Option	Meaning
`--slug <slug>`	Workspace slug

Manage per-resource access grants

openship access grants [options] [command]

Subcommand	Purpose
`list <user>`	List a user's resource grants
`set <file>`	Create or update one resource grant
`replace [options] <file>`	Replace a user's complete resource grant set
`remove <id>`	Revoke one resource grant

List a user's resource grants

openship access grants list [options] <user>

Argument	Meaning
`user`	User ID

Revoke one resource grant

openship access grants remove [options] <id>

Argument	Meaning
`id`	Grant ID

Replace a user's complete resource grant set

openship access grants replace [options] <file>

Argument	Meaning
`file`	JSON object with userId and the complete grants array

Option	Meaning
`-y, --yes`	Skip confirmation

Create or update one resource grant

openship access grants set [options] <file>

Argument	Meaning
`file`	JSON grant with userId, resourceType, resourceId and permissions

Manage membership in the selected workspace

openship access members [options] [command]

Subcommand	Purpose
`list`	List workspace members
`role <id> <role>`	Change a member's role through the shared permission rules
`remove [options] <id>`	Remove a workspace member

List workspace members

openship access members list [options]

Remove a workspace member

openship access members remove [options] <id>

Argument	Meaning
`id`	Member ID

Option	Meaning
`-y, --yes`	Skip confirmation

Change a member's role through the shared permission rules

openship access members role [options] <id> <role>

Argument	Meaning
`id`	Member ID
`role`	owner \| admin \| member \| restricted

Show the current organization and member count

openship access organization [options]

List resources available for permission grants

openship access resources [options] <type>

Argument	Meaning
`type`	Resource type

Option	Meaning
`--owner <id>`	Resource owner filter

List accessible workspaces and whether this credential can select an organization

openship access workspaces [options]