{"command":{"effect":"read","timeoutSeconds":30,"inputSchema":{"type":"object","description":"To list simulation runs, send a GET request to `/v2/gen-ai/simulation_runs`.","properties":{"query":{"type":"object","properties":{"scenario_set_uuid":{"type":"string","examples":["123e4567-e89b-12d3-a456-426614174000"],"description":"Optional filter by scenario set."},"page":{"type":"integer","examples":[1],"description":"Page number."},"per_page":{"type":"integer","examples":[1],"description":"Items per page."},"statuses":{"items":{"enum":["SIMULATION_RUN_STATUS_UNSPECIFIED","SIMULATION_RUN_STATUS_PENDING","SIMULATION_RUN_STATUS_RUNNING","SIMULATION_RUN_STATUS_SUCCEEDED","SIMULATION_RUN_STATUS_FAILED","SIMULATION_RUN_STATUS_CANCELLED","SIMULATION_RUN_STATUS_EVALUATING","SIMULATION_RUN_STATUS_PARTIALLY_SUCCESSFUL"],"type":"string"},"type":"array","examples":[["SIMULATION_RUN_STATUS_RUNNING"]],"description":"Filter by one or more statuses. Empty means no status filter.\n\n - SIMULATION_RUN_STATUS_PENDING: Accepted and queued, not yet executing.\n - SIMULATION_RUN_STATUS_RUNNING: Episodes are executing.\n - SIMULATION_RUN_STATUS_SUCCEEDED: All episodes finished successfully.\n - SIMULATION_RUN_STATUS_FAILED: The run failed, for example because of a timeout or workflow error.\n - SIMULATION_RUN_STATUS_CANCELLED: The run was cancelled.\n - SIMULATION_RUN_STATUS_EVALUATING: Episodes finished and an attached evaluation is running. Only reachable\nwhen the create request included evaluation_config. When the evaluation\nreaches a terminal status, its outcome is reflected in the simulation run\nstatus.\n - SIMULATION_RUN_STATUS_PARTIALLY_SUCCESSFUL: The simulation or its attached evaluation completed with a mixture of\nsuccessful and failed results."},"search":{"type":"string","examples":["example string"],"description":"Free-text search across the run name and scenario set name\n(case-insensitive substring match). Empty means no search."},"sort_by":{"default":"SIMULATION_RUN_SORT_FIELD_UNSPECIFIED","enum":["SIMULATION_RUN_SORT_FIELD_UNSPECIFIED","SIMULATION_RUN_SORT_FIELD_CREATED_AT","SIMULATION_RUN_SORT_FIELD_NAME","SIMULATION_RUN_SORT_FIELD_STATUS","SIMULATION_RUN_SORT_FIELD_UPDATED_AT"],"type":"string","examples":["SIMULATION_RUN_SORT_FIELD_UNSPECIFIED"],"description":"Field to sort by. Defaults to creation date when unspecified.\n\n - SIMULATION_RUN_SORT_FIELD_CREATED_AT: Sort by creation date. Default.\n - SIMULATION_RUN_SORT_FIELD_NAME: Sort by customer-supplied run name (case-insensitive).\n - SIMULATION_RUN_SORT_FIELD_STATUS: Sort by status using lifecycle order (pending → running → terminal).\n - SIMULATION_RUN_SORT_FIELD_UPDATED_AT: Sort by last update date."},"sort_direction":{"default":"SORT_DIRECTION_UNSPECIFIED","enum":["SORT_DIRECTION_UNSPECIFIED","SORT_DIRECTION_ASC","SORT_DIRECTION_DESC"],"type":"string","examples":["SORT_DIRECTION_UNSPECIFIED"],"description":"Sort direction. Defaults to descending when unspecified."}},"required":[],"additionalProperties":false}},"required":[],"additionalProperties":false},"name":"List Simulation Runs","id":"digitalocean.genai_list_simulation_runs","example":{},"maxRequests":1,"summary":false}}