Scopes attached to the calling key

GET /v1/_scopes

Auth required

Returns the scopes attached to the calling API key plus the key's identity (UUID, prefix, and environment live/test). Use this to verify a key authenticates correctly before issuing real traffic, and to confirm a recent scope change has taken effect. Any valid key may call this endpoint — no specific scope is required. Scope changes can take up to a few minutes to be reflected here.

Responses

200 Scopes resolved from the cached API key application/json

401 Missing, malformed, or unknown API key application/problem+json

429 Per-org rate limit exceeded application/problem+json

curl 'https://api.sendops.dev/v1/_scopes' \
  -H "Authorization: Bearer $SENDOPS_API_KEY"

const res = await fetch("https://api.sendops.dev/v1/_scopes", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.SENDOPS_API_KEY}`
  },
});
const body = await res.json();

import os, requests

r = requests.get("https://api.sendops.dev/v1/_scopes", headers={"Authorization": f"Bearer {os.environ['SENDOPS_API_KEY']}"})
print(r.json())

application/json

{
  "key_id": "00000000-0000-0000-0000-000000000000",
  "prefix": "sk_live_abc12345",
  "environment": "live",
  "scopes": [
    "string"
  ]
}

{
  "type": "https://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "code": "invalid_key",
  "request_id": "string",
  "retry_after": 0,
  "retention_days": 0,
  "scope": "string",
  "resource": "string",
  "errors": [
    {
      "field": "string",
      "reason": "string"
    }
  ]
}

{
  "type": "https://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "code": "invalid_key",
  "request_id": "string",
  "retry_after": 0,
  "retention_days": 0,
  "scope": "string",
  "resource": "string",
  "errors": [
    {
      "field": "string",
      "reason": "string"
    }
  ]
}

View .md