LLM Gateway API

​

Base URL

https://app.barndoor.ai/api/llm-gateway/admin

​

Authentication

import { loginInteractive } from "@barndoor/sdk";

const sdk = await loginInteractive();
// sdk includes the bearer token; pass it on every API call.

curl https://app.barndoor.ai/api/llm-gateway/admin/providers \
  -H "Authorization: Bearer eyJhbGciOi..."

​

Permissions

​

Conventions

• Every resource is scoped to the caller’s organization. There is no org_id parameter — it’s resolved from your token. A resource in another organization behaves as if it doesn’t exist (404).
• Timestamps are RFC 3339 (2026-06-12T18:30:00Z).
• Most resources are identified by UUID. Launch profiles are identified by their slug, and route group members by route name.
• Most update endpoints accept partial bodies — fields you omit are left unchanged. A handful also distinguish omitted from explicit null (which clears the value); the affected fields are documented inline.

​

Errors

{
  "error": {
    "message": "request_timeout_secs must be between 1 and 3600",
    "type": "invalid_request_error",
    "code": null
  }
}

​

API groups

​

Where to next

• New to the gateway? Read Using the LLM Gateway.
• Setting it up for the first time? Follow the Quickstart Guide, which also covers the runtime endpoints (chat completions, messages, embeddings, model listing).
• Managing configuration as code? See the Terraform provider.