Skip to main content
POST
The event `name`.

Authorizations

Authorization
string
header
required

A user session token or personal API key.

Headers

Connect-Protocol-Version
number
required

Define the version of the Connect protocol

Example:

1

Connect-Timeout-Ms
number

Define the timeout, in ms

Example:

1000

Body

application/json
name
string

Response

Success

Something that happened at time, of a kind the recording service defines, whose facts are its payload. Whether it spans a duration is the kind's own business, in the payload.

cf. OpenTelemetry's event, a named log record (event_name, body); CloudEvents; Golem's worker oplog entry.

name
string

The caller's, so sending it again is the same event: UUID v5 in the OID namespace of the name of what the event is of, such as its Attempt.

kind
string

Which event, as an OpenTelemetry event name the recording service defines, such as outerproduct.run.attempt_started; it fixes the payload's shape.

cf. OTel event_name; CloudEvents type.

service
string

The service that recorded it, as {service}-service names it: run, sandbox.

cf. CloudEvents source; OTel service.name.

principal
string

Whom it happened for: a user, later also a service principal; empty for the deployment's own work.

cf. omicron audit_log.actor_id; OTel enduser.id.

workspace
string

The workspace it happened in; empty for none.

cf. Zitadel resource_owner.

time
string<date-time>

When it happened.

cf. OTel time_unix_nano; CloudEvents time.

Example:

"2023-01-15T01:30:15.01Z"

payload
payload · object

The kind's facts, as the recording service documents them.

cf. OTel log record body; CloudEvents data.

createTime
string<date-time>

When it was recorded.

cf. OTel observed_time_unix_nano.

Example:

"2023-01-15T01:30:15.01Z"