Sign in

v8

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2025-10-165266542.4 MB
DigitalOcean-public.v2-new_Projects

Create a Project

To create a project, send a POST request to /v2/projects.

post/v2/projects

Request body

idstring uuid

The unique universal identifier of this project.

owner_uuidstring

The unique universal identifier of the project owner.

owner_idinteger

The integer id of the project owner.

namestring

The human-readable name for the project. The maximum length is 175 characters and the name must be unique.

descriptionstring

The description of the project. The maximum length is 255 characters.

purposestring

The purpose of the project. The maximum length is 255 characters. It can have one of the following values:

  • Just trying out DigitalOcean
  • Class project / Educational purposes
  • Website or blog
  • Web Application
  • Service or API
  • Mobile Application
  • Machine learning / AI / Data processing
  • IoT
  • Operational / Developer tooling

If another value for purpose is specified, for example, "your custom purpose", your purpose will be stored as Other: your custom purpose.

environment'Development' | 'Staging' | 'Production'

The environment of the project's resources.

created_atstring date-time

A time value given in ISO8601 combined date and time format that represents when the project was created.

updated_atstring date-time

A time value given in ISO8601 combined date and time format that represents when the project was updated.

Example request

{
  "id": "4e1bfbc3-dc3e-41f2-a18f-1b4d7ba71679",
  "owner_uuid": "99525febec065ca37b2ffe4f852fd2b2581895e7",
  "owner_id": 258992,
  "name": "my-web-api",
  "description": "My website API",
  "purpose": "Service or API",
  "environment": "Production",
  "created_at": "2018-09-27T20:10:35Z",
  "updated_at": "2018-09-27T20:10:35Z"
}

Response

The response will be a JSON object with a key called project. The value of this will be an object with the standard project attributes

Example response

{
  "project": {
    "id": "4e1bfbc3-dc3e-41f2-a18f-1b4d7ba71679",
    "owner_uuid": "99525febec065ca37b2ffe4f852fd2b2581895e7",
    "owner_id": 258992,
    "name": "my-web-api",
    "description": "My website API",
    "purpose": "Service or API",
    "environment": "Production",
    "created_at": "2018-09-27T20:10:35Z",
    "updated_at": "2018-09-27T20:10:35Z"
  }
}