POST/api/orgs/{org_id}/provider/apply

Apply to become a provider

Files the org's application for platform review. When called with an API key and models is non-empty, every declared wire id must first complete a streamed completion against base_url (a house_key applicant must send smoke_api_key, which authenticates the probe only and is never stored); a failure answers 400 and nothing is filed. An empty models list applies now and adds lanes after approval. 409 when the org already operates a provider, already has a pending application, or the slug is taken. Org admin session or the org's own key.

Authentication: Bearer API key in the Authorization header

Path parameters

  • org_idstringrequired

    Your organization id (uuid). GET /api/whoami returns it.

Request body

  • slugstringrequired
  • display_namestringrequired
  • base_urlstringrequired

    Public https OpenAI-compatible base URL, no query or fragment.

  • auth_modeenumrequired

    house_key if your endpoint needs a key, none for an open endpoint.

    "house_key""none"
  • logo_urlstring | null

    Public https URL of your logo.

  • modelsarray<object>

    First lanes; each must declare data_policy. Empty applies without lanes.

    Default: []
    models
    • wire_idstringrequired

      The model id your endpoint accepts in model.

    • bindingobjectrequired

      Bind to a catalog model (existing) or propose a new one (new).

      One of

      object

      • kindstringrequired
      • slugstringrequired

        An existing catalog model slug.

      object

      • kindstringrequired
      • modelobjectrequired
        model
        • slugstringrequired
        • display_namestringrequired
        • descriptionstring | null
        • context_windowinteger | null
        • max_output_tokensinteger | null
        • input_modalitiesarray<enum>
          Default: ["text"]
        • huggingface_urlstring | null
        • release_urlstring | null

          https URL with a real dotted host.

    • pricesobjectrequired

      Per-million-token rates in integer nano-USD (1 USD = 1,000,000,000 nano-USD). Each rate is at most 1,000,000,000,000 ($1,000 per million tokens).

      prices
      • input_nano_usd_per_millionintegerrequired
      • output_nano_usd_per_millionintegerrequired
      • cached_input_nano_usd_per_millioninteger | null

        Cached input rate; null means no cached rate.

      • reasoning_nano_usd_per_millioninteger | null
      • effective_atstring | null

        Optional timestamp with a timezone offset.

    • capabilitiesobject

      Declared capability booleans. Keys must come from the gateway's capability vocabulary (for example supports_streaming, supports_parallel_tool_calls, supports_structured_text, supports_image_input, reports_cached_input_tokens, reports_reasoning_tokens); unknown keys are refused. A lane needs supports_streaming: true to be listed.

      Default: {}
    • context_windowinteger | null
    • regionstring | null
    • deprecationobject | null
      deprecation
      • eol_atstringrequired
      • replacement_slugstring | null
    • data_policyobject | null

      Per-model data handling. Required on every model in an application.

      One of

      object

      • retains_promptsbooleanrequired
      • retention_daysinteger | null

        Days prompts are kept.

      • trains_on_databooleanrequired
      • zero_data_retentionbooleanrequired
      • policy_urlstring | null

        Public https URL of the policy.

    • dispatchobject | null
      One of

      object

      • scale_up_secondsinteger | null

        Warm-up time before saturation counts against the lane.

      • overflow_policyenum

        What happens once saturated.

        "reject""throttle"null
      • max_concurrencyinteger | null

        Declared cap on in-flight requests for this model.

    • rpminteger | null

      Requests per minute dispatch limit for the new lane; omit for the default.

    • tpminteger | null

      Tokens per minute dispatch limit for the new lane; omit for the default.

  • contactobjectrequired
    contact
    • emailstringrequired

      Where the platform reaches you when a lane misbehaves.

    • escalationstring | null

      Free-form escalation instructions (pager, shared channel, phone).

    • status_pagestring | null

      Public https status page.

  • notestring | null
  • smoke_api_keystring | null

    Endpoint key for the server-side smoke an API-key applicant with declared models must pass. Never stored.

Responses

  • 201

    The filed application.

    Response
    • idstringrequired
    • slugstringrequired
    • display_namestringrequired
    • base_urlstringrequired
    • auth_modeenumrequired
      "house_key""none"
    • logo_urlstring | nullrequired
    • modelsarray<object>required
      models
      • wire_idstringrequired

        The model id your endpoint accepts in model.

      • bindingobjectrequired

        Bind to a catalog model (existing) or propose a new one (new).

        One of

        object

        • kindstringrequired
        • slugstringrequired

          An existing catalog model slug.

        object

        • kindstringrequired
        • modelobjectrequired
          model
          • slugstringrequired
          • display_namestringrequired
          • descriptionstring | null
          • context_windowinteger | null
          • max_output_tokensinteger | null
          • input_modalitiesarray<enum>
            Default: ["text"]
          • huggingface_urlstring | null
          • release_urlstring | null

            https URL with a real dotted host.

      • pricesobjectrequired

        Per-million-token rates in integer nano-USD (1 USD = 1,000,000,000 nano-USD). Each rate is at most 1,000,000,000,000 ($1,000 per million tokens).

        prices
        • input_nano_usd_per_millionintegerrequired
        • output_nano_usd_per_millionintegerrequired
        • cached_input_nano_usd_per_millioninteger | null

          Cached input rate; null means no cached rate.

        • reasoning_nano_usd_per_millioninteger | null
        • effective_atstring | null

          Optional timestamp with a timezone offset.

      • capabilitiesobject

        Declared capability booleans. Keys must come from the gateway's capability vocabulary (for example supports_streaming, supports_parallel_tool_calls, supports_structured_text, supports_image_input, reports_cached_input_tokens, reports_reasoning_tokens); unknown keys are refused. A lane needs supports_streaming: true to be listed.

        Default: {}
      • context_windowinteger | null
      • regionstring | null
      • deprecationobject | null
        deprecation
        • eol_atstringrequired
        • replacement_slugstring | null
      • data_policyobject | null

        Per-model data handling. Required on every model in an application.

        One of

        object

        • retains_promptsbooleanrequired
        • retention_daysinteger | null

          Days prompts are kept.

        • trains_on_databooleanrequired
        • zero_data_retentionbooleanrequired
        • policy_urlstring | null

          Public https URL of the policy.

      • dispatchobject | null
        One of

        object

        • scale_up_secondsinteger | null

          Warm-up time before saturation counts against the lane.

        • overflow_policyenum

          What happens once saturated.

          "reject""throttle"null
        • max_concurrencyinteger | null

          Declared cap on in-flight requests for this model.

      • rpminteger | null

        Requests per minute dispatch limit for the new lane; omit for the default.

      • tpminteger | null

        Tokens per minute dispatch limit for the new lane; omit for the default.

    • data_policyobjectrequired

      Self-declared prompt-data handling. retention_days is required when retains_prompts is true and must be omitted otherwise; zero_data_retention requires retains_prompts and trains_on_data both false.

      data_policy
      • retains_promptsbooleanrequired
      • retention_daysinteger | null

        Days prompts are kept.

      • trains_on_databooleanrequired
      • zero_data_retentionbooleanrequired
      • policy_urlstring | null

        Public https URL of the policy.

    • contactobjectrequired
      contact
      • emailstringrequired

        Where the platform reaches you when a lane misbehaves.

      • escalationstring | null

        Free-form escalation instructions (pager, shared channel, phone).

      • status_pagestring | null

        Public https status page.

    • notestring | nullrequired
    • statusenumrequired
      "pending""approved""rejected"
    • review_notestring | nullrequired
    • created_atstringrequired
    • reviewed_atstring | nullrequired
  • 400

    The server-side smoke failed (code: smoke_failed) or a house_key key applicant declared models without smoke_api_key.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 401

    Missing, unknown or revoked API key.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 403

    The key is valid but may not perform this action (for example an inference key on a provisioning-key route, or a feature outside your plan).

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 404

    The resource does not exist or belongs to another organization.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 409

    The org already operates a provider, already has a pending application, or the slug is registered.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 422

    The body or query failed validation.

    Response
    • detailarray<object>required
      detail
      • typestring
      • locarray<string | integer>
      • msgstring

Request

curl -X POST https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider/apply \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "slug": "acme-inference",
  "display_name": "Acme Inference",
  "base_url": "https://api.acme-inference.example/v1",
  "auth_mode": "house_key",
  "logo_url": null,
  "models": [
    {
      "wire_id": "meta-llama/llama-4.1-70b-instruct",
      "binding": {
        "kind": "existing",
        "slug": "llama-4.1-70b-instruct"
      },
      "prices": {
        "input_nano_usd_per_million": 350000000,
        "output_nano_usd_per_million": 900000000
      },
      "capabilities": {
        "supports_streaming": true
      },
      "context_window": 131072,
      "data_policy": {
        "retains_prompts": false,
        "trains_on_data": false,
        "zero_data_retention": true
      }
    }
  ],
  "contact": {
    "email": "oncall@acme-inference.example",
    "escalation": "PagerDuty: acme-llm",
    "status_page": "https://status.acme-inference.example"
  },
  "note": "H200 capacity in us-east, 99.9% uptime target.",
  "smoke_api_key": "sk-acme-probe-7d2c9e4b1a6f"
}'

Response

{
  "id": "4e7b1c93-2a6d-4f58-9b0e-d3c5a8f2e716",
  "slug": "acme-inference",
  "display_name": "Acme Inference",
  "base_url": "https://api.acme-inference.example/v1",
  "auth_mode": "house_key",
  "logo_url": null,
  "models": [
    {
      "wire_id": "meta-llama/llama-4.1-70b-instruct",
      "binding": {
        "kind": "existing",
        "slug": "llama-4.1-70b-instruct"
      },
      "prices": {
        "input_nano_usd_per_million": 350000000,
        "output_nano_usd_per_million": 900000000,
        "cached_input_nano_usd_per_million": null,
        "reasoning_nano_usd_per_million": null,
        "effective_at": null
      },
      "capabilities": {
        "supports_streaming": true
      },
      "context_window": 131072,
      "region": null,
      "deprecation": null,
      "data_policy": {
        "retains_prompts": false,
        "retention_days": null,
        "trains_on_data": false,
        "zero_data_retention": true,
        "policy_url": null
      },
      "dispatch": null,
      "rpm": null,
      "tpm": null
    }
  ],
  "data_policy": {
    "retains_prompts": false,
    "retention_days": null,
    "trains_on_data": false,
    "zero_data_retention": true,
    "policy_url": null
  },
  "contact": {
    "email": "oncall@acme-inference.example",
    "escalation": "PagerDuty: acme-llm",
    "status_page": "https://status.acme-inference.example"
  },
  "note": "H200 capacity in us-east, 99.9% uptime target.",
  "status": "pending",
  "review_note": null,
  "created_at": "2026-11-19T10:30:02.551Z",
  "reviewed_at": null
}

https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider/apply