Basic run

To get an in-depth, cited answer to a question, start a run with the query, wait for it to finish, and read the result. This guide demonstrates that workflow in full. The quickstart shows the shortest path to a result. This guide walks the same request through in more detail, including what the SDKs’ create_and_wait / createAndWait hide from you, and the manual poll a plain REST caller has to do instead.

1. Start a run

create_and_wait / createAndWait call create, then poll until the run finishes, and hand back the completed envelope. cURL has no waiter, so the same request only starts the run. This example also sets effort to "high" for deeper research than the default medium:

from seltz import Seltz

client = Seltz(api_key="your-api-key")

run = client.agent.create_and_wait(
    "What are the three most notable AI-company acquisitions announced in 2026?",
    effort="high",
)

import { Seltz } from "seltz";

const client = new Seltz({ apiKey: "your-api-key" });

let run = await client.agent.createAndWait({
  query: "What are the three most notable AI-company acquisitions announced in 2026?",
  effort: "high",
});

curl -X POST https://api.seltz.ai/v1/agent/runs \
  -H "x-api-key: $SELTZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "What are the three most notable AI-company acquisitions announced in 2026?", "effort": "high"}'

The cURL call returns at once with the run in pending state. output is present but its fields stay unset until the run reaches a terminal state:

{
  "id": "run_01a091ddea6876b390d54cc3f830cd50",
  "object": "agent.run",
  "status": "pending",
  "stop_reason": null,
  "created_at": "2026-09-11T19:07:14Z",
  "started_at": null,
  "completed_at": null,
  "request": {
    "query": "What are the three most notable AI-company acquisitions announced in 2026?",
    "output_schema": null,
    "effort": "high"
  },
  "output": {
    "text": null,
    "structured": null,
    "sources": [],
    "grounding": []
  }
}

2. Poll for the result

Retrieve the run by the id the create call returned. In Python and TypeScript, create_and_wait / createAndWait already did this polling for you above, so run there is already the finished envelope; get is the single check it repeats under the hood, useful on its own when you want to look a run up independently instead of holding onto the object create returned. Over cURL, this is the only way to find out whether the run is done:

run = client.agent.get(run.id)

run = await client.agent.get(run.id);

RUN_ID="your-run-id"  # the id the create response returned

curl "https://api.seltz.ai/v1/agent/runs/$RUN_ID" \
  -H "x-api-key: $SELTZ_API_KEY"

See Poll for completion for the full loop that turns one check into “wait until done,” and for wait’s options. Check status before reading anything from output. A run that hasn’t finished yet comes back as running (or pending), not an error, and output’s fields stay unset, the same status as right after the run is created:

{
  "id": "run_01a091ddea6876b390d54cc3f830cd50",
  "object": "agent.run",
  "status": "running",
  "stop_reason": null,
  "created_at": "2026-09-11T19:07:14Z",
  "started_at": "2026-09-11T19:07:15Z",
  "completed_at": null,
  "request": {
    "query": "What are the three most notable AI-company acquisitions announced in 2026?",
    "output_schema": null,
    "effort": "high"
  },
  "output": {
    "text": null,
    "structured": null,
    "sources": [],
    "grounding": []
  }
}

started_at distinguishes running from pending: it is null while a run waits for a worker, and set the moment one picks up the run. Keep polling until status is completed, failed, or cancelled, or use wait / createAndWait, which does exactly this loop for you. Once the status is completed, a completed run’s output.text is a cited Markdown report, with inline [n] markers pointing at output.sources:

{
  "id": "run_01a091ddea6876b390d54cc3f830cd50",
  "object": "agent.run",
  "status": "completed",
  "stop_reason": "finished",
  "created_at": "2026-09-11T19:07:14Z",
  "started_at": "2026-09-11T19:07:15Z",
  "completed_at": "2026-09-11T19:07:25Z",
  "request": {
    "query": "What are the three most notable AI-company acquisitions announced in 2026?",
    "output_schema": null,
    "effort": "high"
  },
  "output": {
    "text": "## Three most notable AI-company acquisitions announced in 2026\n\nThere is no objective league table for “most notable,” so I ranked these by reported transaction value, strategic significance, and likely industry impact. As of **September 11, 2026**, the strongest candidates are:\n\n1. **SpaceX → Anysphere (Cursor): approximately $60 billion** — announced June 16. The all-stock transaction would make Anysphere, the company behind the AI coding assistant Cursor, a wholly owned SpaceX subsidiary. Cursor was reported to have about **$2.6 billion in annualized B2B revenue**, making this both the largest deal identified in the retrieved results and a major expansion of SpaceX into enterprise AI software and developer tools. [1]\n\n2. **Google → Wiz: $32 billion** — announced in 2025 but **closed in March 2026**, so it is not technically a 2026 announcement. It is nevertheless one of the year’s most consequential AI-adjacent acquisitions: Google’s largest-ever deal brings cloud-security capabilities into Google Cloud as customers increasingly adopt AI and attackers use AI more aggressively. [2]\n\n3. **Nvidia → Hugging Face: approximately $12.9 billion** — reported/agreed in late August and covered in September. The purchase would give Nvidia control of a major platform for distributing, testing, and collaborating on open AI models, datasets, and software. Strategically, it extends Nvidia beyond chips into the developer and open-model ecosystem, while helping it hedge against customers developing their own processors. [3][4]\n\n### Important qualification\nIf “announced in 2026” is interpreted strictly, **Google–Wiz should be excluded**, because the retrieved source says Google announced the intended purchase the previous year; only the closing occurred in 2026. On that strict basis, the retrieved material does not establish a comparably large third deal with enough reliable detail. The Nvidia–Hugging Face transaction is also described in some results as a report or proposed deal rather than a fully documented completed acquisition. [2][4]",
    "structured": null,
    "sources": [
      { "id": 1, "url": "https://www.latestly.com/technology/spacex-to-acquire-ai-coding-startup-cursor-in-usd-60-billion-deal-7475967.html" },
      { "id": 2, "url": "https://www.businessinsider.com/google-closes-wiz-acquisition-cybersecurity-2026-3" },
      { "id": 3, "url": "https://www.pymnts.com/cpi-posts/nvidia-to-buy-hugging-face-for-12-9-billion-in-open-ai-push/" },
      { "id": 4, "url": "https://indiantelevision.com/mam/nvidia-to-acquire-ai-startup-hugging-face-for-12-9-billion-report/" }
    ],
    "grounding": []
  }
}

3. Read the result

In Python and TypeScript, create_and_wait / createAndWait already returned this same envelope, so there is no separate call. Read run.output.text and walk run.output.sources for the citation list:

print(run.output.text)
for source in run.output.sources:
    print(f"[{source.id}] {source.url}")

console.log(run.output?.text);
for (const source of run.output?.sources ?? []) {
  console.log(`[${source.id}] ${source.url}`);
}

Example output

## Three most notable AI-company acquisitions announced in 2026

There is no objective league table for "most notable," so I ranked these by reported transaction value, strategic significance, and likely industry impact. As of **September 11, 2026**, the strongest candidates are:

1. **SpaceX → Anysphere (Cursor): approximately $60 billion** — announced June 16. The all-stock transaction would make Anysphere, the company behind the AI coding assistant Cursor, a wholly owned SpaceX subsidiary. Cursor was reported to have about **$2.6 billion in annualized B2B revenue**, making this both the largest deal identified in the retrieved results and a major expansion of SpaceX into enterprise AI software and developer tools. [1]

2. **Google → Wiz: $32 billion** — announced in 2025 but **closed in March 2026**, so it is not technically a 2026 announcement. It is nevertheless one of the year's most consequential AI-adjacent acquisitions: Google's largest-ever deal brings cloud-security capabilities into Google Cloud as customers increasingly adopt AI and attackers use AI more aggressively. [2]

3. **Nvidia → Hugging Face: approximately $12.9 billion** — reported/agreed in late August and covered in September. The purchase would give Nvidia control of a major platform for distributing, testing, and collaborating on open AI models, datasets, and software. Strategically, it extends Nvidia beyond chips into the developer and open-model ecosystem, while helping it hedge against customers developing their own processors. [3][4]

### Important qualification
If "announced in 2026" is interpreted strictly, **Google–Wiz should be excluded**, because the retrieved source says Google announced the intended purchase the previous year; only the closing occurred in 2026. On that strict basis, the retrieved material does not establish a comparably large third deal with enough reliable detail. The Nvidia–Hugging Face transaction is also described in some results as a report or proposed deal rather than a fully documented completed acquisition. [2][4]

[1] https://www.latestly.com/technology/spacex-to-acquire-ai-coding-startup-cursor-in-usd-60-billion-deal-7475967.html
[2] https://www.businessinsider.com/google-closes-wiz-acquisition-cybersecurity-2026-3
[3] https://www.pymnts.com/cpi-posts/nvidia-to-buy-hugging-face-for-12-9-billion-in-open-ai-push/
[4] https://indiantelevision.com/mam/nvidia-to-acquire-ai-startup-hugging-face-for-12-9-billion-report/

Next steps

Structured output: requesting a JSON result instead of Markdown
List runs: paging this org’s runs, newest first
Poll for completion: managing the wait yourself
Cancel a run: best-effort cancellation, and why it can lose the race to completion
Handle errors: rejected requests versus failed runs
Reference: endpoints, fields, limits and errors
Agent API Reference: full REST request and response specification

Getting Started

Web Tools

Data

Tutorials

Chat

Integrations

SDKs

1. Start a run

2. Poll for the result

3. Read the result

Next steps

​1. Start a run

​2. Poll for the result

​3. Read the result

​Next steps

1. Start a run

2. Poll for the result

3. Read the result

Next steps