Get Organization Targets

Get this organization’s resource + SLO targets.

Tenancy (dedicated vs shared) is resolved SERVER-SIDE from the org — never from a client-supplied header (BACKE-2564). targets_writable is the capability flag a client should read rather than infer from plane: shared-plane orgs are always read-only by platform policy; dedicated orgs may write once the write path ships (not this endpoint).

GET /v1/organizations/targets

Get Organization Targets

cURL

curl --request GET \
  --url https://api.mixpeek.com/v1/organizations/targets \
  --header 'Authorization: Bearer <token>'

200

{
  "internal_id": "<string>",
  "resource_targets": [
    {
      "target_min": 123,
      "target_max": 123
    }
  ],
  "slo_targets": [
    {
      "p95_latency_ms_target": 123,
      "error_budget_pct": 123
    }
  ],
  "is_platform_default": true,
  "targets_writable": true
}

Authorizations

Authorization · string · header · required

Mixpeek API key, sent as Authorization: Bearer mxp_sk_.... Create one in Studio under Settings → API Keys, or with an admin key via POST /v1/organizations/users/{user_email}/api-keys. A missing header returns 403; an invalid or revoked key returns 401.

Response

200

application/json

Successful Response

Per-tenant (or plane) resource targets + SLO block.

TENANCY RULE (Ethan 2026-07-31, baked into the audit): dedicated tenants get write access to their own TargetSpec (once the write path ships — not this card); shared tenants are read-only, scoped to their own workloads, and cannot set utilization targets at all — shared-plane targets are platform policy, since one tenant's aggressiveness is another tenant's starvation.

targets_writable is an explicit CAPABILITY the client reads rather than infers from plane (studio-plg's binding contract note, 2026-08-03): the client will not reconstruct dedicated-vs-shared logic itself.

internal_id · string · required

plane · enum<string> · required

Available options: shared, dedicated

resource_targets · ResourceTarget · object[] · required

Show child attributes

slo_targets · SLOTarget · object[] · required

Show child attributes

is_platform_default · boolean · required

True when no org-specific TargetSpec has been written yet and these values are the platform default band for this org's plane. Always true today — no write path exists.

targets_writable · boolean · required

Whether this org CAN write its own TargetSpec (once the write path ships). Always false for shared-plane orgs by design, regardless of is_platform_default.