---
title: "Start V3 Upgrade"
method: POST
path: "/companies/{company_id}/v3-upgrade"
tags: ["founding"]
---

# Start V3 Upgrade

`POST /companies/{company_id}/v3-upgrade`

## 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}/v3-upgrade`
- Auth: HTTP bearer

Open a switch interview for an existing v2 company (spec 2026-08-26).

## Path parameters

- `company_id` string, uuid, required

## Headers

- `X-Posthog-Session-Id` string, nullable
- `X-Client-Mobile` string, nullable

## Response `201`

Successful Response

- FoundingResponse
  - `id` string, required
  - `status` string, required
  - `founding_requested_at` string, date-time, nullable
  - `idea` string, required
  - `name` string, nullable, required
  - `handle` string, nullable, required
  - `company_id` string, nullable, required
  - `session_id` string, nullable, required
  - `error` string, nullable, required
  - `interrupt_requested_at` string, date-time, nullable
  - `kind` string
  - `runtime` string
  - `interview_session_id` string, nullable
  - `origin_kind` string
  - `import_repo_full_name` string, nullable
  - `import_branch` string, nullable
  - `import_status` string, nullable
  - `import_error` string, nullable
  - `import_updated_at` string, date-time, nullable
  - `import_retryable` boolean
  - `import_provider` string, nullable
  - `import_source` FoundingImportSource: The project a start imports, provider-neutral, for the source card.
    - `provider` string, required
    - `name` string, required
    - `url` string, nullable
    - `detail` string, nullable
  - `import_phase` string, nullable
  - `import_failure_reason` string, nullable
  - `import_next_action` string, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-02** `c4a504a5119e`: 5 info
  - added the optional property `import_failure_reason` to the response with the `201` status
  - added the optional property `import_next_action` to the response with the `201` status
  - added the optional property `import_phase` to the response with the `201` status
  - added the optional property `import_provider` to the response with the `201` status
  - …1 more
- **2026-10-01** `92927828a2d0`: 1 info
  - added the optional property `founding_requested_at` to the response with the `201` status
- **2026-09-28** `9c76d9123b22`: 9 info
  - added the optional property `import_branch` to the response with the `201` status
  - added the optional property `import_error` to the response with the `201` status
  - added the optional property `import_repo_full_name` to the response with the `201` status
  - added the optional property `import_retryable` to the response with the `201` status
  - …5 more

[Operation history](https://skmtc.dev/nanocorp/apis/nanocorp-api/changes/companies/:company_id/v3-upgrade/post.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)