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

# Create a workspace

`POST /workspaces`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/workspaces`
- Auth: HTTP bearer

Creates a workspace for a company and makes the caller its owner. With `founder`, also records the caller as an officer and as a party.

## Request body

- object
  - `legal_name` string, required
  - `entity_type` 'corporation' | 'llc' | 'other', required
  - `jurisdiction` string, required
  - `founder` object
    - `legal_name` string, required
    - `email` string, email, required
    - `title` string, required
    - `director_or_manager` boolean

## Response `200`

The result.

- object
  - `workspace` object, required
    - `id` string, required
    - `slug` string, required
    - `legal_name` string, required
    - `entity_type` 'corporation' | 'llc' | 'other', required
    - `jurisdiction` string, required
    - `address` object, nullable, required
      - `lines` string[], required
      - `country` string, required: ISO 3166-1 alpha-2
      - `region` string
    - `fiscal_year_end` string, nullable, required
    - `formation_date` string, date, nullable, required
    - `policies` object, required
      - `agent_connections` boolean, required
      - `ai_features` boolean, required
      - `match_fields_with_ai` boolean, required
      - `check_drafts_with_ai` boolean, required
      - `file_uploads_with_ai` boolean, required
      - `preshare_with_ai` boolean, required
      - `questions_with_ai` boolean, required
      - `answer_drafts_with_ai` boolean, required
      - `digest_summary_with_ai` boolean, required
      - `template_search_with_ai` boolean, required
      - `no_public_links` boolean, required
      - `agent_links` boolean, required
      - `agent_links_daily_cap` integer, required
      - `fundraising_in_chats` 'on' | 'off', required
      - `hiring_in_chats` 'on' | 'off', required
    - `link_domain` object, nullable, required
      - `domain` string, required
      - `verified` boolean, required
      - `txt_name` string, required
      - `txt_value` string, required
    - `company_domain` object, nullable, required
      - `domain` string, required
      - `verified` boolean, required
      - `txt_name` string, required
      - `txt_value` string, required
    - `brand` object, required
      - `sender_name` string, nullable, required
      - `color` string, nullable, required
      - `logo` boolean, required
      - `footer_line` boolean, required
    - `created_at` string, date-time, required
  - `officer` object, nullable, required
    - `id` string, required
    - `member_id` string, required
    - `party_id` string, nullable, required
    - `title` string, required
    - `capacity` 'corporate_officer' | 'llc_manager' | 'other', required
    - `from_date` string, date, required
    - `to_date` string, date, nullable, required
    - `active` boolean, required
    - `created_at` string, date-time, required
  - `party` object, nullable, required
    - `id` string, required
    - `kind` 'individual' | 'entity' | 'joint', required
    - `legal_name` string, required
    - `emails` string[], required
    - `roles` string[], required
    - `address` object, nullable, required
      - `lines` string[], required
      - `country` string, required: ISO 3166-1 alpha-2
      - `region` string
    - `signatories` object[], required
      - `name` string, required
      - `title` string, required
      - `email` string, email, required
    - `member_id` string, nullable, required
    - `entered_by_agent` boolean, required
    - `source_quote` string, nullable, required
    - `archived` boolean, required
    - `created_at` string, date-time, required

## Other responses

- `default`: An RFC 9457 problem.

---

[API](https://skmtc.dev/binderwork/apis/binderwork-api.md) · [All operations](https://skmtc.dev/binderwork/apis/binderwork-api/llms.txt) · [OpenAPI document](https://skmtc.dev/binderwork/apis/binderwork-api/revisions/f8fab0ebee53?raw)