Languages: every operation supports cURL, Node.js (TypeScript), Python, Go, Ruby, and PHP. The first 15 operations on this page show all six languages; the remaining 30 show cURL and TypeScript — the two most-used.

Organization API

Organization endpoints exposed by the Devotel CPaaS API Base path: /api/v1 Endpoint count: 45

Get the current organization

GET /api/v1/organization

Return the authenticated organization’s full profile: name, slug, plan, wallet balance, team-member and per-second rate limits, logo, branding, general settings, the resolved billing currency, and whether it is a subaccount. This is the record the dashboard shell and Settings → General load on every page.

string (enum: true|false)

Sandbox opt-in for Clerk-session-authenticated requests. Set to true to route the call through the test-mode pipeline: no real provider delivery, no credits deducted, response meta.test_mode: true. Ignored for live API keys (dv_live_sk_*) — server-to-server clients must use a test-prefixed key (dv_test_sk_*) to exercise sandbox. Test-prefixed keys unconditionally enable sandbox regardless of this header.

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/organization" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/organization", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/organization", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/organization')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/organization');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "id": null,
    "name": null,
    "slug": null,
    "plan": null,
    "tenantId": null,
    "balance": null,
    "maxTeamMembers": null,
    "rateLimitPerSecond": null,
    "logoUrl": null,
    "branding": null,
    "settings": null,
    "billing_currency": "string",
    "isSubaccount": false,
    "monthlyBudgetCents": null,
    "createdAt": null,
    "updatedAt": null
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Get account-trust status

GET /api/v1/organization/account-status

Return a transparent, self-serve answer to “why is my account restricted and how do I fix it?”: an overall state plus a list of restrictions, each with a stable reason code, plain-language explanation, concrete remediation steps, and an appeal channel. Derived from the org’s existing restriction facts — it adds no new state.

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/organization/account-status" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/account-status', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/organization/account-status", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/organization/account-status", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/organization/account-status')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/organization/account-status');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "state": "string",
    "restrictions": [
      {}
    ]
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

List organization API keys (SDK alias)

GET /api/v1/organization/api-keys

Backward-compatible alias of GET /settings/api-keys for the public SDK organization.apiKeys.list() — every API key on the organization, newest first (label, public prefix, last-four, type, state, expiry, scopes and minting role). Key plaintext is never returned — it is shown once, at create / rotate time. Owner, admin or developer.

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/organization/api-keys" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/api-keys', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/organization/api-keys", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/organization/api-keys", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/organization/api-keys')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/organization/api-keys');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": [
    {}
  ],
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Get organization branding

GET /api/v1/organization/branding

Return the organization’s white-label branding record — logo and logomark URLs, primary and accent colours, dashboard name, support email, custom domain, favicon, legal links, and help-centre theming. Unset keys are returned as null so callers always receive the full shape. Requires the owner or admin role.

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/organization/branding" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/branding', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/organization/branding", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/organization/branding", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/organization/branding')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/organization/branding');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "logo_url": null,
    "logomark_url": null,
    "primary_color": null,
    "accent_color": null,
    "dashboard_name": null,
    "support_email": null,
    "custom_domain": null,
    "favicon_url": null,
    "terms_url": null,
    "privacy_url": null,
    "help_logo_url": null,
    "help_primary_color": null,
    "help_secondary_color": null,
    "help_header_links": null,
    "help_show_powered_by": null
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Get default business hours

GET /api/v1/organization/business-hours

Return the organization-wide default business-hours and holiday-calendar schedule that cascades to any ACD queue, inbound route, or auto-attendant that has not configured its own. Returns null fields (not a 404) when no org default has been set yet.

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/organization/business-hours" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/business-hours', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/organization/business-hours", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/organization/business-hours", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/organization/business-hours')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/organization/business-hours');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "business_hours": null,
    "holiday_calendar_id": null
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

List custom domains

GET /api/v1/organization/domains

List the vanity / custom domains registered for the organization’s white-label dashboard, each with its verification status, CNAME target, SSL provisioning state, and any last error. Cursor-paginated via the cursor / limit query params. Requires the owner or admin role.

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/organization/domains" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/domains', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/organization/domains", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/organization/domains", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/organization/domains')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/organization/domains');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": [
    {
      "id": "msg_3f6a81c2d4e5471a9b0c2d5e",
      "organization_id": "string",
      "domain": "string",
      "status": "delivered",
      "cname_target": "string",
      "cname_verified_at": null,
      "ssl_cert_provisioned_at": null,
      "ssl_cert_secret_name": null,
      "error": null,
      "created_at": "1970-01-01T00:00:00.000Z",
      "updated_at": "1970-01-01T00:00:00.000Z"
    }
  ],
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

List pending organization invites (SDK alias)

GET /api/v1/organization/invites

Backward-compatible alias of GET /settings/team/invites for the public SDK organization.invites.list() — every outstanding (unaccepted, unrevoked) team invitation on the organization, oldest first.

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/organization/invites" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/invites', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/organization/invites", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/organization/invites", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/organization/invites')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/organization/invites');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": [
    {}
  ],
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Get KYB business-screening status

GET /api/v1/organization/kyb/status

Return the organization’s KYB / AML business-screening verdict for the signing entity — the legal name, country of incorporation, and declared beneficial owners run against the sanctioned-country denylist and the denied-parties watchlist. The verdict (clear / review) is a signal a super-admin reviews; it never auto-approves and never blocks sending.

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/organization/kyb/status" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/kyb/status', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/organization/kyb/status", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/organization/kyb/status", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/organization/kyb/status')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/organization/kyb/status');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "status": "delivered",
    "matches": null,
    "legal_name": null,
    "country": null,
    "registration_number": null,
    "beneficial_owners": null,
    "screened_at": null
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Get KYC verification status (legacy alias)

GET /api/v1/organization/kyc

Deprecated backward-compatible alias of GET /organization/kyc/status for pre-2026-06-09 SDK builds and hand-rolled integrations that read KYC state from the bare /organization/kyc path. Returns the same current KYC verification state; new integrations should call /organization/kyc/status instead.

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/organization/kyc" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/kyc', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/organization/kyc", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/organization/kyc", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/organization/kyc')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/organization/kyc');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "status": "delivered",
    "company_name": null,
    "country": null,
    "industry": null,
    "submitted_at": null,
    "reviewed_at": null
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Get eKYC identity-verification status

GET /api/v1/organization/kyc/idv/status

Return the organization’s current eKYC identity-verification state, reconciling any still-open session against the provider’s latest verdict. Also reports whether an IDV provider is configured for the platform, so the dashboard can hide the step when verification is unavailable.

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/organization/kyc/idv/status" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/kyc/idv/status', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/organization/kyc/idv/status", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/organization/kyc/idv/status", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/organization/kyc/idv/status')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/organization/kyc/idv/status');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "status": "delivered",
    "provider": null,
    "session_id": null,
    "hosted_url": null,
    "reason": null,
    "configured": false,
    "created_at": null,
    "updated_at": null
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Get KYC verification status

GET /api/v1/organization/kyc/status

Return the organization’s current KYC verification state (not_started, pending_review, approved, or rejected). Once a submission exists it also echoes the submitted company name, country, industry, and the submitted / reviewed timestamps so the dashboard can render the verification banner accurately.

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/organization/kyc/status" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/kyc/status', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/organization/kyc/status", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/organization/kyc/status", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/organization/kyc/status')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/organization/kyc/status');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "status": "delivered",
    "company_name": null,
    "country": null,
    "industry": null,
    "submitted_at": null,
    "reviewed_at": null
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Get curated LLM provider slice

GET /api/v1/organization/llm-provider

Return the curated LLM provider catalog (Devotel free base + Anthropic premium tiers), the org’s recorded provider selection, and the resolved provider. Non-curated catalog rows (evaluation / rejected) are exposed for audit but are never selectable — evaluation FIRST, then resale integration. Step 1 of the native multi-LLM program: recording a selection changes no in-flight routing yet. Requires the owner or admin role.

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/organization/llm-provider" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/llm-provider', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/organization/llm-provider", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/organization/llm-provider", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/organization/llm-provider')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/organization/llm-provider');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "catalog": [
      {
        "provider": "devotel",
        "label": "string",
        "tier": "free_base",
        "evaluationState": "curated",
        "defaultModel": "string",
        "transportAvailable": false,
        "note": "string"
      }
    ],
    "allCatalogRows": [
      {
        "provider": "devotel",
        "label": "string",
        "tier": "free_base",
        "evaluationState": "curated",
        "defaultModel": "string",
        "transportAvailable": false,
        "note": "string"
      }
    ],
    "selected": "devotel",
    "resolution": {
      "provider": "devotel",
      "source": "stored",
      "catalog": {
        "provider": "devotel",
        "label": "string",
        "tier": "free_base",
        "evaluationState": "curated",
        "defaultModel": "string",
        "transportAvailable": false,
        "note": "string"
      }
    }
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Resolve the org’s curated LLM provider

GET /api/v1/organization/llm-provider/resolve

Resolve the caller org’s curated LLM provider — the org’s recorded selection when valid (and curated), otherwise the platform default. Redundant with the slice GET but is the SDK-facing gate the later-step integrations (step 2 inference routing, step 3 metering) query without the full catalog payload. Requires the owner or admin role.

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/organization/llm-provider/resolve" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/llm-provider/resolve', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/organization/llm-provider/resolve", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/organization/llm-provider/resolve", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/organization/llm-provider/resolve')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/organization/llm-provider/resolve');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "provider": "devotel",
    "source": "stored",
    "catalog": {
      "provider": "devotel",
      "label": "string",
      "tier": "free_base",
      "evaluationState": "curated",
      "defaultModel": "string",
      "transportAvailable": false,
      "note": "string"
    }
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

List organization members (SDK alias)

GET /api/v1/organization/members

Backward-compatible alias of GET /settings/team for the public SDK organization.members.list() — one page of the organization’s team roster (each member’s id, email, name, role and last-active time), with meta.pagination alongside request_id. Page with ?page= and ?pageSize= (default 25, maximum 200).

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/organization/members" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/members', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/organization/members", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/organization/members", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/organization/members')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/organization/members');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": [
    {}
  ],
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Get reseller mode slice

GET /api/v1/organization/reseller

Return the organization’s reseller-mode slice: the capability flag, whether the caller is itself a subaccount, the effective reseller org its traffic resolves against, and the parent-scoped BYO provider registry (masked credentials). Subaccounts always receive an empty provider list — provider configuration is the reseller parent’s own surface. Requires the owner or admin role.

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/organization/reseller" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/reseller', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/organization/reseller", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/organization/reseller", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/organization/reseller')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/organization/reseller');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": {
    "enabled": false,
    "is_subaccount": false,
    "effective_reseller_org_id": null,
    "providers": [
      {
        "provider_type": "string",
        "status": "delivered",
        "fee_meter_hook": null,
        "credentials": {}
      }
    ]
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Resolve reseller provider

GET /api/v1/organization/reseller/resolve/{providerType}

Resolve one provider type for the caller against its reseller parent (or itself when it is the reseller org). Returns byo with the matched connection when the parent has an active configuration, otherwise `devotel_default — existing behavior. Requires the owner or admin role.

string

required

—

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/organization/reseller/resolve/{providerType}" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/reseller/resolve/{providerType}', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

{
  "data": {
    "mode": "byo",
    "provider_type": "string",
    "config": null
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Resolve a custom domain’s presentational branding

GET /api/v1/public/branding

Resolves a white-label custom domain to the organization that owns it and returns its effective branding (logo, logomark, favicon, primary/accent colours, dashboard name). Only presentational fields — no ids, provenance, or contact details. Unauthenticated + rate-limited because the pre-auth login/signup screens on the custom domain render this publicly anyway. A host that is not a registered, active custom domain returns 404.

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/public/branding" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/public/branding', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

{}

Resolve a custom domain to its organization

GET /api/v1/public/resolve-domain

Resolves a white-label custom domain to the organization and tenant that own it. Pass the fully-qualified host (for example app.acme.com) as the required host query parameter and the endpoint returns the matching organization_id and tenant_id. Unauthenticated, rate-limited, and edge-cached — the dashboard edge middleware calls it on every request whose Host header is a customer’s own domain so it can load the right workspace. A host that is not a registered, active custom domain returns 404.

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/public/resolve-domain" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/public/resolve-domain', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

{}

Resolve an organization to its branded domain

GET /api/v1/public/resolve-org-domain

Resolves a white-label organization id to the organization’s ACTIVE branded custom domain (for example app.acme.com). Used by the primary sign-in page, right after auth completes, to send a subaccount user HOME to their branded origin through Clerk’s satellite handshake instead of parking them on the platform domain. Unauthenticated, rate-limited, and edge-cached. An organization with no active custom domain returns 404.

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/public/resolve-org-domain" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/public/resolve-org-domain', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

{}

List federation

GET /api/v1/users/me/presence/federation

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/users/me/presence/federation" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/users/me/presence/federation', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

{
  "data": {},
  "meta": {
    "request_id": "req_01HZQX4E7JQ4M2E2H2DM9XE5FJ",
    "timestamp": "2026-08-26T12:00:00.000Z"
  }
}

List schedule

GET /api/v1/users/me/presence/schedule

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/users/me/presence/schedule" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/users/me/presence/schedule', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

{
  "data": {},
  "meta": {
    "request_id": "req_01HZQX4E7JQ4M2E2H2DM9XE5FJ",
    "timestamp": "2026-08-26T12:00:00.000Z"
  }
}

List presence

GET /api/v1/users/presence

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/users/presence" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/users/presence', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

{
  "data": {},
  "meta": {
    "request_id": "req_01HZQX4E7JQ4M2E2H2DM9XE5FJ",
    "timestamp": "2026-08-26T12:00:00.000Z"
  }
}

Create an API key (SDK alias)

POST /api/v1/organization/api-keys

Backward-compatible alias of POST /settings/api-keys for the public SDK organization.apiKeys.create(...) — mints a new key; its plaintext is returned ONCE in this response. Store it now. Owner, admin or developer.

string

Stripe-style idempotency token. Pass a stable, client-generated value (1-255 chars) to dedupe retries on transient timeouts. The same key+credential+path replays the original response for 24h on 2xx (5min on 4xx, 30s on 5xx). Returns 409 if a concurrent request with the same key is already in flight; replayed responses include the Idempotency-Replay: true response header.

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/organization/api-keys" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/api-keys', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {},
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Rotate an API key (SDK alias)

POST /api/v1/organization/api-keys/{id}/rotate

Backward-compatible alias of POST /settings/api-keys/:id/rotate for the public SDK organization.apiKeys.rotate(id) — mints a replacement and retires the old key (default 24h grace window; mode: "immediate" revokes in the same request). The new key’s plaintext is returned once. Owner, admin or developer.

string

required

Resource identifier

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/organization/api-keys/num_8fb2d1b7c00c4ec9a1d3f5e7b9c1d3/rotate" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/api-keys/num_8fb2d1b7c00c4ec9a1d3f5e7b9c1d3/rotate', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {},
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Reset organization branding

POST /api/v1/organization/branding/reset

Clear the organization’s branding overrides and return every field to the platform default (or the parent’s inherited branding for a subaccount). Idempotent and audit-logged. Returns the reset branding record. Requires the owner or admin role.

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/organization/branding/reset" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/branding/reset', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "logo_url": null,
    "logomark_url": null,
    "primary_color": null,
    "accent_color": null,
    "dashboard_name": null,
    "support_email": null,
    "custom_domain": null,
    "favicon_url": null,
    "terms_url": null,
    "privacy_url": null,
    "help_logo_url": null,
    "help_primary_color": null,
    "help_secondary_color": null,
    "help_header_links": null,
    "help_show_powered_by": null
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Add a custom domain

POST /api/v1/organization/domains

Register a vanity / custom domain for the organization’s white-label dashboard. Returns the created domain record in pending status with the CNAME target you must add at your DNS provider before verifying it. Requires the owner or admin role.

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/organization/domains" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/domains', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "msg_3f6a81c2d4e5471a9b0c2d5e",
    "organization_id": "string",
    "domain": "string",
    "status": "delivered",
    "cname_target": "string",
    "cname_verified_at": null,
    "ssl_cert_provisioned_at": null,
    "ssl_cert_secret_name": null,
    "error": null,
    "created_at": "1970-01-01T00:00:00.000Z",
    "updated_at": "1970-01-01T00:00:00.000Z"
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Verify a custom domain

POST /api/v1/organization/domains/{domainId}/verify

Check the CNAME record for a registered custom domain and, once it resolves to the expected target, advance the domain toward the verified state and trigger TLS certificate provisioning. Returns the refreshed domain record. Requires the owner or admin role.

string

required

Custom-domain record identifier.

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/organization/domains/{domainId}/verify" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/domains/{domainId}/verify', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": "msg_3f6a81c2d4e5471a9b0c2d5e",
    "organization_id": "string",
    "domain": "string",
    "status": "delivered",
    "cname_target": "string",
    "cname_verified_at": null,
    "ssl_cert_provisioned_at": null,
    "ssl_cert_secret_name": null,
    "error": null,
    "created_at": "1970-01-01T00:00:00.000Z",
    "updated_at": "1970-01-01T00:00:00.000Z"
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Invite a member (SDK alias)

POST /api/v1/organization/invites

Backward-compatible alias of POST /settings/team/invite for the public SDK organization.invites.create({ email, role }) — sends a team-invitation email and stores the invite. Requires the owner or admin role.

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/organization/invites" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/invites', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {},
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Resend a pending invite (SDK alias)

POST /api/v1/organization/invites/{id}/resend

Backward-compatible alias of POST /settings/team/invites/:email/resend for the public SDK organization.invites.resend(id) — re-sends the invitation email. The :id path parameter carries the invited email address (URL-encoded). Requires the owner or admin role.

string

required

Resource identifier

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/organization/invites/num_8fb2d1b7c00c4ec9a1d3f5e7b9c1d3/resend" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/invites/num_8fb2d1b7c00c4ec9a1d3f5e7b9c1d3/resend', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {},
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Start an eKYC identity-verification session

POST /api/v1/organization/kyc/idv/session

Create a hosted government-ID + selfie-liveness capture session with the configured identity-verification provider and return the URL the applicant is redirected to. Returns 503 IDV_NOT_CONFIGURED until a provider is provisioned, and 409 once identity is already verified. A verified identity is a signal a super-admin reviews — it never auto-grants KYC.

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/organization/kyc/idv/session" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/kyc/idv/session', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "status": "delivered",
    "provider": null,
    "session_id": null,
    "hosted_url": null,
    "reason": null,
    "configured": false,
    "created_at": null,
    "updated_at": null
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Submit KYC verification

POST /api/v1/organization/kyc/submit

Submit the organization’s Know Your Customer business details (legal name, website, country, industry, use case, and estimated monthly volume) for compliance review. The submission is queued for a super-admin to approve or reject, and a business-screening (KYB) check runs on the signing entity at the same time. Returns the resulting pending_review status.

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/organization/kyc/submit" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/kyc/submit', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "status": "delivered",
    "kyc": {},
    "kyb": null,
    "message": "string"
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Update the current organization

PUT /api/v1/organization

Update the caller organization’s name, general settings JSONB, and monthly budget. Delegates to the same handler that backs PUT /settings/general, so the org-rename echo, settings-cache invalidation, and write-boundary security guards all apply. Returns the updated organization record. Requires the owner or admin role.

string

string (enum: true|false)

cURL

curl -X PUT "https://api.orbit.devotel.io/api/v1/organization" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization', {
  method: 'PUT',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "id": null,
    "name": null,
    "settings": null,
    "monthly_budget_cents": null
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Update organization branding

PUT /api/v1/organization/branding

Merge a partial branding patch into the organization’s white-label configuration. Only the keys you send are updated; send an explicit null to clear a field, or set inherit_from_parent to flip a subaccount back to inheriting its parent’s branding. Returns the updated branding record. Requires the owner or admin role.

string

string (enum: true|false)

cURL

curl -X PUT "https://api.orbit.devotel.io/api/v1/organization/branding" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/branding', {
  method: 'PUT',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "logo_url": null,
    "logomark_url": null,
    "primary_color": null,
    "accent_color": null,
    "dashboard_name": null,
    "support_email": null,
    "custom_domain": null,
    "favicon_url": null,
    "terms_url": null,
    "privacy_url": null,
    "help_logo_url": null,
    "help_primary_color": null,
    "help_secondary_color": null,
    "help_header_links": null,
    "help_show_powered_by": null
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Update default business hours

PUT /api/v1/organization/business-hours

Set or patch the organization-wide default business-hours / holiday-calendar schedule. Diff-submit: an omitted field is untouched and an explicit null clears that default. A non-null holiday_calendar_id must reference a calendar owned by the caller’s org. Returns the updated schedule. Requires the owner or admin role.

string

string (enum: true|false)

cURL

curl -X PUT "https://api.orbit.devotel.io/api/v1/organization/business-hours" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/business-hours', {
  method: 'PUT',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "business_hours": null,
    "holiday_calendar_id": null
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Record the org’s curated LLM provider selection

PUT /api/v1/organization/llm-provider

Record the caller org’s curated LLM provider selection (devotel free base or anthropic premium), or clear it back to the platform default with provider: null. A subaccount can never record a selection (403) — the curated lineup is a whitelabel-parent / root-org capability. Only curated catalog rows are writable; a still-evaluating or rejected provider is a 400. Requires the owner or admin role.

string

string (enum: true|false)

string | null (enum: devotel|anthropic|null)

required

The curated provider to record, or null to clear back to the platform default.

cURL

curl -X PUT "https://api.orbit.devotel.io/api/v1/organization/llm-provider" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "provider": "devotel"
}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/llm-provider', {
  method: 'PUT',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "provider": "devotel"
}),
})
console.log(await res.json())

{
  "data": {
    "provider": "devotel",
    "source": "stored",
    "catalog": {
      "provider": "devotel",
      "label": "string",
      "tier": "free_base",
      "evaluationState": "curated",
      "defaultModel": "string",
      "transportAvailable": false,
      "note": "string"
    }
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Update a member’s role (SDK alias)

PUT /api/v1/organization/members/{id}

Backward-compatible alias of PUT /settings/team/:userId for the public SDK organization.members.update(id, { role }) — changes the member’s role inside the organization. The :id path parameter maps to the member’s user id. Requires the owner or admin role.

string

required

Resource identifier

string

string (enum: true|false)

cURL

curl -X PUT "https://api.orbit.devotel.io/api/v1/organization/members/num_8fb2d1b7c00c4ec9a1d3f5e7b9c1d3" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/members/num_8fb2d1b7c00c4ec9a1d3f5e7b9c1d3', {
  method: 'PUT',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {},
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Connect a reseller BYO provider

PUT /api/v1/organization/reseller/providers/{providerType}

Create or replace one BYO provider connection on the caller’s own organization. Credentials are encrypted server-side (same enc:v1: envelope as channel credentials) and never echoed back. Only the reseller parent itself may call this — subaccounts receive 403. Returns the upserted connection’s provider type + status + the resulting resolution mode. Requires the owner or admin role.

string

required

—

string

string (enum: true|false)

cURL

curl -X PUT "https://api.orbit.devotel.io/api/v1/organization/reseller/providers/{providerType}" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/reseller/providers/{providerType}', {
  method: 'PUT',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "provider_type": "string",
    "status": "delivered",
    "mode": "byo"
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Update federation

PUT /api/v1/users/me/presence/federation/{provider}

string

required

—

string

string (enum: true|false)

cURL

curl -X PUT "https://api.orbit.devotel.io/api/v1/users/me/presence/federation/{provider}" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/users/me/presence/federation/{provider}', {
  method: 'PUT',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {},
  "meta": {
    "request_id": "req_01HZQX4E7JQ4M2E2H2DM9XE5FJ",
    "timestamp": "2026-08-26T12:00:00.000Z"
  }
}

Update reseller mode flag

PATCH /api/v1/organization/reseller/mode

Flip the reseller-mode capability flag on the caller’s own organization. A subaccount can never flip itself into reseller mode (403) — the flag applies to whitelabel parent orgs only. Toggling off keeps the provider registry intact and immediately falls traffic back to the Devotel default. Requires the owner or admin role.

string (enum: true|false)

cURL

curl -X PATCH "https://api.orbit.devotel.io/api/v1/organization/reseller/mode" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/reseller/mode', {
  method: 'PATCH',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "enabled": false
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Revoke an API key (SDK alias)

DELETE /api/v1/organization/api-keys/{id}

Backward-compatible alias of DELETE /settings/api-keys/:id for the public SDK organization.apiKeys.revoke(id) — revokes the key in place; it stops authenticating instantly. Returns 404 when no key carries that id. Owner, admin or developer.

string

required

Resource identifier

string (enum: true|false)

cURL

curl -X DELETE "https://api.orbit.devotel.io/api/v1/organization/api-keys/num_8fb2d1b7c00c4ec9a1d3f5e7b9c1d3" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/api-keys/num_8fb2d1b7c00c4ec9a1d3f5e7b9c1d3', {
  method: 'DELETE',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {},
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Remove a custom domain

DELETE /api/v1/organization/domains/{domainId}

Remove a custom domain from the organization, tearing down its verification state and any provisioned TLS certificate. The domain must belong to the caller’s organization or the request is rejected. Requires the owner or admin role.

string

required

Custom-domain record identifier.

string (enum: true|false)

cURL

curl -X DELETE "https://api.orbit.devotel.io/api/v1/organization/domains/{domainId}" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/domains/{domainId}', {
  method: 'DELETE',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "deleted": false
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Revoke a pending invite (SDK alias)

DELETE /api/v1/organization/invites/{id}

Backward-compatible alias of DELETE /settings/team/invites/:email for the public SDK organization.invites.revoke(id) — cancels the pending invitation so the emailed token can no longer be redeemed. The :id path parameter carries the invited email address (URL-encoded). Requires the owner or admin role.

string

required

Resource identifier

string (enum: true|false)

cURL

curl -X DELETE "https://api.orbit.devotel.io/api/v1/organization/invites/num_8fb2d1b7c00c4ec9a1d3f5e7b9c1d3" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/invites/num_8fb2d1b7c00c4ec9a1d3f5e7b9c1d3', {
  method: 'DELETE',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

Response: 204 No Content

Remove a member (SDK alias)

DELETE /api/v1/organization/members/{id}

Backward-compatible alias of DELETE /settings/team/:userId for the public SDK organization.members.remove(id) — tears down the member’s sessions and API keys and transfers their per-user assets. The :id path parameter maps to the member’s user id. Owner only.

string

required

Resource identifier

string (enum: true|false)

cURL

curl -X DELETE "https://api.orbit.devotel.io/api/v1/organization/members/num_8fb2d1b7c00c4ec9a1d3f5e7b9c1d3" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/members/num_8fb2d1b7c00c4ec9a1d3f5e7b9c1d3', {
  method: 'DELETE',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {},
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Disconnect a reseller BYO provider

DELETE /api/v1/organization/reseller/providers/{providerType}

Remove one BYO provider connection from the caller’s own organization. The resolution flips back to the Devotel default immediately; deleting an absent connection is idempotent. Only the reseller parent itself may call this — subaccounts receive 403. Requires the owner or admin role.

string

required

—

string (enum: true|false)

cURL

curl -X DELETE "https://api.orbit.devotel.io/api/v1/organization/reseller/providers/{providerType}" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/organization/reseller/providers/{providerType}', {
  method: 'DELETE',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "provider_type": "string",
    "deleted": false
  },
  "meta": {
    "request_id": "req_sample",
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
}

Delete federation

DELETE /api/v1/users/me/presence/federation/{provider}

string

required

—

string (enum: true|false)

cURL

curl -X DELETE "https://api.orbit.devotel.io/api/v1/users/me/presence/federation/{provider}" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/users/me/presence/federation/{provider}', {
  method: 'DELETE',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": {
    "ok": true
  },
  "meta": {
    "request_id": "req_01HZQX4E7JQ4M2E2H2DM9XE5FJ",
    "timestamp": "2026-08-26T12:00:00.000Z"
  }
}

​Organization API

​Get the current organization

​Get account-trust status

​List organization API keys (SDK alias)

​Get organization branding

​Get default business hours

​List custom domains

​List pending organization invites (SDK alias)

​Get KYB business-screening status

​Get KYC verification status (legacy alias)

​Get eKYC identity-verification status

​Get KYC verification status

​Get curated LLM provider slice

​Resolve the org’s curated LLM provider

​List organization members (SDK alias)

​Get reseller mode slice

​Resolve reseller provider

​Resolve a custom domain’s presentational branding

​Resolve a custom domain to its organization

​Resolve an organization to its branded domain

​List federation

​List schedule

​List presence

​Create an API key (SDK alias)

​Rotate an API key (SDK alias)

​Reset organization branding

​Add a custom domain

​Verify a custom domain

​Invite a member (SDK alias)

​Resend a pending invite (SDK alias)

​Start an eKYC identity-verification session

​Submit KYC verification

​Update the current organization

​Update organization branding

​Update default business hours

​Record the org’s curated LLM provider selection

​Update a member’s role (SDK alias)

​Connect a reseller BYO provider

​Update federation

​Update reseller mode flag

​Revoke an API key (SDK alias)

​Remove a custom domain

​Revoke a pending invite (SDK alias)

​Remove a member (SDK alias)

​Disconnect a reseller BYO provider

​Delete federation

Organization API

Get the current organization

Get account-trust status

List organization API keys (SDK alias)

Get organization branding

Get default business hours

List custom domains

List pending organization invites (SDK alias)

Get KYB business-screening status

Get KYC verification status (legacy alias)

Get eKYC identity-verification status

Get KYC verification status

Get curated LLM provider slice

Resolve the org’s curated LLM provider

List organization members (SDK alias)

Get reseller mode slice

Resolve reseller provider

Resolve a custom domain’s presentational branding

Resolve a custom domain to its organization

Resolve an organization to its branded domain

List federation

List schedule

List presence

Create an API key (SDK alias)

Rotate an API key (SDK alias)

Reset organization branding

Add a custom domain

Verify a custom domain

Invite a member (SDK alias)

Resend a pending invite (SDK alias)

Start an eKYC identity-verification session

Submit KYC verification

Update the current organization

Update organization branding

Update default business hours

Record the org’s curated LLM provider selection

Update a member’s role (SDK alias)

Connect a reseller BYO provider

Update federation

Update reseller mode flag

Revoke an API key (SDK alias)

Remove a custom domain

Revoke a pending invite (SDK alias)

Remove a member (SDK alias)

Disconnect a reseller BYO provider

Delete federation