> ## Documentation Index > Fetch the complete documentation index at: https://docs.getcliq.io/llms.txt > Use this file to discover all available pages before exploring further. # Update an installed team > Replaces an installed team's manifest (and `description` / `dependencies` when sent; omitted ones are kept). Versions only move forward: when both the new and the installed version are set, the new one must be strictly higher (semver). Unlike `teams/install`, update does not re-check agent requirements and ignores `agent_settings` and `force` even though it accepts them. From the CLI: `cliq team update ./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](/daemon-api/overview#authentication). ## OpenAPI ````yaml /openapi/daemon-by-tag/daemon-teams.yaml post /v1/teams/update openapi: 3.1.0 info: title: cliqd API version: 1.9.48 description: >- HTTP API of `cliqd`, the local Cliq daemon. Generated from the daemon source by `scripts/generate_daemon_openapi.mjs` — do not edit by hand. See the [overview](/daemon-api/overview). servers: - url: http://127.0.0.1:4900 description: Local daemon (default port; `CLIQ_DAEMON_PORT` changes it) security: [] tags: - name: Daemon Teams description: >- The daemon's **local team catalog**: the teams this cliqd can run. Install a team from a manifest you hold (`teams/install`) or from CliqHub (`teams/hub_install`), read it back, update it, remove it, and publish manifests to CliqHub. A team is addressed by **scope + slug** (`@acme/code-review` → `scope: "acme"`, `slug: "code-review"`). The scope `local` is offline-only: it needs no CliqHub sign-in and can never be published. Every other scope needs `cliq login` first. paths: /v1/teams/update: post: tags: - Daemon Teams summary: Update an installed team description: >- Replaces an installed team's manifest (and `description` / `dependencies` when sent; omitted ones are kept). Versions only move forward: when both the new and the installed version are set, the new one must be strictly higher (semver). Unlike `teams/install`, update does not re-check agent requirements and ignores `agent_settings` and `force` even though it accepts them. From the CLI: `cliq team update ./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](/daemon-api/overview#authentication). operationId: daemon_post_teams_update requestBody: required: true content: application/json: schema: type: object properties: scope: type: string minLength: 1 description: Team scope (org namespace) slug: type: string minLength: 1 description: Team slug manifest: type: string minLength: 1 description: Team manifest (YAML) version: description: 'Team version (default: the manifest''s)' type: string minLength: 1 origin: description: 'Who placed this install: cli or hub (default: cli)' type: string minLength: 1 description: description: 'Team description (default: the manifest''s)' type: string minLength: 1 dependencies: description: Dependency manifest type: string minLength: 1 agent_settings: description: Agent settings to store as `agents..` type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: string force: description: Replace an installed version type: boolean latest: description: When multiple versions exist, target the latest type: boolean required: - scope - slug - manifest examples: bump: summary: Move to 1.5.0 value: scope: acme slug: code-review manifest: | name: code-review version: 1.5.0 description: Reviews a pull request and posts findings. phases: - name: review agent: claude-code version: 1.5.0 responses: '200': description: The team after the update. content: application/json: schema: type: object required: - ok - data properties: ok: type: boolean const: true data: $ref: '#/components/schemas/Team' example: ok: true data: scope: acme slug: code-review team_id: 3f6c2a8e-6b1d-4c1e-9a57-0d2f4b8e91c4 version: 1.5.0 description: Reviews a pull request and posts findings. manifest: | name: code-review version: 1.5.0 description: Reviews a pull request and posts findings. phases: - name: review agent: claude-code dockerfile: null dependencies: null created_at: 1759830000000 updated_at: 1759833600000 '400': description: >- `PAYLOAD_INVALID` — The body (query string for `GET`) fails the request schema. `details` lists each issue. `BAD_REQUEST` — The body is not valid JSON or is larger than the route allows (10 MB; artifact uploads more). content: application/json: schema: $ref: '#/components/schemas/ErrorReply' examples: PAYLOAD_INVALID: summary: PAYLOAD_INVALID value: ok: false error: code: PAYLOAD_INVALID message: >- scope: Invalid input: expected string, received undefined; slug: Invalid input: expected string, received undefined; manifest: Invalid input: expected string, received undefined details: - path: scope message: 'Invalid input: expected string, received undefined' - path: slug message: 'Invalid input: expected string, received undefined' - path: manifest message: 'Invalid input: expected string, received undefined' BAD_REQUEST: summary: BAD_REQUEST value: ok: false error: code: BAD_REQUEST message: >- Request body could not be read: Unexpected token } in JSON at position 12 '401': description: >- `UNAUTHORIZED` — A caller on another host sent no `Authorization: Bearer` token, or one that does not verify (expired, wrong audience). content: application/json: schema: $ref: '#/components/schemas/ErrorReply' examples: UNAUTHORIZED: summary: UNAUTHORIZED value: ok: false error: code: UNAUTHORIZED message: Missing or invalid Authorization Bearer token '403': description: >- `WEB_REQUEST_REFUSED` — The request carries an `Origin` header (it came from a web page). `HOST_NOT_LOCAL` — A loopback caller addressed a `Host` other than localhost (DNS rebinding guard). `LOCAL_ONLY` — The daemon isn't connected to CliqHub (no dispatch key) and the caller is on another host. `FORBIDDEN` — A `cliq_tok_…` token's user is not in this daemon's realm ACL, or the ACL is not loaded yet. content: application/json: schema: $ref: '#/components/schemas/ErrorReply' examples: WEB_REQUEST_REFUSED: summary: WEB_REQUEST_REFUSED value: ok: false error: code: WEB_REQUEST_REFUSED message: cliqd doesn't accept requests from web pages HOST_NOT_LOCAL: summary: HOST_NOT_LOCAL value: ok: false error: code: HOST_NOT_LOCAL message: cliqd only answers requests addressed to localhost LOCAL_ONLY: summary: LOCAL_ONLY value: ok: false error: code: LOCAL_ONLY message: >- This cliqd isn't connected to CliqHub yet, so from another machine it only accepts a local token (minted by tokens/create on the machine running cliqd) FORBIDDEN: summary: FORBIDDEN value: ok: false error: code: FORBIDDEN message: Access denied — identity not in realm ACL '404': description: |- `SCOPE_NOT_FOUND` — This daemon has never seen the scope. `TEAM_NOT_FOUND` — No team with this scope and slug is installed. content: application/json: schema: $ref: '#/components/schemas/ErrorReply' examples: SCOPE_NOT_FOUND: summary: SCOPE_NOT_FOUND value: ok: false error: code: SCOPE_NOT_FOUND message: Scope not found TEAM_NOT_FOUND: summary: TEAM_NOT_FOUND value: ok: false error: code: TEAM_NOT_FOUND message: Team 'acme/code-review' not found '409': description: >- `TEAM_VERSION_CONFLICT` — `version` is equal to or lower than the installed version. content: application/json: schema: $ref: '#/components/schemas/ErrorReply' examples: TEAM_VERSION_CONFLICT: summary: TEAM_VERSION_CONFLICT value: ok: false error: code: TEAM_VERSION_CONFLICT message: >- Version '1.4.0' is the same as the current version. Bump the version to update. '422': description: '`TEAM_MANIFEST_INVALID` — The new manifest fails validation.' content: application/json: schema: $ref: '#/components/schemas/ErrorReply' examples: TEAM_MANIFEST_INVALID: summary: TEAM_MANIFEST_INVALID value: ok: false error: code: TEAM_MANIFEST_INVALID message: Team manifest failed validation '500': description: >- `INTERNAL_ERROR` — An unexpected daemon fault. The message names the request id; the cause is in the cliqd log. content: application/json: schema: $ref: '#/components/schemas/ErrorReply' examples: INTERNAL_ERROR: summary: INTERNAL_ERROR value: ok: false error: code: INTERNAL_ERROR message: >- cliqd hit an unexpected error (request 7f3a…). Details are in the cliqd log. security: - {} - DaemonBearer: [] components: schemas: Team: type: object description: A team in this daemon's catalog. required: - scope - slug - team_id - version - description - manifest - dockerfile - dependencies - created_at - updated_at properties: scope: type: string description: Scope (org namespace) the team is published under, without the `@`. example: acme slug: type: string description: Team slug, unique within its scope. example: code-review team_id: type: string format: uuid description: > Team id. Matches CliqHub's id once the team is registered with CliqHub; a team installed offline keeps a local id until the next reconcile, which may replace it. example: 3f6c2a8e-6b1d-4c1e-9a57-0d2f4b8e91c4 version: type: - string - 'null' description: >- Semver of the installed manifest, or `null` when the manifest has none. example: 1.4.0 description: type: - string - 'null' description: One-line description (from the request, else the manifest). example: Reviews a pull request and posts findings. manifest: type: string description: The full team manifest (`team.yml`) as YAML text. example: | name: code-review version: 1.4.0 phases: - name: review agent: claude-code dockerfile: type: - string - 'null' description: Dockerfile shipped with the team, if any. example: null dependencies: type: - string - 'null' description: >- Dependency manifest (`dependencies.yml`) shipped with the team, if any. example: null created_at: type: integer format: int64 description: >- When the team was first installed on this daemon (epoch milliseconds). example: 1759830000000 updated_at: type: integer format: int64 description: >- When the team was last installed, updated or re-bound (epoch milliseconds). example: 1759833600000 ErrorReply: type: object description: >- Every failure. Switch on `error.code` — it is stable; `message` is for people and may change. required: - ok - error properties: ok: type: boolean const: false error: type: object required: - code - message properties: code: type: string description: Stable error code. See [Errors](/daemon-api/errors). example: TEAM_NOT_FOUND message: type: string description: What went wrong and, where possible, what to do. example: Team 'acme/code-review' not found details: description: >- Structured detail when there is some: the list of schema issues for `PAYLOAD_INVALID`, the agent problems for `TEAM_AGENT_CONFIG_REQUIRED`, … securitySchemes: DaemonBearer: type: http scheme: bearer description: >- 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. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.