Submit an event

Submits an event; matching notification rules deliver it. Each family needs its fields: run.* / phase.* / hug.* need realm_id, run_id and daemon_id (and phase for phase.*), team.* needs team, daemon.* needs daemon_id. Some types are raised by CliqHub only. The run must be in realm_id, and a daemon may only speak for daemons of its realm. Repeating the same submit is de-duplicated.

Requires a signed-in user token; with realm_id, a realm operator (or higher) on that realm; with org_id, membership in that organization. One of realm_id or org_id is required. A daemon’s realm token (cliq_dt_…) from the same realm may also call it. Run in realm; daemon: own daemons, own org.

POST

events

submit

Submit an event

curl --request POST \
  --url https://{host}/v1/events/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "run.failed",
  "realm_id": "00000000-0000-4000-8000-000000000001",
  "run_id": "00000000-0000-4000-8000-000000000002",
  "daemon_id": "00000000-0000-4000-8000-000000000003",
  "severity": "error",
  "title": "Run failed",
  "message": "phase coder exited non-zero",
  "payload": {
    "run_name": "fix-api",
    "error": "npm test failed",
    "notify": {
      "channels": [
        "slack:ops"
      ]
    }
  }
}
'

import requests

url = "https://{host}/v1/events/submit"

payload = {
    "type": "run.failed",
    "realm_id": "00000000-0000-4000-8000-000000000001",
    "run_id": "00000000-0000-4000-8000-000000000002",
    "daemon_id": "00000000-0000-4000-8000-000000000003",
    "severity": "error",
    "title": "Run failed",
    "message": "phase coder exited non-zero",
    "payload": {
        "run_name": "fix-api",
        "error": "npm test failed",
        "notify": { "channels": ["slack:ops"] }
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    type: 'run.failed',
    realm_id: '00000000-0000-4000-8000-000000000001',
    run_id: '00000000-0000-4000-8000-000000000002',
    daemon_id: '00000000-0000-4000-8000-000000000003',
    severity: 'error',
    title: 'Run failed',
    message: 'phase coder exited non-zero',
    payload: {
      run_name: 'fix-api',
      error: 'npm test failed',
      notify: {channels: ['slack:ops']}
    }
  })
};

fetch('https://{host}/v1/events/submit', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{host}/v1/events/submit",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'type' => 'run.failed',
    'realm_id' => '00000000-0000-4000-8000-000000000001',
    'run_id' => '00000000-0000-4000-8000-000000000002',
    'daemon_id' => '00000000-0000-4000-8000-000000000003',
    'severity' => 'error',
    'title' => 'Run failed',
    'message' => 'phase coder exited non-zero',
    'payload' => [
        'run_name' => 'fix-api',
        'error' => 'npm test failed',
        'notify' => [
                'channels' => [
                                'slack:ops'
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{host}/v1/events/submit"

	payload := strings.NewReader("{\n  \"type\": \"run.failed\",\n  \"realm_id\": \"00000000-0000-4000-8000-000000000001\",\n  \"run_id\": \"00000000-0000-4000-8000-000000000002\",\n  \"daemon_id\": \"00000000-0000-4000-8000-000000000003\",\n  \"severity\": \"error\",\n  \"title\": \"Run failed\",\n  \"message\": \"phase coder exited non-zero\",\n  \"payload\": {\n    \"run_name\": \"fix-api\",\n    \"error\": \"npm test failed\",\n    \"notify\": {\n      \"channels\": [\n        \"slack:ops\"\n      ]\n    }\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{host}/v1/events/submit")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"type\": \"run.failed\",\n  \"realm_id\": \"00000000-0000-4000-8000-000000000001\",\n  \"run_id\": \"00000000-0000-4000-8000-000000000002\",\n  \"daemon_id\": \"00000000-0000-4000-8000-000000000003\",\n  \"severity\": \"error\",\n  \"title\": \"Run failed\",\n  \"message\": \"phase coder exited non-zero\",\n  \"payload\": {\n    \"run_name\": \"fix-api\",\n    \"error\": \"npm test failed\",\n    \"notify\": {\n      \"channels\": [\n        \"slack:ops\"\n      ]\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{host}/v1/events/submit")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"type\": \"run.failed\",\n  \"realm_id\": \"00000000-0000-4000-8000-000000000001\",\n  \"run_id\": \"00000000-0000-4000-8000-000000000002\",\n  \"daemon_id\": \"00000000-0000-4000-8000-000000000003\",\n  \"severity\": \"error\",\n  \"title\": \"Run failed\",\n  \"message\": \"phase coder exited non-zero\",\n  \"payload\": {\n    \"run_name\": \"fix-api\",\n    \"error\": \"npm test failed\",\n    \"notify\": {\n      \"channels\": [\n        \"slack:ops\"\n      ]\n    }\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "ok": true,
  "event": {
    "id": "2d3e4f5a-6b7c-4d8e-9f0a-1b2c3d4e5f6a",
    "type": "run.failed",
    "occurred_at": "2026-10-07T10:25:00Z",
    "realm_id": "5b0c3a7e-2f4d-4b8e-9a51-7c1d2e3f4a5b",
    "org_id": null,
    "team": "code-review",
    "run_id": "0c8d7e6f-5a4b-4c3d-9e2f-1a0b9c8d7e6f",
    "phase": "fix",
    "daemon_id": "7d1c2b3a-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
    "title": "Run failed",
    "message": "npm test failed",
    "severity": "error",
    "payload": {},
    "actor_id": null,
    "created_at": "2026-10-07T10:25:01Z",
    "notifications": "deferred"
  }
}

Authorizations

Authorization

string

header

required

User PAT (cliq_tok_…, including session-scoped) or realm token (cliq_dt_…).

Body

application/json

type

enum<string>

required

Hub catalog type (run.* / phase.* / hug.* / …) or custom.

Available options:

run.started,

run.resumed,

run.resume_requested,

run.completed,

run.failed,

run.crashed,

run.cancelled,

phase.started,

phase.completed,

phase.failed,

phase.skipped,

phase.escalated,

phase.input_required,

phase.inputs_supplied,

phase.timed_out,

phase.idle,

hug.review_requested,

hug.review_reminded,

hug.review_responded,

hug.routing_requested,

hug.review_resolved,

hug.review_expired,

team.published,

team.visibility_changed,

daemon.enrolled,

daemon.removed,

daemon.online,

daemon.offline,

s local hub_outbox dead_count. `dead` events carry
	// a compact cause summary so operators can triage without opening
	// the SPA. Emitted best-effort via the outbox itself; loss on a
	// completely-broken daemon is acceptable because `daemon.offline`
	// covers the total-loss case.

,
	// Org-scoped identity events, raised only by CliqHub itself
	// (notifications/org_events.ts); `events/submit` refuses them.

occurred_at

string

ISO-8601 timestamp; Hub defaults to now when omitted

realm_id

string

Required for most families (see family rules)

org_id

string

Optional org scope

team

string

Team slug; required for team.*

run_id

string

Required for run.* / phase.* / hug.*

phase

string

Required for phase.*

daemon_id

string

Required for run.* / phase.* / hug.* / daemon.*

title

string

Short notification title

message

string

Longer notification body

severity

enum<string>

Overrides catalog default severity when set

Available options:

info,

warn,

error,

critical

payload

object

Type-specific extras (notify routing, names, error, …)

Show child attributes

Response

Success.

enum<boolean>

required

Always true on success.

Available options:

true

event

object

Show child attributes

Submit an event

curl --request POST \
  --url https://{host}/v1/events/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "run.failed",
  "realm_id": "00000000-0000-4000-8000-000000000001",
  "run_id": "00000000-0000-4000-8000-000000000002",
  "daemon_id": "00000000-0000-4000-8000-000000000003",
  "severity": "error",
  "title": "Run failed",
  "message": "phase coder exited non-zero",
  "payload": {
    "run_name": "fix-api",
    "error": "npm test failed",
    "notify": {
      "channels": [
        "slack:ops"
      ]
    }
  }
}
'

import requests

url = "https://{host}/v1/events/submit"

payload = {
    "type": "run.failed",
    "realm_id": "00000000-0000-4000-8000-000000000001",
    "run_id": "00000000-0000-4000-8000-000000000002",
    "daemon_id": "00000000-0000-4000-8000-000000000003",
    "severity": "error",
    "title": "Run failed",
    "message": "phase coder exited non-zero",
    "payload": {
        "run_name": "fix-api",
        "error": "npm test failed",
        "notify": { "channels": ["slack:ops"] }
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    type: 'run.failed',
    realm_id: '00000000-0000-4000-8000-000000000001',
    run_id: '00000000-0000-4000-8000-000000000002',
    daemon_id: '00000000-0000-4000-8000-000000000003',
    severity: 'error',
    title: 'Run failed',
    message: 'phase coder exited non-zero',
    payload: {
      run_name: 'fix-api',
      error: 'npm test failed',
      notify: {channels: ['slack:ops']}
    }
  })
};

fetch('https://{host}/v1/events/submit', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{host}/v1/events/submit",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'type' => 'run.failed',
    'realm_id' => '00000000-0000-4000-8000-000000000001',
    'run_id' => '00000000-0000-4000-8000-000000000002',
    'daemon_id' => '00000000-0000-4000-8000-000000000003',
    'severity' => 'error',
    'title' => 'Run failed',
    'message' => 'phase coder exited non-zero',
    'payload' => [
        'run_name' => 'fix-api',
        'error' => 'npm test failed',
        'notify' => [
                'channels' => [
                                'slack:ops'
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{host}/v1/events/submit"

	payload := strings.NewReader("{\n  \"type\": \"run.failed\",\n  \"realm_id\": \"00000000-0000-4000-8000-000000000001\",\n  \"run_id\": \"00000000-0000-4000-8000-000000000002\",\n  \"daemon_id\": \"00000000-0000-4000-8000-000000000003\",\n  \"severity\": \"error\",\n  \"title\": \"Run failed\",\n  \"message\": \"phase coder exited non-zero\",\n  \"payload\": {\n    \"run_name\": \"fix-api\",\n    \"error\": \"npm test failed\",\n    \"notify\": {\n      \"channels\": [\n        \"slack:ops\"\n      ]\n    }\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{host}/v1/events/submit")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"type\": \"run.failed\",\n  \"realm_id\": \"00000000-0000-4000-8000-000000000001\",\n  \"run_id\": \"00000000-0000-4000-8000-000000000002\",\n  \"daemon_id\": \"00000000-0000-4000-8000-000000000003\",\n  \"severity\": \"error\",\n  \"title\": \"Run failed\",\n  \"message\": \"phase coder exited non-zero\",\n  \"payload\": {\n    \"run_name\": \"fix-api\",\n    \"error\": \"npm test failed\",\n    \"notify\": {\n      \"channels\": [\n        \"slack:ops\"\n      ]\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{host}/v1/events/submit")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"type\": \"run.failed\",\n  \"realm_id\": \"00000000-0000-4000-8000-000000000001\",\n  \"run_id\": \"00000000-0000-4000-8000-000000000002\",\n  \"daemon_id\": \"00000000-0000-4000-8000-000000000003\",\n  \"severity\": \"error\",\n  \"title\": \"Run failed\",\n  \"message\": \"phase coder exited non-zero\",\n  \"payload\": {\n    \"run_name\": \"fix-api\",\n    \"error\": \"npm test failed\",\n    \"notify\": {\n      \"channels\": [\n        \"slack:ops\"\n      ]\n    }\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "ok": true,
  "event": {
    "id": "2d3e4f5a-6b7c-4d8e-9f0a-1b2c3d4e5f6a",
    "type": "run.failed",
    "occurred_at": "2026-10-07T10:25:00Z",
    "realm_id": "5b0c3a7e-2f4d-4b8e-9a51-7c1d2e3f4a5b",
    "org_id": null,
    "team": "code-review",
    "run_id": "0c8d7e6f-5a4b-4c3d-9e2f-1a0b9c8d7e6f",
    "phase": "fix",
    "daemon_id": "7d1c2b3a-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
    "title": "Run failed",
    "message": "npm test failed",
    "severity": "error",
    "payload": {},
    "actor_id": null,
    "created_at": "2026-10-07T10:25:01Z",
    "notifications": "deferred"
  }
}

Introduction

System

Auth

Users

Organizations

Invitations

Teams

Realms

Daemons

Workspaces

Runs

Artifacts

Events

Reviews

Notification channels

Notifications

Agents

Settings

Mesh

Jira

A2A

Submit an event

Authorizations

Body

Response