id | str | ✔️ | The workspace ID (UUID) or slug | production |
http_referer | Optional[str] | ➖ | The app identifier should be your app’s URL and is used as the primary identifier for rankings. This is used to track API usage per application.
| |
x_open_router_title | Optional[str] | ➖ | The app display name allows you to customize how your app appears in OpenRouter’s dashboard.
| |
x_open_router_categories | Optional[str] | ➖ | Comma-separated list of app categories (e.g. “cli-agent,cloud-agent”). Used for marketplace rankings.
| |
default_image_model | OptionalNullable[str] | ➖ | Default image model for this workspace | openai/dall-e-3 |
default_provider_sort | OptionalNullable[str] | ➖ | Default provider sort preference (price, throughput, latency, exacto) | price |
default_text_model | OptionalNullable[str] | ➖ | Default text model for this workspace | openai/gpt-4o |
description | OptionalNullable[str] | ➖ | New description for the workspace | Updated description |
disabled_server_tools | List[components.UpdateWorkspaceRequestDisabledServerTool] | ➖ | OpenRouter server tools that requests in this workspace may not invoke. Requests naming a disabled tool are rejected with 403. An empty array or null clears the list. | [ “openrouter:web_search”, “openrouter:bash” ] |
io_logging_api_key_ids | List[int] | ➖ | Optional array of API key IDs to filter I/O logging. Read-only for management keys: any value other than the stored one returns 403. Change it in the OpenRouter dashboard. | null |
io_logging_sampling_rate | Optional[float] | ➖ | Sampling rate for I/O logging (0.0001-1). Read-only for management keys: any value other than the stored one returns 403. Change it in the OpenRouter dashboard. | 1 |
is_data_discount_logging_enabled | Optional[bool] | ➖ | Whether data discount logging is enabled. Read-only for management keys: any value other than the stored one returns 403. Change it in the OpenRouter dashboard. | false |
is_observability_broadcast_enabled | Optional[bool] | ➖ | Whether broadcast is enabled | false |
is_observability_io_logging_enabled | Optional[bool] | ➖ | Whether private logging is enabled. Read-only for management keys: any value other than the stored one returns 403. Change it in the OpenRouter dashboard. | false |
name | Optional[str] | ➖ | New name for the workspace | Updated Workspace |
slug | Optional[str] | ➖ | New URL-friendly slug (lowercase alphanumeric segments separated by single hyphens, no leading/trailing hyphens) | updated-workspace |
retries | Optional[utils.RetryConfig] | ➖ | Configuration to override the default retry behavior of the client. | |