Sign in

v1

latestOpenAPI 3.0.3MIT2026-07-1411163326.7 KB
Project

Create a new project

Create a new project. Works for all organization types.

post/organization/{org-slug-or-id}/project

Path parameters

org-slug-or-idstring required

Org UUID or slug in the form vcs-slug/org-name. For projects that use GitLab or GitHub App, use circleci as the vcs-slug and replace the org-name with the organization ID (found in Organization Settings).

Request body

namestring required

The name of the project

Example request

{
  "name": "api-preview-docs"
}

Response

The new project

slugstring required

Project slug in the form vcs-slug/org-name/repo-name. The / characters may be URL-escaped. For projects that use GitLab or GitHub App, use circleci as the vcs-slug, replace org-name with the organization ID (found in Organization Settings), and replace repo-name with the project ID (found in Project Settings).

namestring required

The name of the project

idstring uuid required
organization_namestring required

The name of the organization the project belongs to

organization_slugstring required

The slug of the organization the project belongs to

organization_idstring uuid required

The id of the organization the project belongs to

Example response

{
  "slug": "gh/CircleCI-Public/api-preview-docs",
  "name": "api-preview-docs",
  "organization_name": "CircleCI-Public",
  "organization_slug": "gh/CircleCI-Public",
  "organization_id": "ec6887ec-7d44-4b31-b468-7e552408ee32",
  "vcs_info": {
    "vcs_url": "https://github.com/CircleCI-Public/api-preview-docs",
    "default_branch": "main"
  }
}