Models

Update project model grant

Changed on

Updates the project's overrides for the configured model. Omitted fields keep their current values; null clears an override so the project inherits from the configured model. The grant is live policy: agents already using the model re-apply the updated overrides on their next model call, against the configured-model revision each agent pinned at launch. Updates are validated against the configured model's current revision only, so an update can make an agent pinned to an older, incompatible revision fail its next model call.

patch/orgs/{orgID}/projects/{projectID}/model-grants/{modelGrantID}

Request

  • Base URL: https://api.omnara.com/v1
  • URL: https://api.omnara.com/v1/orgs/{orgID}/projects/{projectID}/model-grants/{modelGrantID}
  • Auth: one of:
    • HTTP bearer
    • API key in cookie __Host-omnara_session and API key in header X-Omnara-Csrf

Request body

context_window_tokensinteger nullable

Project token-window limit. Cannot exceed the configured model's current limit.

max_output_tokensinteger nullable

Project output-token ceiling. Cannot exceed the configured model's ceiling.

default_max_output_tokensinteger nullable

Project default per-request output-token cap.

default_cache_retention'none' | 'short' | 'long'

Prompt-cache preference for model requests; short when omitted. short applies the route's default caching (explicit cache breakpoints where the provider requires them) and, where the route accepts one, a stable conversation key for cache-aware routing. long prefers the route's extended cache lifetime where one exists (currently Anthropic's one-hour cache, which on Bedrock requires Claude 4.5 or newer) and behaves like short elsewhere. none sends no Omnara-managed cache controls or conversation key; providers may still cache prefixes on their own.

supports_toolsboolean nullable

Project-level tool-use gate. Can disable tools, but cannot enable tools when the configured model does not support them.

supports_reasoningboolean nullable

Project-level reasoning gate. Can disable reasoning, but cannot enable reasoning when the configured model does not support it.

default_reasoning_effortstring nullable

Project default reasoning effort.

supported_reasoning_effortsstring[]

Project subset of configured-model reasoning efforts. If this excludes the inherited default_reasoning_effort, set default_reasoning_effort on the grant too.

input_modalitiesstring[]

Project subset of configured-model input types.

output_modalitiesstring[]

Project subset of configured-model output types.

Response

Route response.

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      removed the authentication_unavailable enum value from the response property for the response status

    • info

      removed the authentication_unavailable enum value from the response property for the response status

    • info

      removed the authentication_unavailable enum value from the response property for the response status

    • info

      removed the authentication_unavailable enum value from the response property for the response status

    • info

      removed the authentication_unavailable enum value from the response property for the response status

    • info

      removed the authentication_unavailable enum value from the response property for the response status

    • info

      removed the authentication_unavailable enum value from the response property for the response status

    • info

      removed the conflict enum value from the response property for the response status

    • info

      removed the conflict enum value from the response property for the response status

    • info

      removed the conflict enum value from the response property for the response status

    • info

      removed the conflict enum value from the response property for the response status

    • info

      removed the conflict enum value from the response property for the response status

    • info

      removed the conflict enum value from the response property for the response status

    • info

      removed the conflict enum value from the response property for the response status

    • info

      removed the csrf_check_failed enum value from the response property for the response status

    • info

      removed the csrf_check_failed enum value from the response property for the response status

    • info

      removed the csrf_check_failed enum value from the response property for the response status

    • info

      removed the csrf_check_failed enum value from the response property for the response status

    • info

      removed the csrf_check_failed enum value from the response property for the response status

    • info

      removed the csrf_check_failed enum value from the response property for the response status

    • info

      removed the csrf_check_failed enum value from the response property for the response status

    • info

      removed the daemon_runtime_unregistered enum value from the response property for the response status

    • info

      removed the daemon_runtime_unregistered enum value from the response property for the response status

    • info

      removed the daemon_runtime_unregistered enum value from the response property for the response status

    • info

      removed the daemon_runtime_unregistered enum value from the response property for the response status

    • info

      removed the daemon_runtime_unregistered enum value from the response property for the response status

    • info

      removed the daemon_runtime_unregistered enum value from the response property for the response status

    • info

      removed the daemon_runtime_unregistered enum value from the response property for the response status

    • info

      removed the forbidden enum value from the response property for the response status

    • info

      removed the forbidden enum value from the response property for the response status

    • info

      removed the forbidden enum value from the response property for the response status

    • info

      removed the forbidden enum value from the response property for the response status

    • info

      removed the forbidden enum value from the response property for the response status

    • info

      removed the forbidden enum value from the response property for the response status

    • info

      removed the forbidden enum value from the response property for the response status

    • info

      removed the gone enum value from the response property for the response status

    • info

      removed the gone enum value from the response property for the response status

    • info

      removed the gone enum value from the response property for the response status

    • info

      removed the gone enum value from the response property for the response status

    • info

      removed the gone enum value from the response property for the response status

    • info

      removed the gone enum value from the response property for the response status

    • info

      removed the gone enum value from the response property for the response status

    • info

      removed the idempotency_key_conflict enum value from the response property for the response status

    • info

      removed the idempotency_key_conflict enum value from the response property for the response status

    • info

      removed the idempotency_key_conflict enum value from the response property for the response status

    • info

      removed the idempotency_key_conflict enum value from the response property for the response status

    • info

      removed the idempotency_key_conflict enum value from the response property for the response status

    • info

      removed the idempotency_key_conflict enum value from the response property for the response status

    • info

      removed the idempotency_key_conflict enum value from the response property for the response status

    • info

      removed the internal_error enum value from the response property for the response status

    • info

      removed the internal_error enum value from the response property for the response status

    • info

      removed the internal_error enum value from the response property for the response status

    • info

      removed the internal_error enum value from the response property for the response status

    • info

      removed the internal_error enum value from the response property for the response status

    • info

      removed the internal_error enum value from the response property for the response status

    • info

      removed the internal_error enum value from the response property for the response status

    • info

      removed the invalid_request enum value from the response property for the response status

    • info

      removed the invalid_request enum value from the response property for the response status

    • info

      removed the invalid_request enum value from the response property for the response status

    • info

      removed the invalid_request enum value from the response property for the response status

    • info

      removed the invalid_request enum value from the response property for the response status

    • info

      removed the invalid_request enum value from the response property for the response status

    • info

      removed the invalid_request enum value from the response property for the response status

    • info

      removed the managed_work_admission_denied enum value from the response property for the response status

    • info

      removed the managed_work_admission_denied enum value from the response property for the response status

    • info

      removed the managed_work_admission_denied enum value from the response property for the response status

    • info

      removed the managed_work_admission_denied enum value from the response property for the response status

    • info

      removed the managed_work_admission_denied enum value from the response property for the response status

    • info

      removed the managed_work_admission_denied enum value from the response property for the response status

    • info

      removed the not_found enum value from the response property for the response status

    • info

      removed the not_found enum value from the response property for the response status

    • info

      removed the not_found enum value from the response property for the response status

    • info

      removed the not_found enum value from the response property for the response status

    • info

      removed the not_found enum value from the response property for the response status

    • info

      removed the not_found enum value from the response property for the response status

    • info

      removed the not_found enum value from the response property for the response status

    • info

      removed the not_wake_capable enum value from the response property for the response status

    • info

      removed the not_wake_capable enum value from the response property for the response status

    • info

      removed the not_wake_capable enum value from the response property for the response status

    • info

      removed the not_wake_capable enum value from the response property for the response status

    • info

      removed the not_wake_capable enum value from the response property for the response status

    • info

      removed the not_wake_capable enum value from the response property for the response status

    • info

      removed the not_wake_capable enum value from the response property for the response status

    • info

      removed the pending_work enum value from the response property for the response status

    • info

      removed the pending_work enum value from the response property for the response status

    • info

      removed the pending_work enum value from the response property for the response status

    • info

      removed the pending_work enum value from the response property for the response status

    • info

      removed the pending_work enum value from the response property for the response status

    • info

      removed the pending_work enum value from the response property for the response status

    • info

      removed the pending_work enum value from the response property for the response status

    • info

      removed the rate_limited enum value from the response property for the response status

    • info

      removed the rate_limited enum value from the response property for the response status

    • info

      removed the rate_limited enum value from the response property for the response status

    • info

      removed the rate_limited enum value from the response property for the response status

    • info

      removed the rate_limited enum value from the response property for the response status

    • info

      removed the rate_limited enum value from the response property for the response status

    • info

      removed the rate_limited enum value from the response property for the response status

    • info

      removed the request_too_large enum value from the response property for the response status

    • info

      removed the request_too_large enum value from the response property for the response status

    • info

      removed the request_too_large enum value from the response property for the response status

    • info

      removed the request_too_large enum value from the response property for the response status

    • info

      removed the request_too_large enum value from the response property for the response status

    • info

      removed the request_too_large enum value from the response property for the response status

    • info

      removed the request_too_large enum value from the response property for the response status

    • info

      removed the service_unavailable enum value from the response property for the response status

    • info

      removed the service_unavailable enum value from the response property for the response status

    • info

      removed the service_unavailable enum value from the response property for the response status

    • info

      removed the service_unavailable enum value from the response property for the response status

    • info

      removed the service_unavailable enum value from the response property for the response status

    • info

      removed the service_unavailable enum value from the response property for the response status

    • info

      removed the service_unavailable enum value from the response property for the response status

    • info

      removed the state_transition_conflict enum value from the response property for the response status

    • info

      removed the state_transition_conflict enum value from the response property for the response status

    • info

      removed the state_transition_conflict enum value from the response property for the response status

    • info

      removed the state_transition_conflict enum value from the response property for the response status

    • info

      removed the state_transition_conflict enum value from the response property for the response status

    • info

      removed the state_transition_conflict enum value from the response property for the response status

    • info

      removed the state_transition_conflict enum value from the response property for the response status

    • info

      removed the unauthorized enum value from the response property for the response status

    • info

      removed the unauthorized enum value from the response property for the response status

    • info

      removed the unauthorized enum value from the response property for the response status

    • info

      removed the unauthorized enum value from the response property for the response status

    • info

      removed the unauthorized enum value from the response property for the response status

    • info

      removed the unauthorized enum value from the response property for the response status

    • info

      removed the unauthorized enum value from the response property for the response status

    • info

      removed the unprocessable enum value from the response property for the response status

    • info

      removed the unprocessable enum value from the response property for the response status

    • info

      removed the unprocessable enum value from the response property for the response status

    • info

      removed the unprocessable enum value from the response property for the response status

    • info

      removed the unprocessable enum value from the response property for the response status

    • info

      removed the unprocessable enum value from the response property for the response status

    • info

      removed the unprocessable enum value from the response property for the response status

    • info

      removed the unsupported_media_type enum value from the response property for the response status

    • info

      removed the unsupported_media_type enum value from the response property for the response status

    • info

      removed the unsupported_media_type enum value from the response property for the response status

    • info

      removed the unsupported_media_type enum value from the response property for the response status

    • info

      removed the unsupported_media_type enum value from the response property for the response status

    • info

      removed the unsupported_media_type enum value from the response property for the response status

    • info

      removed the unsupported_media_type enum value from the response property for the response status

    • info

      removed the upstream_unavailable enum value from the response property for the response status

    • info

      removed the upstream_unavailable enum value from the response property for the response status

    • info

      removed the upstream_unavailable enum value from the response property for the response status

    • info

      removed the upstream_unavailable enum value from the response property for the response status

    • info

      removed the upstream_unavailable enum value from the response property for the response status

    • info

      removed the upstream_unavailable enum value from the response property for the response status

    • info

      removed the upstream_unavailable enum value from the response property for the response status

    • info

      removed the validation_failed enum value from the response property for the response status

    • info

      removed the validation_failed enum value from the response property for the response status

    • info

      removed the validation_failed enum value from the response property for the response status

    • info

      removed the validation_failed enum value from the response property for the response status

    • info

      removed the validation_failed enum value from the response property for the response status

    • info

      removed the validation_failed enum value from the response property for the response status

    • info

      removed the validation_failed enum value from the response property for the response status

    This list may be incomplete.

    • warning

      added the new upstream_unavailable enum value to the response property for the response status

    • warning

      added the new upstream_unavailable enum value to the response property for the response status

    • warning

      added the new upstream_unavailable enum value to the response property for the response status

    • warning

      added the new upstream_unavailable enum value to the response property for the response status

    • warning

      added the new upstream_unavailable enum value to the response property for the response status

    • warning

      added the new upstream_unavailable enum value to the response property for the response status

    • warning

      added the new upstream_unavailable enum value to the response property for the response status

    • info

      removed the upstream_error enum value from the response property for the response status

    • info

      removed the upstream_error enum value from the response property for the response status

    • info

      removed the upstream_error enum value from the response property for the response status

    • info

      removed the upstream_error enum value from the response property for the response status

    • info

      removed the upstream_error enum value from the response property for the response status

    • info

      removed the upstream_error enum value from the response property for the response status

    • info

      removed the upstream_error enum value from the response property for the response status