Skip to content
API Reference
Organization
Projects

Create project

POST/organization/projects

Create a new project in the organization. Projects can be created and archived, but cannot be deleted.

Body ParametersJSONExpand Collapse
name: string

The friendly name of the project, this name appears in reports.

geography: optional "US" or "EU" or "JP" or 5 more

Create the project with the specified data residency region. Your organization must have access to Data residency functionality in order to use. See data residency controls to review the functionality and limitations of setting this field.

Accepts one of the following:
"US"
"EU"
"JP"
"IN"
"KR"
"CA"
"AU"
"SG"
ReturnsExpand Collapse
Project = object { id, created_at, name, 3 more }

Represents an individual project.

id: string

The identifier, which can be referenced in API endpoints

created_at: number

The Unix timestamp (in seconds) of when the project was created.

name: string

The name of the project. This appears in reporting.

object: "organization.project"

The object type, which is always organization.project

status: "active" or "archived"

active or archived

Accepts one of the following:
"active"
"archived"
archived_at: optional number

The Unix timestamp (in seconds) of when the project was archived or null.

Create project

curl https://api.openai.com/v1/organization/projects \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -d '{
          "name": "name"
        }'
{
  "id": "id",
  "created_at": 0,
  "name": "name",
  "object": "organization.project",
  "status": "active",
  "archived_at": 0
}
Returns Examples
{
  "id": "id",
  "created_at": 0,
  "name": "name",
  "object": "organization.project",
  "status": "active",
  "archived_at": 0
}