> ## Documentation Index > Fetch the complete documentation index at: https://docs.aui.io/llms.txt > Use this file to discover all available pages before exploring further. # Create project > Create a project in your organization. Projects group agents. ## OpenAPI ````yaml https://api-v3.aui.io/apollo-api/openapi.json post /management/v1/projects openapi: 3.1.0 info: title: Apollo API description: >- Build conversational experiences on your agents and manage them programmatically. The API has two surfaces: - **Messaging** (`/messaging/v1`) — send end-user messages to your agent and read conversations back. Replies are available as a single JSON response, a Server-Sent Events token stream (`POST /messaging/v1/messages/stream`), or a bidirectional WebSocket session (see the companion AsyncAPI document at `/asyncapi.yaml`). - **Management** (`/management/v1`) — manage agents, their versions, projects, and conversation threads. **Authentication** — exchange your publishable key for a short-lived access token at `POST /management/v1/auth/token`, then send it as `Authorization: Bearer `. Management endpoints also accept an organization API key via the `x-organization-api-key` header. **Errors** — every failure returns `{"error": {"code", "message", "request_id", "details"}}`. Branch on the stable `code`; include `request_id` when contacting support. version: 0.1.0 servers: - url: https://api-v3.aui.io/apollo-api security: [] tags: - name: Auth description: >- Exchange a credential for a short-lived access token — start here. Send the token as `Authorization: Bearer ` on every other endpoint (management endpoints also accept an organization API key via the `x-organization-api-key` header). - name: Messaging description: >- Talk to your agent: send end-user messages (JSON reply or SSE token stream), rerun an interaction, and read a conversation's messages and reasoning traces. Threads are created automatically on the first message — pass the returned `thread_id` to continue a conversation. - name: Channels description: >- Reach end users on WhatsApp and SMS: send the opening message and bind the recipient's phone number to a conversation thread; replies flow through the same thread. - name: Threads description: >- Conversation threads: list and filter them, fetch one with its transcript and traces, and update its title. - name: Agents description: Create and manage the agents in a project. - name: Agent Versions description: >- An agent's configuration versions: list and inspect them, and publish a new live version. - name: Projects description: Projects group your agents within an organization. - name: Health description: Service liveness. paths: /management/v1/projects: post: tags: - Projects summary: Create project description: Create a project in your organization. Projects group agents. operationId: create_project requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProjectCreateRequest' responses: '201': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/Project' '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Bad Request '401': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Forbidden '404': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Not Found '409': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Conflict '422': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unprocessable Content '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Internal Server Error security: - bearerAuth: [] - organizationApiKey: [] components: schemas: ProjectCreateRequest: properties: name: type: string maxLength: 100 minLength: 2 title: Name description: Project name additionalProperties: false type: object required: - name title: ProjectCreateRequest description: Create a project. Project: properties: id: type: string pattern: ^[0-9a-fA-F]{24}$ title: Id description: Project id name: type: string title: Name description: Project name created_at: type: string format: date-time title: Created At description: Creation timestamp updated_at: type: string format: date-time title: Updated At description: Last update timestamp type: object required: - id - name - created_at - updated_at title: Project description: A project — groups your agents within an organization. ErrorResponse: properties: error: $ref: '#/components/schemas/ErrorBody' type: object required: - error title: ErrorResponse description: The single envelope every Apollo error response conforms to. ErrorBody: properties: code: type: string title: Code description: >- Stable, namespaced machine code clients branch on (e.g. "not_found" or "agents.not_found"). THE branch point -- open/extensible, append-only. message: type: string title: Message description: >- Human-readable explanation. NOT part of the contract; may change anytime. Clients must never parse or branch on this. request_id: anyOf: - type: string - type: 'null' title: Request Id description: Trace id for support correlation. details: anyOf: - items: $ref: '#/components/schemas/ErrorDetail' type: array - type: 'null' title: Details description: Optional structured sub-errors (e.g. per-field validation failures). type: object required: - code - message title: ErrorBody description: |- The error body an end user receives when interacting with Apollo. ``code`` is the stable, machine-readable branch point clients switch on. ``message`` is human-readable and explicitly NOT part of the contract -- it may change at any time and must never be parsed. ErrorDetail: properties: field: anyOf: - type: string - type: 'null' title: Field message: type: string title: Message type: object required: - message title: ErrorDetail description: A single structured sub-error (e.g. one field's validation failure). securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Access token from `POST /management/v1/auth/token` (publishable-key exchange) or a login session. Publishable-key tokens are agent-scoped and serve the messaging surface; login tokens also serve management. organizationApiKey: type: apiKey in: header name: x-organization-api-key description: >- Organization API key — alternative to a Bearer token on the management surface. ````