Create a project from captured commercial facts. Pricing, economics and geography fields (customer_price, economics, factory_cost, margin, currency, region, state, country) are rejected with 400 — this surface captures facts only. Returns the full RPC result including the project id.

post/projects

Request

  • Base URL: https://forbiz.io/api/public/agent
  • URL: https://forbiz.io/api/public/agent/projects
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Recommended on every mutating request. A replay with the same key is NOT applied twice: the server answers { ok, idempotent_replay: true, first_seen_at, status } describing the first attempt.

Request body

namestring
locationstring
primaryOrganizationIdstring
primaryPersonIdstring
commercialStageNamestring
lifecycleStatusstring
notesstring
sourcestring
purpose'real' | 'test' | 'fictional' | 'demo'

Why this project exists. Default real. A project created to practice should be created with purpose 'test' so it never competes with real commitments. Anything other than real is excluded from /next, /state queues and counts, the nudges and the digest, while staying in /search, /export and every direct read.

Response

Created

object required

Changes

No recorded changes to this operation across all 1 revision of this API.