---
title: "CreateProject creates a new project"
method: POST
path: "/v1/orgs/{org}/projects"
---

# CreateProject creates a new project

`POST /v1/orgs/{org}/projects`

## Path parameters

- `org` string, required

## Request body

- object
  - `archiveAssetId` string — archive_asset_id is set for projects whose project files are not stored in github but are managed by rill.
  - `description` string
  - `devSlots` string, int64
  - `directoryName` string — directory_name should be the most recently observed local directory name for the project. See ListProjectsForFingerprint for more context.
  - `gitRemote` string — git_remote is set for projects whose project files are stored in Git. It currently only supports Github remotes. It should be a HTTPS remote ending in .git for github.com. Either git_remote or archive_asset_id should be set.
  - `primaryBranch` string
  - `prodSlots` string, int64
  - `prodVersion` string
  - `project` string
  - `provisioner` string
  - `public` boolean
  - `skipDeploy` boolean
  - `subpath` string

## Response `200`

A successful response.

- V1CreateProjectResponse
  - `project` V1Project
    - `annotations` object
    - `archiveAssetId` string
    - `createdByUserId` string
    - `createdOn` string, date-time
    - `description` string
    - `devSlots` string, int64
    - `devTtlSeconds` string, int64
    - `directoryName` string
    - `frontendUrl` string — Note: Does NOT incorporate the parent org's custom domain.
    - `gitRemote` string
    - `id` string
    - `managedGitId` string — managed_git_id is set if the project is connected to a rill-managed git repo.
    - `name` string
    - `orgId` string
    - `orgName` string
    - `overrideDiskGb` string, int64
    - `primaryBranch` string
    - `primaryDeploymentId` string
    - `prodSlots` string, int64
    - `prodTtlSeconds` string, int64
    - `prodVersion` string
    - `provisioner` string
    - `public` boolean
    - `subpath` string
    - `updatedOn` string, date-time

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/rilldata/apis/rill-admin-api.md) · [All operations](https://skmtc.net/rilldata/apis/rill-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rilldata/rill-admin-api/versions/289a0ca9ce49/schema)