---
title: "Create a new workspace"
method: POST
path: "/api/workspaces"
tags: ["workspaces"]
---

# Create a new workspace

`POST /api/workspaces`

## Request

- Base URL: `https://api.hillstar.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.hillstar.ai/api/workspaces`
- Auth: none declared

## Request body

- WorkspaceCreateRequest
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `include_default_categories` boolean, required: Seed HillStar's standard evaluation categories
  - `name` string, required: Workspace name (required, non-empty)

## Response `201`

Created

- WorkspaceResponse
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `created_at` string, date-time, required
  - `created_by_user_id` integer, nullable, required
  - `id` integer, required
  - `name` string, required
  - `ui_config` object, required
  - `updated_at` string, date-time, required

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/hillstar/apis/rfpai-api-go.md) - [All operations](https://skmtc.dev/hillstar/apis/rfpai-api-go/llms.txt) - [OpenAPI document](https://skmtc.dev/hillstar/apis/rfpai-api-go/revisions/b2532dc47fc6?raw)