# Get workspace model governance

`GET https://api.endless.app/organizations/{organization_id}/models/governance`

Source: https://endless.app/docs/api/workspace-models/governance

Get workspace model governance. Scoped to the organization named by `organization_id`.

## Authentication

- `bearerAuth`: HTTP bearer (JWT)

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `organization_id` | path | string | yes |  |
| `kind` | query | "workspace" \| "team" \| "user" | yes |  |
| `team_id` | query | string (uuid) | no |  |
| `user_id` | query | string | no |  |
| `output_type` | query | "text" \| "image" \| "video" \| "audio" | no |  |
| `Endless-Api-Version` | header | string | no | Pin the caller to an API major (`1`). Omit to accept the current version. A major this deployment cannot serve is refused with 400 `unsupported_api_version`. |

## Responses

### 200 OK

Content type: `application/json` — array<object>

- `id` (string (uuid), required)
- `codename` (string, required)
- `name` (string, required)
- `owner` (string | null, required)
- `description` (string | null, required)
- `output_type` ("text" | "image" | "video" | "audio", required)
- `parameters` (string | number | boolean | null | object | array<any | null> | null, required)
- `type` ("edit" | "convert" | "remix" | null, required)
- `minimum_required_plan` ("hobby" | "basic" | "pro" | "business" | null, required)
- `position` (number, required)
- `staff` (boolean, required)
- `unlisted` (boolean, required)
- `deleted_at` (string (date-time) | null, required)
- `deleted_by_id` (string | null, required)
- `created_at` (string (date-time), required)
- `updated_at` (string (date-time), required)
- `version_id` (string | null, required)
- `version_number` (integer | null, required)
- `version_status` ("draft" | "current" | "superseded" | "disabled" | "discarded")
- `variants` (array<object>)
  - `id` (string (uuid), required)
  - `media_model_id` (string (uuid), required)
  - `media_model_version_id` (string (uuid) | null, required)
  - `key` (string | null, required)
  - `fal_model_id` (string | null, required)
  - `replicate_model_id` (string | null, required)
  - `elevenlabs_model_id` (string | null, required)
  - `to_provider_input` (string | null, required)
  - `from_provider_output` (string | null, required)
  - `cost_mapper` (string | null, required)
  - `match_rule` (string | number | boolean | null | object | array<any | null> | null, required)
  - `priority` (integer, required)
  - `enabled` (boolean, required)
  - `is_default` (boolean, required)
  - `deleted_at` (string (date-time) | null, required)
  - `created_at` (string (date-time), required)
  - `updated_at` (string (date-time), required)
- `state` ("off" | "inherit", required)
- `locked` (boolean, required)
- `locked_by` ("workspace" | "team" | "admin" | null, required)
- `base_cost` (number | null, required)
- `preference_position` (number | null)
- `position_from` ("workspace" | "team" | "user" | null)

### Errors

- `400` (Error): The request is malformed, or failed input validation. `message` names the field and the rule it broke; `data.issues` carries them individually.
- `401` (Error): No bearer token, or a token that failed verification.
- `402` (Error): The workspace has no credits left, or the caller is over a spending limit.
- `403` (Error): Authenticated, but the caller's role in this workspace does not carry the permission this operation needs.
- `404` (Error): No resource with that id, or the caller cannot read it. The two are deliberately one answer, so an id cannot be probed for existence.
- `409` (Error): The request is well-formed, but the resource's current state forbids it — a taken name, a last admin, a limit already reached.
- `429` (Error): The caller has spent its rate-limit window. `Retry-After` says when to come back.
- `500` (Error): The request failed on our side. Safe to retry an idempotent operation with backoff.