---
title: "Update Company"
method: PUT
path: "/companies/{company_id}"
tags: ["companies"]
---

# Update Company

`PUT /companies/{company_id}`

## Request

- Base URL: `https://api.nanocorp.so` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nanocorp.so/companies/{company_id}`
- Auth: HTTP bearer

Update a company.

## Path parameters

- `company_id` string, uuid, required

## Request body

- UpdateCompanyRequest
  - `one_liner` string, nullable
  - `mission` string, nullable
  - `status` 'draft' | 'active' | 'paused' | 'archived'
  - `cycle_interval_seconds` integer, nullable
  - `max_daily_tasks` integer, nullable
  - `custom_domain` string, nullable
  - `outbound_email_paused` boolean, nullable
  - `outbound_prospect_search_paused` boolean, nullable
  - `status_emails_paused` boolean, nullable
  - `source` string, nullable

## Response `200`

Successful Response

- CompanyResponse
  - `id` string, required
  - `conglomerate_id` string, required
  - `name` string, required
  - `handle` string, required
  - `one_liner` string, nullable
  - `mission` string, nullable
  - `initial_prompt` string, nullable
  - `status` 'draft' | 'active' | 'paused' | 'archived', required
  - `balance_cents` integer
  - `balance_real_cents` integer
  - `github_repo_url` string, nullable
  - `github_repo_full_name` string, nullable
  - `cycle_interval_seconds` integer
  - `max_daily_tasks` integer
  - `tasks_used_today` integer
  - `harness_version` number
  - `custom_domain` string, nullable
  - `custom_domain_verified` boolean
  - `email_address` string
  - `platform_email_address` string
  - `website_url` string
  - `dashboard_url` string
  - `outbound_email_paused` boolean
  - `outbound_prospect_search_paused` boolean
  - `status_emails_paused` boolean
  - `selling_paused` boolean
  - `open_ask_count` integer
  - `open_proposal_count` integer
  - `next_scheduled_run_at` string, date-time, nullable
  - `active_routine_task_ids` string[]
  - `coordinator_session_id` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-20** `f9255294952f`: 1 info
  - added the optional property `coordinator_session_id` to the response with the `200` status
- **2026-09-19** `734278ef1b5b`: 2 info
  - added the optional property `email_address` to the response with the `200` status
  - added the optional property `platform_email_address` to the response with the `200` status
- **2026-09-11** `97b262b63810`: 3 info
  - added the optional property `active_routine_task_ids` to the response with the `200` status
  - added the optional property `next_scheduled_run_at` to the response with the `200` status
  - added the optional property `open_proposal_count` to the response with the `200` status
- **2026-09-09** `1229e41b14fd`: 1 info
  - added the optional property `open_ask_count` to the response with the `200` status
- **2026-09-08** `ce91d2efae25`: 1 info
  - added the optional property `dashboard_url` to the response with the `200` status

[Operation history](https://skmtc.dev/nanocorp/apis/nanocorp-api/changes/companies/:company_id/put.md)

---

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