Lint (advisory) - Alakazam

POST

/

v1

/

worlds

/

{id}

/

lint

Lint (advisory)

curl --request POST \
  --url https://api.alakazam.gg/v1/worlds/{id}/lint \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "ok": true,
  "diagnostics": [
    {
      "lint": "<string>",
      "path": "<string>",
      "message": "<string>",
      "loc": {
        "field": "<string>",
        "template": "<string>",
        "slot": "<string>",
        "fill": "<string>"
      }
    }
  ],
  "counts": {
    "error": 123,
    "warning": 123,
    "info": 123
  },
  "promptBudget": 1900
}

Authorizations

Authorization

string

header

required

An app API key, e.g. Authorization: Bearer sk_live_…. Secret (sk_) for writes/sessions; publishable (pk_) for read/embed.

Path Parameters

id

string<uuid>

required

Body

application/json

Optional override; omit to lint the stored world.

world

object

A playable world. The full contract is published as JSON Schema at https://alakazam.gg/schema/smworld-1.0.json (see schema/COMPATIBILITY.md). Additional optional properties are allowed (forward-compatible).

Show child attributes

data

object

A playable world. The full contract is published as JSON Schema at https://alakazam.gg/schema/smworld-1.0.json (see schema/COMPATIBILITY.md). Additional optional properties are allowed (forward-compatible).

Show child attributes

Response

Lint report

ok

boolean

diagnostics

object[]

Show child attributes

counts

object

Show child attributes

promptBudget

integer

The per-prompt character budget assembled prompts must stay under.

Example:

1900

Edit the graph from natural languageRun the kernel agent server-side: describe the change in prose and the agent authors it, then the SAME fail-closed kernel gate every deterministic write passes must bless the result before it persists. This is real LLM spend — one unit is reserved against your daily `edit` quota BEFORE the agent runs, and refunded on a validation reject, agent error, or concurrency conflict. RESULT-ONLY: the response is exactly `world`, `diagnostics`, and `reply` — the agent's system prompt, op grammar, lexicon, model id, and raw op trace are never exposed. If the agent needs clarification it returns the question in `reply` and leaves the world unchanged. Pass an `Idempotency-Key` so a retry doesn't double-charge.

⌘I

Lint (advisory)

curl --request POST \
  --url https://api.alakazam.gg/v1/worlds/{id}/lint \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "ok": true,
  "diagnostics": [
    {
      "lint": "<string>",
      "path": "<string>",
      "message": "<string>",
      "loc": {
        "field": "<string>",
        "template": "<string>",
        "slot": "<string>",
        "fill": "<string>"
      }
    }
  ],
  "counts": {
    "error": 123,
    "warning": 123,
    "info": 123
  },
  "promptBudget": 1900
}