Get a specific LLM provider

GET

/v1/providers/{id}

const url = 'https://app.everruns.com/api/v1/providers/example';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://app.everruns.com/api/v1/providers/example

Parameters

Path Parameters

required

string

Provider ID (prefixed, e.g., prov_…)

Responses

200

Provider found

application/json

Wrapper that adds API and UI links to a serialized resource.

Uses self_url (not url) for the API link to avoid collision with resources that already have a url field (e.g. McpServer). The allowed_actions array carries state-aware hypermedia links — empty (and omitted from the wire shape) until the underlying resource opts into the convention by overriding ResourceUrlable::allowed_actions.

object

api_key_set

required

Whether an API key is configured. The key itself is never returned.

boolean

base_url

Custom base URL for self-hosted / proxied providers. None means use the provider’s default endpoint.

string | null

created_at

required

Timestamp when this provider was created (RFC 3339).

string format: date-time

required

Prefixed public identifier. See ID Schema.

string

last_synced_at

Timestamp of the most recent successful model sync from the provider’s API (RFC 3339).

string | null format: date-time

name

required

Human-readable provider name. Safe to render in user-facing messages.

string

provider_type

required

Provider implementation type (OpenAI, Anthropic, Gemini, etc.).

string

status

required

Current lifecycle status of this provider.

string

Allowed values: active disabled

trace

One of:

null
object

null

Resolved trace/observability link configuration: the driver’s default templates overlaid with this provider’s stored overrides. None when the driver exposes no dashboard and the org configured nothing.

object

enabled

required

Whether trace links should be shown for this provider. Defaults to false: vendors typically do not retain trace content unless logging is explicitly enabled, so the org opts in once that is set up.

boolean

generation_url_template

URL template for a single generation’s trace, e.g. "https://openrouter.ai/logs?id={response_id}".

string | null

session_url_template

URL template for a session’s grouped trace, e.g. "https://openrouter.ai/logs".

string | null

updated_at

required

Timestamp when this provider was last updated (RFC 3339).

string format: date-time

allowed_actions

State-aware hypermedia actions the caller can take on this resource next (e.g. cancel, events, update). Omitted from the wire shape when empty so resources that haven’t opted into the convention don’t grow their payloads.

Array<object>

Agent-actionable link describing a follow-up the caller can take. Used in two contexts:

Error recovery — ErrorResponse.allowed_actions carries rels like retry, retry-later, unarchive, get-existing so the agent knows the right next call after a 4xx/429.
Entity hypermedia — WithUrls<T>.allowed_actions carries state-aware rels like cancel, events, self, update on the entity itself so the agent can follow links instead of reconstructing routes from prose.

The shape is intentionally identical across both contexts; the closed rel vocabulary documented in specs/api-conventions.md distinguishes them.

object

hint

Short, agent-readable hint (e.g. “Shorten ‘name’ to <= 200 chars.”, “Cancel the active turn for this session.”).

string | null

href

Absolute (preferred) or relative URL the caller may invoke directly. Always present on entity hypermedia actions (WithUrls<T>.allowed_actions); optional on error-recovery actions (ErrorResponse.allowed_actions) where the matching operation_id is enough and the URI is implicit from the failed call.

string | null

method

HTTP method to use against href. Required for entity hypermedia actions; usually omitted on error-recovery actions where the same operation is retried with its original method.

string | null

operation_id

OpenAPI operationId the caller should invoke. Lets an MCP client resolve the call without parsing href.

string | null

rel

required

Link relation describing the action. Closed vocabulary documented in specs/api-conventions.md — examples: self, cancel, pause, resume, events, retry, retry-later, unarchive, get-existing, delete, update.

string

schema_ref

OpenAPI $ref to the request-body schema, when the action takes one (e.g. #/components/schemas/UpdateSessionRequest). Lets a tool-calling agent fetch the input shape without scanning the whole spec.

string | null

self_url

required

Full API endpoint URL for this resource.

string

ui_link

required

Alias for view_url, used by command and MCP outputs.

string

view_url

required

Full UI URL for viewing this resource.

string

Example

{
  "id": "provider_01933b5a00007000800000000000001",
  "status": "active",
  "allowed_actions": [
    {
      "method": "POST"
    }
  ]
}

400

Invalid provider ID

404

Provider not found