Skip to content
Scope

List requests

GET
/api/v1/requests
 
curl --request GET \
  --url 'https://example.com/api/v1/requests?groupBy=task&last=true&sortBy=created&sortDir=asc&turnsOp=eq&maxIterationsOp=eq&projectId=00000000-0000-0000-0000-000000000000'

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
worker
Any of:
string
taskPromptId
string
criteria
string
submissionId
string
profileId
Any of:
string
status
Any of:
string
outcome
Any of:
string
model
Any of:
string
os
Any of:
string
priority
Any of:
string
agentVersion
Any of:
string
search
string
groupBy
string
Allowed values: task submissionId profile
limit
integer
>= 1 <= 100
after
string
before
string
last
string
Allowed values: true false
sortBy
string
Allowed values: created updated priority worker status id duration createdAt
sortDir
string
Allowed values: asc desc
createdAfter
string | null format: date-time
createdBefore
string | null format: date-time
turns
integer | null
turnsOp
string
Allowed values: eq gte lte
maxIterations
integer | null
maxIterationsOp
string
Allowed values: eq gte lte
projectId
required

Project scope. Required on scoped list and root-create operations; requests without a resolvable project are rejected with 400. There is no default project.

string
>= 1 characters
Example 
00000000-0000-0000-0000-000000000000

Project scope. Required on scoped list and root-create operations; requests without a resolvable project are rejected with 400. There is no default project.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Success

Media type application/json
Any of:
object
data
required
Array<object>
object
_id
required
string
scenario
required
object
version
string
Allowed values: v1 v2
task
required
string
criteria
required
Array<string>
workerType
required
string
model
string
reasoningEffort
string
createdAt
required
string | null format: date-time
updatedAt
string | null format: date-time
maxIterations
number
personaInstructions
string
persona
object
personality
required
string
Allowed values: demanding friendly
experience
required
string
Allowed values: junior senior
verbosity
required
string
Allowed values: brief moderate
type
required
string
Allowed values: traditional ai_assisted vibe
deletedAt
string | null format: date-time
taskPromptId
string
agentsMdPromptId
string
agentsMdParentIds
Array<string>
mcpServers
Array<string>
skillRevisions
Array<string>
codebaseRevisionId
string
extensions
Array<string>
agentVersion
string
profileId
string
profileVersionId
string
submissionId
string
priority
integer
0
gates
Array<object>
object
gate
required
string
Allowed values: select build test run deploy
promptId
string
promptText
string
criteria
required
Array<string>
maxIterations
integer
>= 1 <= 50
gateSummaries
Array<object>
object
gate
required
string
Allowed values: select build test run deploy
status
required
string
Allowed values: passed failed skipped
iterations
required
integer
run
object
_id
required
string
attemptNumber
required
integer
>= 1
status
required
string
Allowed values: pending queued processing paused done
queuedQueueName
string
outcome
string
Allowed values: succeeded failed finished
result
string
error
string
logsUrl
string
updatedAt
string | null format: date-time
startedAt
string | null format: date-time
finishedAt
string | null format: date-time
durationMs
number
turns
Array<object>
object
iteration
required
number
gate
string
Allowed values: select build test run deploy
codingAgentResponse
string
judgeFeedback
required
string
snapshotUrl
required
string
passed
required
boolean
timestamp
required
string | null format: date-time
criteriaResults
Array<object>
object
criterionId
required
string
passed
required
boolean
feedback
required
string
evaluated
required
boolean
harUrl
string
videoUrls
Array<string>
tokenUsage
object
promptTokens
required
number
completionTokens
required
number
totalTokens
required
number
startedAt
string | null format: date-time
durationMs
number
toolCalls
Array<object>
object
id
required
string
name
required
string
arguments
required
object
key
additional properties
response
string
timestamp
string
toolCallsUrl
string
toolCallCount
number
aiCallCount
number
rawChatUrl
string
rawChatFormat
string
chatResultUrl
string
chatResultFormat
string
workerVersion
string
os
object
platform
required
string
release
required
string
arch
required
string
lastHeartbeatAt
string | null format: date-time
worker
object
instanceId
required
string
podName
string
harUrl
string
videoUrls
Array<string>
setupVideoUrls
Array<string>
tokenUsage
object
promptTokens
required
number
completionTokens
required
number
totalTokens
required
number
aiCallCount
number
rawChatUrl
string
rawChatFormat
string
pausedAt
string | null format: date-time
resumedAt
string | null format: date-time
projectId
required
string
limit
required
number
estimatedTotal
required
number
cursors
required
object
next
required
string | null
prev
required
string | null
Example 
{
  "data": [
    {
      "scenario": {
        "version": "v1"
      },
      "persona": {
        "personality": "demanding",
        "experience": "junior",
        "verbosity": "brief",
        "type": "traditional"
      },
      "priority": 0,
      "gates": [
        {
          "gate": "select"
        }
      ],
      "gateSummaries": [
        {
          "gate": "select",
          "status": "passed"
        }
      ],
      "run": {
        "status": "pending",
        "outcome": "succeeded",
        "turns": [
          {
            "gate": "select"
          }
        ]
      }
    }
  ]
}