Install a team from a manifest
Adds a team to this daemon’s catalog from a manifest you supply (the CLI reads
team.yml from disk and sends its text). Use teams/hub_install to install
from CliqHub instead.
What happens, in order:
agent_settings, if sent, are saved asagents.<agent>.<key>settings — so you can supply a missing API key in the same call.- The manifest is parsed and validated (YAML, schema, phase graph).
- Every agent the manifest uses is checked against this daemon
(
TEAM_AGENT_CONFIG_REQUIREDlists what is missing). - Any scope other than
localneeds a CliqHub sign-in. - The team is stored, then settled with CliqHub, which may assign its
CliqHub id. If CliqHub says the team isn’t on this daemon’s realm team list,
it is removed again and the call fails with
TEAM_NOT_IN_REALM.
An installed team is replaced only with force: true; otherwise the call fails
with TEAM_ALREADY_EXISTS. To move an installed team to a newer version, prefer
teams/update, which refuses downgrades.
From the CLI: cliq team install ./path/to/team.
No credential is needed from this machine. From another host, send Authorization: Bearer with a dispatch token CliqHub signed for this daemon or a cliq_tok_… personal token of a user in the daemon’s realm; this only works once the daemon is connected to CliqHub. See Authentication.
Authorizations
Not needed from the same machine. From another host: a dispatch JWT CliqHub signed for this daemon, or a cliq_tok_… personal token whose user is in the daemon's realm.
Body
Team scope (org namespace)
1Team slug
1Team manifest (YAML)
1Team version (default: the manifest's)
1Who placed this install: cli or hub (default: cli)
1Team description (default: the manifest's)
1Dependency manifest
1Agent settings to store as agents.<agent>.<key>
Replace an installed version