MOmodjo
Agents

Get an agent run

Changed on

Returns a background run started by POST /agents/ask: its status while it runs, then its output once completed or its error once failed. Runs are kept 7 days.

get/agents/ask/{runUuid}

Request

  • Base URL
    https://api.modjo.ai/v2
  • URL
    https://api.modjo.ai/v2/agents/ask/{runUuid}
  • Auth
    HTTP bearer

Path parameters

runUuidstring uuid required

Run UUID, returned by POST /agents/ask in background mode

Example:01a17e2e-975f-739d-9953-d6f664bb35e0

Response

Agent run

uuidstring uuid required

Run UUID, to read the run with GET /agents/ask/{runUuid}.

status'queued' | 'processing' | 'completed' | 'failed' required

queued until a worker picks the run, processing while the AI answers (retries included), then completed or failed.

outputobject

The AI-generated answer once the run is completed, shaped by responseFormat.json_schema.schema. A field the data does not answer is null.

createdOnstring date-time required

When the run was created.

finishedOnstring date-time nullable required

When the run reached completed or failed, null before.

expiresOnstring date-time required

The run is deleted after this date, 7 days after its creation.

Example response

{
  "uuid": "01a17e2e-975f-739d-9953-d6f664bb35e0",
  "status": "completed",
  "scope": {
    "id": 1
  },
  "output": {
    "budget": "50k EUR",
    "nextStep": null
  },
  "createdOn": "2026-10-27T16:25:45.034Z",
  "finishedOn": "2026-10-27T16:26:03.872Z",
  "expiresOn": "2026-11-03T16:25:45.000Z"
}

Changes