---
title: "Set the company's domain"
method: PUT
path: "/workspace/company-domain"
tags: ["workspace"]
---

# Set the company's domain

`PUT /workspace/company-domain`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/workspace/company-domain`
- Auth: HTTP bearer

The company's own domain, such as acme.com, which a TXT record proves before pages for outsiders show the name as verified (US-PLT-21); null removes it. Hosted Binderwork publishes jobs only under a verified domain.

## Request body

- object
  - `domain` string, nullable, required

## Response `200`

The result.

- object
  - `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

## Other responses

- `202`: Called by an agent or an API key, so the call did not run. A person approves it at approval_url; then GET the Location.
- `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)