Create a new Project

Creates a new project

View as Markdown

POST /v1/project

Needs an API key with the write scope.

Parameters

name string Required

Name of the project

More parameters

startDate string

Starting date of the project. Should be in YYYY-MM-DD format
endDate string

Ending date of the project. Should be in YYYY-MM-DD format
projectCode string

Name of the project
budget number

Total budget of the project.

Returns

The created project.

401: No usable Authorization: Bearer {token} header (1002).
403: The access token is unknown, or lacks the scope this route needs (1001).

POST /v1/project

curl -X POST https://api.nuvio.io/v1/project \
  -H "Authorization: Bearer $NUVIO_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Supplies"
  }'

const response = await fetch('https://api.nuvio.io/v1/project', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.NUVIO_API_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Acme Supplies"
  }),
});
const { data } = await response.json();

import os
import requests

response = requests.post(
    "https://api.nuvio.io/v1/project",
    headers={"Authorization": f"Bearer {os.environ['NUVIO_API_TOKEN']}"},
    json={
        "name": "Acme Supplies",
    },
)
data = response.json()["data"]

Response

{
  "success": true,
  "errors": null,
  "data": {
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "name": "Acme Supplies",
    "budget": 100,
    "startDate": "2026-11-05",
    "endDate": "2026-11-05"
  }
}