Projects /

Create project

Creates a new project.

Required permission

Project > Projects > Manage > Create

Request body

{object}
Create a project in a Northflank region

name
string required
The name of the project.
min length
3
max length
39
pattern
^[a-zA-Z]((-|\s)?[a-zA-Z0-9]+((-|\s)[a-zA-Z0-9]+)*)?$
description
string
The description of the project.
max length
200
pattern
^[a-zA-Z0-9.,?\s\\/'"()[\];`%^&*\-_:!]+$
color
string
The color of the project in the Northflank App.
pattern
^#([a-f0-9]{6}|[a-f0-9]{3})$/
region
string
The region the project will be hosted in.

{object}
Create a project in a BYOC cluster

name
string required
The name of the project.
min length
3
max length
39
pattern
^[a-zA-Z]((-|\s)?[a-zA-Z0-9]+((-|\s)[a-zA-Z0-9]+)*)?$
description
string
The description of the project.
max length
200
pattern
^[a-zA-Z0-9.,?\s\\/'"()[\];`%^&*\-_:!]+$
color
string
The color of the project in the Northflank App.
pattern
^#([a-f0-9]{6}|[a-f0-9]{3})$/
clusterId
string
The BYOC cluster this project will be hosted in.
min length
3
max length
20
pattern
^[a-z]-?[a-z0-9]+(-[a-z0-9]+)*$

Response body

{object}
Response object.

data
(multiple options: oneOf) required

{object}

Create a project in a Northflank region

name
string required
The name of the project.
min length
3
max length
39
pattern
^[a-zA-Z]((-|\s)?[a-zA-Z0-9]+((-|\s)[a-zA-Z0-9]+)*)?$
description
string
The description of the project.
max length
200
pattern
^[a-zA-Z0-9.,?\s\\/'"()[\];`%^&*\-_:!]+$
color
string
The color of the project in the Northflank App.
pattern
^#([a-f0-9]{6}|[a-f0-9]{3})$/
region
string
The region the project will be hosted in.

{object}

Create a project in a BYOC cluster

name
string required
The name of the project.
min length
3
max length
39
pattern
^[a-zA-Z]((-|\s)?[a-zA-Z0-9]+((-|\s)[a-zA-Z0-9]+)*)?$
description
string
The description of the project.
max length
200
pattern
^[a-zA-Z0-9.,?\s\\/'"()[\];`%^&*\-_:!]+$
color
string
The color of the project in the Northflank App.
pattern
^#([a-f0-9]{6}|[a-f0-9]{3})$/
clusterId
string
The BYOC cluster this project will be hosted in.
min length
3
max length
20
pattern
^[a-z]-?[a-z0-9]+(-[a-z0-9]+)*$

API

CLI

JS Client

POST /v1/projects

Example request

Request body

Create a project in a Northflank region

curl

curl --header "Content-Type: application/json" \
  --header "Authorization: Bearer NORTHFLANK_API_TOKEN" \
  --request POST \
  --data '{"name":"New Project","description":"This is a new project.","color":"#EF233C","region":"europe-west"}' \
  https://api.northflank.com/v1/projects

Create a project in a BYOC cluster

curl

curl --header "Content-Type: application/json" \
  --header "Authorization: Bearer NORTHFLANK_API_TOKEN" \
  --request POST \
  --data '{"name":"New Project","description":"This is a new project.","color":"#EF233C","clusterId":"gcp-cluster-1"}' \
  https://api.northflank.com/v1/projects

Example response

200 OK

Details about the created project.

JSON

{
  "data": {
    "name": "New Project",
    "description": "This is a new project.",
    "color": "#EF233C",
    "region": "europe-west"
  }
}

JSON

{
  "data": {
    "name": "New Project",
    "description": "This is a new project.",
    "color": "#EF233C",
    "clusterId": "gcp-cluster-1"
  }
}