> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peaka.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Project

> Creates a new Project within the given Workspace.

A Project is a unit of work where queries, data tables, and semantic catalogs are managed. Projects live inside Workspaces.


<span style={{display: "flex", gap: "10px", flexDirection: "row", alignItems: "center"}}>
  <img src="https://cdn.peaka.com/badges/partner-api-key-badge.png" />
</span>


## OpenAPI

````yaml post /organizations/{organizationId}/workspaces/{workspaceId}/projects
openapi: 3.0.1
info:
  title: Peaka Gateway API
  description: Peaka Gateway API Documentation
  version: '1.0'
servers:
  - url: https://partner.peaka.studio/api/v1
    description: Default Server URL (US Zone)
  - url: https://partner.eu.peaka.studio/api/v1
    description: EU Zone
security:
  - bearerAuth: []
paths:
  /organizations/{organizationId}/workspaces/{workspaceId}/projects:
    post:
      tags:
        - Organization -- Projects
      summary: Create Project
      description: >
        Creates a new Project within the given Workspace.


        A Project is a unit of work where queries, data tables, and semantic
        catalogs are managed. Projects live inside Workspaces.
      operationId: createProject_1
      parameters:
        - name: organizationId
          in: path
          description: ID of the Organization
          required: true
          schema:
            type: string
          example: d0d3c83f-29ed-4f2e-899d-1bfa00eb3cef
        - name: workspaceId
          in: path
          description: ID of the Workspace
          required: true
          schema:
            type: string
          example: 56d43968-e31d-4010-9b75-018a79a51b17
      requestBody:
        description: Project to create
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProjectRequest'
            examples:
              Create Project Example:
                description: Create Project Example
                value:
                  name: Sample Project Name
        required: true
      responses:
        '200':
          description: Project created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Project'
              examples:
                Create Project Example:
                  description: Create Project Example
                  value:
                    id: URNg0GIj
                    name: Sample Project Name
                    description: >-
                      Non accusantium ducimus accusantium. Laborum eum accusamus
                      sit sit hic eaque doloremque. Occaecati blanditiis facere
                      consequuntur consectetur culpa reiciendis hic tempore
                      dolorem. Saepe impedit nam necessitatibus maxime numquam
                      voluptatum cum. Adipisci mollitia blanditiis sint
                      inventore ex commodi occaecati ipsam quas.
                    domain: sampleprojectname-cdcn
                    webhookBaseUrl: https://sampleprojectname-cdcn--test.api.peaka.host
                    createdAt: '2024-09-10T10:11:02.385253956Z'
                    workspaceId: d7f282d2-b392-4b5c-8cea-05f7523df2d2
components:
  schemas:
    ProjectRequest:
      required:
        - name
      type: object
      properties:
        name:
          type: string
          description: Project name
          example: My Project
        description:
          type: string
          description: Descriptive text about the project
          example: This is a project that does something
    Project:
      type: object
      properties:
        id:
          type: string
          description: Project ID
        name:
          type: string
          description: Project name
        description:
          type: string
          description: Descriptive text about the project
        domain:
          type: string
          description: Domain of the project
        webhookBaseUrl:
          type: string
          description: Webhook base URL
        createdAt:
          type: string
          description: The date and time the project was created
        owner:
          type: string
          description: The owner of the project
        workspaceId:
          type: string
          description: The workspace to which the project belongs
      description: Project
  securitySchemes:
    bearerAuth:
      type: http
      description: >-
        Use the Authorization header with the value 'Bearer <apiKey>' to
        authenticate. Partner API Keys have full access; Project API Keys are
        limited to their project scope. Learn more:
        https://docs.peaka.com/api-reference/authentication
      scheme: bearer
      bearerFormat: Api Key

````