Mint a CliqHub token

Creates a CliqHub token as the signed-in user: a user token (cliq_tok_…, the default) for scripts and CI, or a realm token (type: realm, cliq_dt_…) to enroll another daemon in realm_id. The token is shown only in this reply.

From the CLI: cliq auth token ci-runner.

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

auth

token

curl --request POST \
  --url http://127.0.0.1:4900/v1/auth/token \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "label": "ci-runner"
}
'

{
  "ok": true,
  "data": {
    "token": "cliq_tok_4f9a…",
    "name": "ci-runner",
    "id": 42,
    "type": "user"
  }
}

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

label

string

required

Token label

Minimum string length: 1

type

enum<string>

user (default) or realm (daemon enrollment)

Available options:

user,

realm

realm_id

string

Realm the token is scoped to (type realm)

Minimum string length: 1

Response

Success.

boolean

required

data

object

required

Show child attributes

curl --request POST \
  --url http://127.0.0.1:4900/v1/auth/token \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "label": "ci-runner"
}
'

{
  "ok": true,
  "data": {
    "token": "cliq_tok_4f9a…",
    "name": "ci-runner",
    "id": 42,
    "type": "user"
  }
}

Introduction

System

Teams

Workspaces

Runs

Artifacts

Agents

Settings

Instances

Daemon

Sign-in

Local tokens

HUG

Hub commands

Mint a CliqHub token

Authorizations

Body

Response