---
title: "Get Organization Targets"
method: GET
path: "/v1/organizations/targets"
tags: ["Organization Targets"]
---

# Get Organization Targets

`GET /v1/organizations/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. ``targets_writable``
is the capability flag a client should read rather than infer from
``plane``: shared-plane orgs are read-only by platform policy, and
dedicated orgs hold write access to their own spec.

## Response `200`

Successful Response

- TargetSpec — 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` 'shared' | 'dedicated', required
  - `resource_targets` ResourceTarget[], required
    - `dimension` 'cpu_utilization' | 'mem_utilization' | 'gpu_duty_cycle' | 'ray_replicas', required — The resource dimensions the audit names as in scope for phase 1 (§5, proposed shape). Per-extractor/per-serve-instance granularity is deliberately deferred (G8) — same doctrine's rollup already applied to SLO surfaces.
    - `target_min` number, required — Lower bound of the target band.
    - `target_max` number, required — Upper bound of the target band.
    - `unit` 'ratio' | 'count', required — 'ratio' for a 0-1 utilization fraction, 'count' for a unit quantity (e.g. Ray replicas).
  - `slo_targets` SLOTarget[], required
    - `surface` 'indexing' | 'retrieval' | 'clustering', required — The three surfaces's SLO rollup already computes attainment INPUTS for — kept identical here so a future attainment computation (reading both TargetSpec and slo_rollup_hourly) never has to reconcile two different surface vocabularies.
    - `p95_latency_ms_target` number, nullable — Target p95 latency in milliseconds for this surface.
    - `error_budget_pct` number, nullable — Target maximum error rate (percent) for this surface.
  - `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.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

## Changes

- **2026-08-09** `5d4c905106b4` — 1 info
  - the endpoint scheme security `BearerAuth` was added to the API
- **2026-08-05** `fdb4bdd01a64` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mixpeek/apis/mixpeek-api/changes/v1/organizations/targets/get.md)

---

[API](https://skmtc.dev/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.dev/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mixpeek/apis/mixpeek-api/revisions/a564bf7a060b?raw)