List runs

To see every run your organization has started or find one you lost track of the ID for, list runs instead of tracking IDs yourself. list pages this org’s runs, newest first, unpaged beyond the cursor. Page size is limit (1-100, default 20); pass the previous page’s next as after to continue.

page = client.agent.list(limit=20)

for run in page.runs:
    print(run.id, run.status)

# Next page
if page.next:
    next_page = client.agent.list(limit=20, after=page.next)

const page = await client.agent.list({ limit: 20 });

for (const run of page.runs) {
  console.log(run.id, run.status);
}

// Next page
if (page.next) {
  const nextPage = await client.agent.list({ limit: 20, after: page.next });
}

curl "https://api.seltz.ai/v1/agent/runs?limit=20" \
  -H "x-api-key: $SELTZ_API_KEY"

next is unset on the last page. There is no has_more field on this listing. An unset next is the signal to stop.

Next steps

Poll for completion: managing the wait yourself
Cancel a run: best-effort cancellation, and why it can lose the race to completion
Reference: endpoints, fields, limits and errors
Agent API Reference: full REST request and response specification

Getting Started

Web Tools

Data

Tutorials

Integrations

SDKs

Next steps

​Next steps

Next steps