Skip to content
OpenRelay is in early access, and the /v1 API is stable. New capabilities ship in the changelog.
PricingDashboard
GuidesAPI ReferenceCLI
API ReferenceInferenceDedicated Endpoints

List your dedicated endpoints

Returns one page of your organization's dedicated inference endpoints, with each one's model id, status, enabled flag, and per-token pricing.

Required permission

Requires the endpoint.read permission. See Permissions for the roles and API key permissions that include it.

Command line

The orl CLI wraps this endpoint:

orl dedicated-endpoints list
GET
/v1/inference/endpoints

Authorization

apiKey
headerAuthorizationBearer <token>

OpenRelay API key. Send it as Authorization: Bearer or_… (legacy vl_… keys still work).

Query Parameters

limit?integer
cursor?string

Response Body

Page

application/json
  1. response
items*array<>
nextCursor?string
Example Request
curl -X GET 'https://api.openrelay.inc/v1/inference/endpoints'
Example Response
{  "items": [    {      "id": "string",      "orgId": "string",      "name": "string",      "modelId": "string",      "modality": "string",      "status": "string",      "statusReason": "string",      "enabled": true,      "pricingNanoUSD": {        "property1": 0,        "property2": 0      },      "version": 0,      "createdAt": "string",      "updatedAt": "string"    }  ],  "nextCursor": "string"}

Overview

Models served on capacity reserved for your organization. Call one through the inference API at inference.openrelay.inc with its modelId. Read it, its lifecycle events, and its monitoring series here. Dedicated endpoints are set up with our team; without dedicated inference the list is empty and the rest return 404.

Get a dedicated endpoint GET

Returns one of your dedicated endpoints: the model id to send in inference requests, its status, whether it is enabled, and its per-token pricing.