Upload an artifact

Uploads a file a run produced to CliqHub and returns its id and a download link. Agents call this through the SDK. The run must be running or awaiting_input. Send text as UTF-8 in content, or binary as base64 with encoding: "base64".

Size: an artifact may be up to 50 MB (CLIQ_ARTIFACT_MAX_MB changes it), text or binary. This route accepts request bodies big enough for that limit once base64 encoded (about 68 MB by default); every other route stays at 10 MB.

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

runs

artifacts

submit

curl --request POST \
  --url http://127.0.0.1:4900/v1/runs/artifacts/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "run_id": "0c8d7e6f-5a4b-4c3d-9e2f-1a0b9c8d7e6f",
  "phase": "review",
  "name": "review.md",
  "content": "## Findings\n\n1. Token in config.ts\n",
  "mime_type": "text/markdown",
  "description": "Findings from the review phase"
}
'

{
  "ok": true,
  "data": {
    "artifact_id": "8f7e6d5c-4b3a-4291-8e7f-6a5b4c3d2e1f",
    "name": "review.md",
    "download_url": "https://files.cliqhub.io/a/8f7e6d5c?sig=…",
    "size_bytes": 2048
  }
}

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

run_id

required

Run id or run name

phase

required

Phase that produced the artifact

name

required

Artifact file name

content

string

required

Content (UTF-8, or base64 with encoding)

mime_type

any

Content type

description

any

Human description

encoding

any

base64 when content is base64-encoded

{key}

any

Response

Success.

boolean

required

data

object

required

Show child attributes

curl --request POST \
  --url http://127.0.0.1:4900/v1/runs/artifacts/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "run_id": "0c8d7e6f-5a4b-4c3d-9e2f-1a0b9c8d7e6f",
  "phase": "review",
  "name": "review.md",
  "content": "## Findings\n\n1. Token in config.ts\n",
  "mime_type": "text/markdown",
  "description": "Findings from the review phase"
}
'

{
  "ok": true,
  "data": {
    "artifact_id": "8f7e6d5c-4b3a-4291-8e7f-6a5b4c3d2e1f",
    "name": "review.md",
    "download_url": "https://files.cliqhub.io/a/8f7e6d5c?sig=…",
    "size_bytes": 2048
  }
}

Introduction

System

Teams

Workspaces

Runs

Artifacts

Agents

Settings

Instances

Daemon

Sign-in

Local tokens

HUG

Hub commands

Upload an artifact

Authorizations

Body

Response