Sign in
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.

Comma-separated lifecycle statuses to include.

[
  "queued",
  "running"
]
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.

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