hierarchy

Create a project.

Changed on

Not idempotent: each call creates a distinct project. The name must be unused among the organisation's live projects; a collision is a conflict, decided after authorization so it discloses nothing a caller could not already read.

post/api/v1/orgs/{org}/projects

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/v1/orgs/{org}/projects
  • Auth: HTTP bearer

Request body

namestring required

A display name for an organisation, project or environment. Identity is the immutable id, so this is a label and a rename never breaks a reference. The 128-byte bound is the one the organisation contract has carried since the first slice, adopted for every entity so there is one number rather than four; no ADR fixes a per-entity name length. The grammar itself (non-empty, no control characters, no surrounding whitespace) is enforced in the domain rather than restated as a pattern here — two grammars would be two things to keep in sync.

The bound is 128 UTF-8 BYTES, and the server is authoritative. maxLength below counts Unicode code points, which is the only length JSON Schema can express, so a name of 100 emoji satisfies this schema and is still refused by the server with bad_request. Clients that want to pre-validate must measure the UTF-8 encoding, not the string length.

acknowledgementsstring[]

Secret-scanning acknowledgement tokens (#74). On a value write, a keep-as-config token dismisses a Surface-1 warning for exactly that value. On a declaration write, one override token per finding is re-scanned against the current content; a stale, version-skewed, or surplus token is rejected by name. There is no blanket ignore-all input.

Response

The created project.

can_manage_policyboolean

Whether the caller can manage policy for this project.

can_deleteboolean

Whether the caller can delete this project.

idstring required

A prefixed UUIDv7, e.g. org_0198….

org_idstring required

A prefixed UUIDv7, e.g. org_0198….

namestring required
created_atstring date-time required

RFC 3339 UTC, microsecond precision.

Changes

  • 54b2780eec85Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • f84a1cd8a05aRevision changes
    • warning

      added the new payload_too_large enum value to the / response property for the response status

    • warning

      added the new payload_too_large enum value to the / response property for the response status

    • warning

      added the new payload_too_large enum value to the / response property for the response status

    • warning

      added the new payload_too_large enum value to the / response property for the response status

    • warning

      added the new payload_too_large enum value to the / response property for the response status

    • warning

      added the new payload_too_large enum value to the / response property for the response status

    • warning

      added the new payload_too_large enum value to the / response property for the response status

    • warning

      added the new unprocessable enum value to the / response property for the response status

    • warning

      added the new unprocessable enum value to the / response property for the response status

    • warning

      added the new unprocessable enum value to the / response property for the response status

    • warning

      added the new unprocessable enum value to the / response property for the response status

    • warning

      added the new unprocessable enum value to the / response property for the response status

    • warning

      added the new unprocessable enum value to the / response property for the response status

    • warning

      added the new unprocessable enum value to the / response property for the response status