KeelsonDocs
    Judge Mode

    API reference Operators

    Turn a sentence into the coverage grid's state

    POST/v1/operators/{agentId}/grid-query

    The backend of AG Grid's AI Toolkit: Claude answers with structured output in the grid's own state schema. The console's daily model budget applies; past it the query runs on claude-haiku-5-5.

    Path parameters

    agentIdstringRequired
    The operator's ERC-8004 agent id, a decimal integer.

    Headers

    Content-Typeapplication/jsonRequired
    Idempotency-KeystringRequired
    1 to 255 characters. A retry with the same key returns the first answer.

    Request body

    application/json

    promptstringRequired
    gridStateobjectRequired
    schemaobjectRequired
    gridApi.getStructuredSchema(), the JSON Schema of grid state.

    Responses

    • 200The new state
    • 401No session
    • 403The session's wallets do not own the agent
    • 429Too many queries, or today's budget is spent
    • 502The model did not answer
    • 503No model provider configured

    200 response

    gridStateobjectRequired
    propertiesToIgnorearray of stringRequired
    explanationstringRequired
    modelstringRequired
    costMicrosintegerRequired
    What the query cost, in USD micros.