apiome teams
Global options such as --base-url, --tenant and --json go before the command — see CLI reference. Exit codes are listed in Exit codes.
apiome teams
Teams: who owns catalog entities and is notified about their findings.
apiome teams [OPTIONS] COMMAND [ARGS]...
Subcommands: assign, create, list, members, show.
apiome teams assign
Make a team the confirmed owner of an entity (PUT …/owners/{kind}/{id}).
The previous confirmed owner, if any, is replaced; findings for the entity are routed to the new team. An unknown team or entity is refused with REST's message and exits 2; an unknown kind is a usage error (exit 2) caught before any call.
apiome teams assign [OPTIONS] KIND ENTITY_ID
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
KIND | text | yes | Entity kind: project, catalog_item, mcp_endpoint, consumer, connector. |
ENTITY_ID | text | yes | The entity's id. |
Options
| Option | Type | Default | Required | Description |
|---|---|---|---|---|
--team | text | yes | Slug of the team that will own it. | |
--format | text | table | Output: table (default) or json (the API response). |
apiome teams create
Create a team (POST …/teams). The slug cannot be changed afterwards.
A taken slug or a malformed field is refused by REST and exits 2.
apiome teams create [OPTIONS] NAME
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
NAME | text | yes | The team's display name. |
Options
| Option | Type | Default | Required | Description |
|---|---|---|---|---|
--slug | text | Permanent slug (default: derived from the name). Gateway tags owner:<slug> use it. | ||
--description | text | What the team does. | ||
--contact-email | text | The team's contact address. | ||
--chat-url | text | Chat channel link (absolute http(s) URL). | ||
--oncall-url | text | On-call / paging link (absolute http(s) URL). | ||
--docs-url | text | Team docs or runbook link (absolute http(s) URL). | ||
--format | text | table | Output: table (default) or json (the API response). |
apiome teams list
List the workspace's teams with their member counts and owner links (GET …/teams).
apiome teams list [OPTIONS]
Options
| Option | Type | Default | Required | Description |
|---|---|---|---|---|
--format | text | table | Output: table (default) or json (the API response). |
apiome teams members
List a team's members, or replace them (PUT …/teams/{slug}/members).
With no option the members are listed. --set sends the complete new membership — it does not add to the current one — and --clear empties the team. Every user must belong to the workspace, otherwise REST refuses the whole change (exit 2) and nothing changes.
apiome teams members [OPTIONS] SLUG
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
SLUG | text | yes | Team slug. |
Options
| Option | Type | Default | Required | Description |
|---|---|---|---|---|
--set | text (repeatable) | USER_ID[:lead|:member] (repeatable; default role member). Replaces the whole membership: anyone not listed is removed. | ||
--clear | flag | Remove every member (cannot be combined with --set). | ||
--format | text | table | Output: table (default) or json (the API response). |
apiome teams show
Show one team: its owner links and members, leads first (GET …/teams/{slug}).
apiome teams show [OPTIONS] SLUG
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
SLUG | text | yes | Team slug. |
Options
| Option | Type | Default | Required | Description |
|---|---|---|---|---|
--format | text | table | Output: table (default) or json (the API response). |