Sign in
Workspaces

Create a workspace

Create a new workspace for the authenticated user. Management key required.

post/workspaces

Request body

default_image_modelstring nullable

Default image model for this workspace

default_provider_sortstring nullable

Default provider sort preference (price, throughput, latency, exacto)

default_text_modelstring nullable

Default text model for this workspace

descriptionstring nullable

Description of the workspace

disabled_server_toolsstring[] nullable

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.

io_logging_api_key_idsinteger[] nullable

Optional array of API key IDs to filter I/O logging

io_logging_sampling_ratenumber double

Sampling rate for I/O logging (0.0001-1)

is_data_discount_logging_enabledboolean

Whether data discount logging is enabled

is_observability_broadcast_enabledboolean

Whether broadcast is enabled

is_observability_io_logging_enabledboolean

Whether private logging is enabled

namestring required

Name for the new workspace

slugstring required

URL-friendly slug (lowercase alphanumeric segments separated by single hyphens, no leading/trailing hyphens)

Example request

{
  "default_image_model": "openai/dall-e-3",
  "default_provider_sort": "price",
  "default_text_model": "openai/gpt-4o",
  "description": "Production environment workspace",
  "name": "Production",
  "slug": "production"
}

Response

Workspace created successfully

Example response

{
  "data": {
    "created_at": "2025-08-24T10:30:00Z",
    "created_by": "user_abc123",
    "default_guardrail_id": "595d5849-7e86-51fd-a7c0-705c34e4afff",
    "default_image_model": "openai/dall-e-3",
    "default_provider_sort": "price",
    "default_text_model": "openai/gpt-4o",
    "description": "Production environment workspace",
    "disabled_server_tools": null,
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "include_byok_in_budgets": false,
    "io_logging_api_key_ids": null,
    "io_logging_sampling_rate": 1,
    "is_data_discount_logging_enabled": true,
    "is_observability_broadcast_enabled": false,
    "is_observability_io_logging_enabled": false,
    "name": "Production",
    "slug": "production",
    "updated_at": null
  }
}

Changes

Changed in 4 of the 303 revisions of this API.54

  • 16644b6a015e2See the full diff
    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the optional property ///// to the response with the status

      response-optional-property-added

  • c506a198e46b1See the full diff
    • ○

      added the optional property ///// to the response with the status

      response-optional-property-added

  • e2999258bc391See the full diff
    • ○

      added the required property ///// to the response with the status

      response-required-property-added

  • c91cc6f88caa5See the full diff
    • ▲

      the request property became not nullable

      request-property-became-not-nullable

    • ▲

      the request property became not nullable

      request-property-became-not-nullable

    • ▲

      the request property became not nullable

      request-property-became-not-nullable

    • ▲

      the request property became not nullable

      request-property-became-not-nullable

    • ▲

      the request property became not nullable

      request-property-became-not-nullable