Trigger a game event

Authorization

AuthorizationBearer <token>

API key issued to a Sonzai project. Format: Bearer sk_....

In: header

Path Parameters

agentId*string

Agent UUID or URL-encoded agent name

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

event_description?string

Human-readable event description

event_type*string

Type of game event (e.g. session_end, achievement, milestone)

instance_id?string

Agent instance scope

language?string

Language code for diary generation (default: en)

messages?unknown

Raw recent chat messages for diary context

metadata?

Event metadata (achievement_id, milestone_type, etc.)

user_id*string

ID of the user triggering the event

Response Body

`application/json`

`application/problem+json`

curl -X POST "https://loading/api/v1/agents/string/events" \  -H "Content-Type: application/json" \  -d '{    "event_type": "string",    "user_id": "string"  }'

{
  "$schema": "/api/v1/schemas/TriggerEventOutputBody.json",
  "accepted": true,
  "event_id": "string"
}

{
  "$schema": "/api/v1/schemas/ErrorModel.json",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "string",
      "message": "string",
      "value": null
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}

Events