Skip to main content
POST
Move a pitch into a client workspace

Authorizations

Authorization
string
header
required

A Searchable API key, created under Manage Account → Integrations → API Keys. Send as Authorization: Bearer sea_xxxxx. Every key carries one or more scopes (read, write, admin) and may optionally be bound to a single project — see Getting started.

Headers

Idempotency-Key
string

Optional client-generated key (e.g. a UUID). Retrying with the same key within 24h replays the original stored response (X-Idempotent-Replay: true) instead of repeating the side effect. See Idempotency.

Path Parameters

pitchId
string<uuid>
required

The pitch's id, from GET /api/mcp/pitches. A pitch is a project, so its id works with every project endpoint too.

Body

application/json
destination
object
required

Where the pitch goes: an existing client workspace, or a new client workspace created for it.

acknowledgedWarnings
enum<string>[]
required

The codes of the warnings the user confirmed: exactly the codes the preview listed, and [] when it listed none.

Maximum array length: 32
Available options:
SAME_WORKSPACE,
DESTINATION_OWNER_MISSING,
PROJECT_STATE_UNSUPPORTED,
CREATOR_DOMAIN_CONFLICT,
SOURCE_DOMAIN_CONFLICT,
ACCESS_GRANTS_WILL_BE_REVOKED,
ACCESS_BINDINGS_WILL_MOVE,
STORAGE_OBJECT_MISSING,
QUOTA_PROJECTS_EXCEEDED,
QUOTA_PROMPTS_EXCEEDED,
IN_FLIGHT_AGENT_RUNS,
SAME_DOMAIN_PROJECTS,
SCHEDULED_REPORTS_WILL_STOP
confirmDomain
string
required

The pitch's domain, as the user typed it.

Required string length: 1 - 2048
previewSignature
string

The previewSignature of the preview of this same destination, passed back unchanged. Needed for an existing workspace; a new client has none.

Required string length: 1 - 256

Response

The pitch is a client project in the destination workspace now.

The pitch is a client project now.

success
boolean
required
workspaceId
string<uuid>
required

The client workspace the pitch moved into: the destination, or the new client's workspace.

projectId
string<uuid>
required

The pitch's id, which is the client project's id now.