Create a workspace | OpenRouter

curl -X POST https://openrouter.ai/api/v1/workspaces \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Production",
  "slug": "production",
  "default_image_model": "openai/dall-e-3",
  "default_provider_sort": "price",
  "default_text_model": "openai/gpt-4o",
  "description": "Production environment workspace"
}'

{
  "data": {
    "created_at": "2025-08-24T10:30:00Z",
    "created_by": "user_abc123",
    "default_image_model": "openai/dall-e-3",
    "default_provider_sort": "price",
    "default_text_model": "openai/gpt-4o",
    "description": "Production environment workspace",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "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
  }
}

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

Authentication

AuthorizationBearer

API key as bearer token in Authorization header

Request

This endpoint expects an object.

namestringRequired1-100 characters

Name for the new workspace

slugstringRequiredformat: "^[a-z0-9]+(?:-[a-z0-9]+)*$"1-50 characters

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

default_image_modelstring or nullOptional

Default image model for this workspace

default_provider_sortstring or nullOptional

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

default_text_modelstring or nullOptional

Default text model for this workspace

descriptionstring or nullOptional<=500 characters

Description of the workspace

io_logging_api_key_idslist of integers or nullOptional

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

io_logging_sampling_ratedoubleOptional

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

is_data_discount_logging_enabledbooleanOptional

Whether data discount logging is enabled

is_observability_broadcast_enabledbooleanOptional

Whether broadcast is enabled

is_observability_io_logging_enabledbooleanOptional

Whether private logging is enabled

Response

Workspace created successfully

dataobject

The created workspace

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error