Create Project
Create a new project.
This endpoint creates a project under the specified organization using the
provided identifiers and configuration. Both org_id and project_id
follow the rules: no slashes; only letters, numbers, underscores,
hyphens, and Unicode characters.
Each project acts as an isolated memory namespace. All memories (episodes) inserted into a project belong exclusively to that project. Queries, listings, and any background operations such as memory summarization or knowledge extraction only access data within the same project. No cross-project memory access is allowed.
If a project with the same ID already exists within the organization, the request will fail with an error.
Returns the fully resolved project record, including configuration defaults applied by the system.
Body
Specification model for creating a new project.
A project belongs to an organization and has its own identifiers, description, and configuration. The project ID must be unique within the organization.
The unique identifier of the organization.
- Must not contain slashes (`/`).
- Must contain only letters, numbers, underscores, hyphens, and Unicode
characters (e.g., Chinese/Japanese/Korean). No slashes or other symbols
are allowed.
This value determines the namespace the project belongs to.The identifier of the project.
- Must be unique within the organization.
- Must not contain slashes (`/`).
- Must contain only letters, numbers, underscores, hyphens, and Unicode
characters (e.g., Chinese/Japanese/Korean). No slashes or other symbols
are allowed.
This ID is used in API paths and resource locations.A human-readable description of the project.
Used for display purposes in UIs and dashboards.
Optional; defaults to an empty string.Configuration settings associated with this project.
Defines which models (reranker, embedder) to use. If any values within
`ProjectConfig` are empty, global defaults are applied.Response
Successful Response
Response model returned after project operations (e.g., creation, update, fetch).
Contains the resolved identifiers and configuration of the project as stored
in the system. Field formats follow the same validation rules as in
CreateProjectSpec.
The unique identifier of the organization this project belongs to.
Returned exactly as stored by the system.The identifier of the project.
This value uniquely identifies the project within the organization.A human-readable description of the project.
Used for display purposes in UIs and dashboards.
Optional; defaults to an empty string.Configuration settings associated with this project.
Defines which models (reranker, embedder) to use. If any values within
`ProjectConfig` are empty, global defaults are applied.