Team roles

The roles that define what each dashboard user can do.

Command	HTTP	Description
team-roles list	GET /v1/team_roles	List team roles
team-roles create	POST /v1/team_roles	Create a custom role
team-roles get	GET /v1/team_roles/{id}	Get a role
team-roles update	PATCH /v1/team_roles/{id}	Update a role
team-roles delete	DELETE /v1/team_roles/{id}	Remove a role

Examples

--params carries query and path parameters (id, page, filters); --json carries the request body; --fields limits which fields come back — worth using on every list/get to save context. See Global flags for the full reference.

# List team roles
kobana billing team-roles list \
  --fields "id,public_id,organization_id,name,slug"

# Get a role
kobana billing team-roles get --params '{"id": "TEAM_ROLE_ID"}'

# Create a custom role
kobana billing team-roles create \
  --json '{"name": "NAME", "slug": "billing_manager", "permissions": []}'

# Update a role
kobana billing team-roles update \
  --params '{"id": "TEAM_ROLE_ID"}' \
  --json '{"name": "NAME", "slug": "SLUG", "description": "DESCRIPTION"}'

# Remove a role
kobana billing team-roles delete --params '{"id": "TEAM_ROLE_ID"}' --dry-run

Next steps

• Schema introspection — every parameter this resource accepts.