Report observability events

POST

/devices/events

• API base path

Batch-ingests observability events (one per MCP tool call). Signed via the X-Device-Signature header.

Parameters

Header Parameters

X-Device-Signature

required

string

Base64 signature over the canonical payload, made with the device key

Request Body ^required

object

events

required

Array<object>

object

event_time

string format: date-time

agent_type

string

Example

claude-code

mcp_name

string

Example

github

tool

string

Example

list_issues

event_type

string

Example

result

result

string

Allowed values: allowed denied error

deny_code

string

deny_reason

string

error_message

string

rule_applied

string

model

string

session_id

string

group

string

actor_email

string format: email

tokens_in

integer

tokens_out

integer

duration_ms

integer

skills

Array<string>

prompt

string

metadata

object

key

additional properties

any

Responses

200

Events accepted

object

accepted

integer

400

Invalid payload or signature