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

teams

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."
}
'

{
  "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

Success.

boolean

required

data

object

required

Show child attributes

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."
}
'

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

Introduction

System

Teams

Workspaces

Runs

Artifacts

Agents

Settings

Instances

Daemon

Sign-in

Local tokens

HUG

Hub commands

Publish a team to CliqHub

Authorizations

Body

Response