Skip to main content
GET
Get Organization Targets

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

Successful Response

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

Tenancy rule. Dedicated tenants hold write access to their own TargetSpec. Shared tenants are read-only, scoped to their own workloads, and cannot set utilization targets, because shared-plane targets are platform policy: one tenant's aggressiveness is another tenant's starvation.

targets_writable is an explicit capability to read rather than to infer from plane, so a client never reconstructs dedicated-versus- shared logic itself.

internal_id
string
required
plane
enum<string>
required
Available options:
shared,
dedicated
resource_targets
ResourceTarget · object[]
required
slo_targets
SLOTarget · object[]
required
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. Always false for shared-plane orgs by design, regardless of is_platform_default.