Create project

Create project in the credential-bound company. Idempotency-Key is required and stores the terminal response for safe retries for 24 hours. This changes draft or operational data without posting accounting entries. Requires the projects:write OAuth scope.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Fields accepted to create project. The schema identifies required and optional values.

The public create/update contract for a project.

One class for both verbs, the way P13 shares a mutation request: the field
list is identical and only the REQUIRED set differs, so splitting it would
mean maintaining the same twenty rules twice.

PUT is the documented sparse update (§4.5): every rule is sometimes, so a
field the client did not send is not touched — never reset to a default.
A create-only field is rejected with missing, never prohibited:
Laravel's prohibited rule is the negation of required, so it PASSES for
an explicit null, "" or []. {"customer_id": null} therefore reached
patchAttributes() and unlinked the project's customer — leaving that
customer's portal user in the central chat room with no reconciliation to
evict them, the exact damage create-only exists to prevent — and "" hit
the foreign key as a 500. Create-only means ABSENT, which is what missing
actually tests.

Server-owned state is not accepted from a client on either verb:
author_id (the creator, and a budget-alert recipient), task_id_prefix
after creation (it is stamped into every task's human id),
budget_thresholds_notified (alert bookkeeping, re-armed by the server when
the threshold list changes) and the logo upload, which needs a signed upload
session the public contract does not expose yet.

string
enum
required
Allowed:
string
required
length ≤ 255
string
required

Create-only, exactly like PatchProjectRequest. ProjectService's
sharing trigger watches is_client_visible and visibility but
NOT customer_id, so re-pointing a project at another customer
would leave the previous customer's portal user sitting in the
project's central chat room with no reconciliation to evict them.

string
required
string
required
string
required
length between 2 and 3
^[A-Z0-9]+$

Create-only: the prefix is stamped into every task's sequence id,
so renaming it after the fact would rewrite history.

string | null
boolean
string
enum
Allowed:
string
enum
Allowed:
number | null
0 to 999999.99
number | null
0 to 999999.99
boolean
boolean
boolean
boolean
member_ids
array of uuids
length ≤ 200
member_ids
budget_alert_thresholds
array of integers | null

min:1 on purpose: Project::budgetAlertThresholds() falls back to
the canonical 75/90/100 ladder for an empty list, so accepting []
would answer 200 to "alert me at no thresholds" and then alert.
Send null to mean "use the default" explicitly.

budget_alert_thresholds
budget_alert_emails
array of strings | null
budget_alert_emails
report_emails
array of strings | null
report_emails
Headers
string
required
length ≤ 191

Required unique key whose request hash and terminal response are stored durably for 24 hours.

Responses

Language
Credentials
OAuth2
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*