alpha.decisions1

Analytics3

Anthropic Messages1

API Keys6

Batch4

Benchmarks1

BYOK5

Chat1

Classifications1

Containers4

Credits2

Datasets3

Embeddings2

Endpoints2

Files5

Generations3

Guardrails13

Images3

Interns10

Models4

OAuth4

Observability5

Organization1

Presets7

Providers1

Rerank1

Responses1

SCIM8

STT1

SystemOne1

TTS1

Vault7

Video Generation4

Workspaces12

Interns

List interns

Lists interns visible to the authenticated key, newest first. Filter by workspace and one or more lifecycle statuses. The API key selects the caller, workspace and visible interns. There is no default workspace fallback. Requests on regional hostnames such as eu.openrouter.ai are refused. API key required.

get/interns

Query parameters

limitinteger

Maximum number of interns to return, from 1 through 500.

Example:50

Maximum number of interns to return, from 1 through 500.

statusstring[]

Comma-separated lifecycle statuses to include, at most 8. Repeats are collapsed.

[
  "queued",
  "running"
]

starting_afterstring

The opaque next_cursor of the previous page. Returns the interns that come after it in the newest-first order. A malformed cursor is a 400.

Example:MjAyNi0wOS0xNlQwODozMDowMC4wMDAwMDBafDdjOWU2Njc5LTc0MjUtNDBkZS05NDRiLWUwN2ZjMWY5MGFlNw

The opaque next_cursor of the previous page. Returns the interns that come after it in the newest-first order. A malformed cursor is a 400.

workspace_idstring uuid

Only return interns in this workspace. It must match the API key workspace.

Example:89f9f5b2-3f89-4eaf-83ca-5ceae149e8bb

Only return interns in this workspace. It must match the API key workspace.

Response

Interns matching the filters.

has_moreboolean required

True when more interns match the current filters.

next_cursorstring

Opaque cursor, present when has_more is true. Pass it as starting_after to fetch the next page.

Example response

{
  "data": [
    {
      "attached_vault_id": null,
      "created_at": "2026-09-16T08:30:00.000Z",
      "description": "Researches customer questions",
      "hostname": "research-assistant.openrouter.ai",
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "instructions": null,
      "last_failure_message": null,
      "model": "openai/gpt-5.4",
      "name": "research-assistant",
      "progress": null,
      "status": "running",
      "updated_at": "2026-09-16T08:45:00.000Z",
      "vault_id": "b431c59d-6eed-41ac-bc89-9a89be79a121",
      "workspace_id": "89f9f5b2-3f89-4eaf-83ca-5ceae149e8bb"
    }
  ],
  "has_more": false
}

Changes

Changed in 4 of the 303 revisions of this API.716

Sep 21, 202650d23050da7a6See the full diff
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
Sep 19, 2026b94291e182cc2See the full diff
- ○
  added the new optional query request parameter starting_after
  new-optional-request-parameter
- ○
  added the optional property to the response with the status
  response-optional-property-added
Sep 18, 2026c4cafb1919d177See the full diff
- ▲
  removed the required property // from the response with the status
  response-required-property-removed
- ▲
  removed the required property // from the response with the status
  response-required-property-removed
- ▲
  removed the required property /// from the response with the status
  response-required-property-removed
- ▲
  removed the required property /// from the response with the status
  response-required-property-removed
- ▲
  removed the required property /// from the response with the status
  response-required-property-removed
- ▲
  removed the required property // from the response with the status
  response-required-property-removed
- ▲
  removed the required property // from the response with the status
  response-required-property-removed
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property /// to the response with the status
  response-required-property-added
- ○
  added the required property /// to the response with the status
  response-required-property-added
- ○
  added the required property /// to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
Sep 17, 2026c3b9702bd9d71See the full diff
- ○
  endpoint added
  endpoint-added

Full history