Projects

Create Project

Create a new project inside an organization. Optionally mints a project-scoped API key in the same call when mintKey: true is sent in the body; the key (if minted) is returned alongside the project.

post/v1/management/organizations/{org_id}/projects

Request

  • Base URL: https://api.withone.ai
  • URL: https://api.withone.ai/v1/management/organizations/{org_id}/projects
  • Auth: API key in header X-One-Secret

Path parameters

org_idstring uuid required

Organization ID

Request body

descriptionstring nullable

Optional project description.

keyNamestring nullable

Optional label for the new key. Only meaningful when mintKey is true; ignored otherwise. Validated in the handler when mintKey is true so callers that always submit an empty keyName without minting are not rejected.

mintKeyboolean

When true, mint a project-scoped API key alongside the project and return it in the response. Defaults to false.

namestring required

Human-readable project name.

Response

Project created (and key minted when requested)

Changes

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