Publish a team to CliqHub

Packages the manifest you send (plus dockerfile, dependencies and roles when given) and publishes it to CliqHub as the version in the manifest’s top-level version: field. The local catalog is not read, so a team does not have to be installed to be published.

Use dry_run: true to run every local check (scope, version, sign-in, target CliqHub) without uploading; the reply then has published: false.

force is accepted but has no effect: CliqHub never overwrites a published version (HUB_VERSION_ALREADY_EXISTS).

From the CLI: cliq team publish ./path/to/team --access private.

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.

POST /v1/teams/publish

cURL

publish

curl --request POST \ --url http://127.0.0.1:4900/v1/teams/publish \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "scope": "acme", "slug": "code-review", "manifest": "name: code-review\nversion: 1.5.0\ndescription: Reviews a pull request and posts findings.\nphases:\n - name: review\n agent: claude-code\n", "roles": [ { "name": "reviewer.md", "content": "# Reviewer\nYou review pull requests for correctness." } ], "access": "private", "message": "Adds the reviewer role." } '

200

Example

{ "ok": true, "data": { "scope": "acme", "slug": "code-review", "version": "1.5.0", "registry_url": "https://api.cliqhub.io", "published": true } }

Authorizations

Authorization · string · header · required

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

application/json

scope · string · required

Team scope (org namespace)

Minimum string length: 1

slug · string · required

Team slug

Minimum string length: 1

manifest · string · required

Team manifest (YAML)

Minimum string length: 1

dependencies · string

Dependency manifest

Minimum string length: 1

dockerfile · string

Dockerfile shipped with the team

Minimum string length: 1

roles · object[]

Role files (roles/*.md)

Show child attributes

access · enum<string> · default: public

Hub visibility

Available options: draft, public, private

message · string

Release note

Minimum string length: 1

registry_url · string

Hub registry override

Minimum string length: 1

force · boolean

Publish over an existing version

dry_run · boolean

Validate without publishing

Response

200

application/json

Success.

ok · boolean · required

data · object · required

Show child attributes