Skip to main content
POST
/
o
/
{organisation_id}
/
projects
Create new project
curl --request POST \
  --url https://platform.versori.com/api/v2/o/{organisation_id}/projects \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "id": "<string>"
}
'
{
  "id": "<string>",
  "environments": [
    {
      "id": "<string>",
      "name": "<string>",
      "status": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "publicUrl": "<string>",
      "files": [
        {
          "filename": "<string>",
          "content": "<string>"
        }
      ],
      "labels": {}
    }
  ],
  "name": "<string>",
  "currentFiles": {
    "files": [
      {
        "filename": "<string>",
        "content": "<string>"
      }
    ],
    "labels": {}
  },
  "createdAt": "2023-11-07T05:31:56Z",
  "settings": {
    "acceptCodeChangesAutomatically": true
  },
  "dynamicVariablesSchema": {}
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication used by the Versori Platform. You must provide a signed JWT provided by our IdP.

Path Parameters

​
organisation_id
string<ulid>
required

Body

application/json

ProjectCreate is the request body for creating a new Project.

​
name
string
required

Name is the name of the project.

​
id
string<ulid>

The unique identifier for the project.

Response

OK

The Project represents a deployable unit within our platform that includes both the functional components (files) and configuration. It serves as the backbone of custom or predefined functionalities, allowing organizations to create, update, and manage APIs and projects.

​
id
string<ulid>
required

The unique identifier for the project.

​
environments
object[]
required

List of environments for the project.

​
name
string
required
​
currentFiles
object
required
​
createdAt
string<date-time>
required
​
settings
object
required

ProjectSettings hold configuration for the project

​
dynamicVariablesSchema
object

DynamicVariablesSchema is the JSON schema for the project's dynamic variables.