G-g-core
Projects

Create project

Changed on

Create a new project for a client. Project management must be enabled to perform this operation.

post/cloud/v1/projects

Request

  • Base URL
    https://api.gcore.com
  • URL
    https://api.gcore.com/cloud/v1/projects
  • Auth
    HTTP apikey

Request body

descriptionstring nullable

Description of the project.

namestring required

Unique project name for a client. Each client always has one "default" project.

Example request

{
  "description": "Project description",
  "name": "my-project"
}

Response

Created

client_idinteger required

ID associated with the client.

created_atstring date-time required

Datetime of creation, which is automatically generated.

deleted_atstring date-time nullable required

Datetime of deletion, which is automatically generated if the project is deleted.

descriptionstring nullable required

Description of the project.

idinteger required

Project ID, which is automatically generated upon creation.

is_defaultboolean required

Indicates if the project is the default one. Each client always has one default project.

namestring required

Unique project name for a client.

statestring required

The state of the project.

task_idstring nullable required

The UUID of the active task that currently holds a lock on the resource. This lock prevents concurrent modifications to ensure consistency. If null, the resource is not locked.

Example response

{
  "client_id": 1,
  "created_at": "2019-12-31T23:59:59Z",
  "description": "Project description",
  "id": 1,
  "is_default": true,
  "name": "default",
  "state": "ACTIVE",
  "task_id": "7244e161-664c-4afd-a34e-7003eac4d949"
}

Changes

  • a2b772345f3aRevision changes
    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status