Create a project

POST

/projects

const url = 'https://api.de.teamgrid.app/v1/projects';
const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': 'example',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: '{"additionalContactIds":["example"],"color":"example","contactId":"example","description":"example","dueAt":"2026-04-15T12:00:00Z","individualId":"example","listId":"example","managerId":"example","name":"example","plannedEndAt":"2026-04-15T12:00:00Z","plannedStartAt":"2026-04-15T12:00:00Z","showInScheduling":true,"subscriberIds":["example"]}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://api.de.teamgrid.app/v1/projects \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example' \
  --data '{ "additionalContactIds": [ "example" ], "color": "example", "contactId": "example", "description": "example", "dueAt": "2026-04-15T12:00:00Z", "individualId": "example", "listId": "example", "managerId": "example", "name": "example", "plannedEndAt": "2026-04-15T12:00:00Z", "plannedStartAt": "2026-04-15T12:00:00Z", "showInScheduling": true, "subscriberIds": [ "example" ] }'

Authorizations

bearerAuth

Parameters

Header Parameters

Idempotency-Key

required

string

>= 1 characters <= 128 characters /^[!-~]+$/

Unique request key retained for seven days. Within that window, reuse with different data is rejected.

Request Body^required

application/json

object

additionalContactIds

Array<string> | null

<= 500 items

color

string | null

<= 64 characters

contactId

string | null

<= 128 characters

description

string | null

<= 50000 characters

dueAt

string | null format: date-time

individualId

string | null

<= 500 characters

listId

string | null

<= 128 characters

managerId

string | null

<= 128 characters

name

required

string

>= 1 characters <= 500 characters

plannedEndAt

string | null format: date-time

plannedStartAt

string | null format: date-time

showInScheduling

boolean | null

subscriberIds

Array<string> | null

<= 500 items

Example^generated

{
  "additionalContactIds": [
    "example"
  ],
  "color": "example",
  "contactId": "example",
  "description": "example",
  "dueAt": "2026-04-15T12:00:00Z",
  "individualId": "example",
  "listId": "example",
  "managerId": "example",
  "name": "example",
  "plannedEndAt": "2026-04-15T12:00:00Z",
  "plannedStartAt": "2026-04-15T12:00:00Z",
  "showInScheduling": true,
  "subscriberIds": [
    "example"
  ]
}

Responses

200

An idempotent replay of an existing resource.

application/json

object

data

required

object

attributes

required

object

additionalContactIds

required

Array<string>

archived

required

boolean

color

required

string | null

completed

required

boolean

contactId

required

string | null

createdAt

required

string | null format: date-time

description

required

string

dueAt

required

string | null format: date-time

individualId

required

string | null

listId

required

string | null

managerId

required

string | null

name

required

string

plannedEndAt

required

string | null format: date-time

plannedStartAt

required

string | null format: date-time

showInScheduling

required

boolean

subscriberIds

required

Array<string>

updatedAt

required

string | null format: date-time

required

string

type

required

Allowed value: project

meta

required

object

requestId

required

string

Example

{
  "data": {
    "type": "project"
  }
}

Headers

Idempotency-Replayed

string

Allowed values: true

201

A newly created resource.

application/json

object

data

required

object

attributes

required

object

additionalContactIds

required

Array<string>

archived

required

boolean

color

required

string | null

completed

required

boolean

contactId

required

string | null

createdAt

required

string | null format: date-time

description

required

string

dueAt

required

string | null format: date-time

individualId

required

string | null

listId

required

string | null

managerId

required

string | null

name

required

string

plannedEndAt

required

string | null format: date-time

plannedStartAt

required

string | null format: date-time

showInScheduling

required

boolean

subscriberIds

required

Array<string>

updatedAt

required

string | null format: date-time

required

string

type

required

Allowed value: project

meta

required

object

requestId

required

string

Example

{
  "data": {
    "type": "project"
  }
}

Headers

Idempotency-Replayed

string

Allowed values: false

400

The request is invalid.

application/json

object

errors

required

Array<object>

object

code

required

string

detail

required

string

source

object

key

additional properties

string

status

required

string

/^[1-5][0-9]{2}$/

title

required

string

meta

required

object

requestId

required

string

Example^generated

{
  "errors": [
    {
      "code": "example",
      "detail": "example",
      "source": {
        "additionalProperty": "example"
      },
      "status": "example",
      "title": "example"
    }
  ],
  "meta": {
    "requestId": "example"
  }
}

401

The bearer credential is missing, invalid, expired, or revoked.

application/json

object

errors

required

Array<object>

object

code

required

string

detail

required

string

source

object

key

additional properties

string

status

required

string

/^[1-5][0-9]{2}$/

title

required

string

meta

required

object

requestId

required

string

Example^generated

{
  "errors": [
    {
      "code": "example",
      "detail": "example",
      "source": {
        "additionalProperty": "example"
      },
      "status": "example",
      "title": "example"
    }
  ],
  "meta": {
    "requestId": "example"
  }
}

403

The credential has insufficient scope.

application/json

object

errors

required

Array<object>

object

code

required

string

detail

required

string

source

object

key

additional properties

string

status

required

string

/^[1-5][0-9]{2}$/

title

required

string

meta

required

object

requestId

required

string

Example^generated

{
  "errors": [
    {
      "code": "example",
      "detail": "example",
      "source": {
        "additionalProperty": "example"
      },
      "status": "example",
      "title": "example"
    }
  ],
  "meta": {
    "requestId": "example"
  }
}

409

The request conflicts with the current resource state.

application/json

object

errors

required

Array<object>

object

code

required

string

detail

required

string

source

object

key

additional properties

string

status

required

string

/^[1-5][0-9]{2}$/

title

required

string

meta

required

object

requestId

required

string

Example^generated

{
  "errors": [
    {
      "code": "example",
      "detail": "example",
      "source": {
        "additionalProperty": "example"
      },
      "status": "example",
      "title": "example"
    }
  ],
  "meta": {
    "requestId": "example"
  }
}

429

The credential or source exceeded its rate limit.

application/json

object

errors

required

Array<object>

object

code

required

string

detail

required

string

source

object

key

additional properties

string

status

required

string

/^[1-5][0-9]{2}$/

title

required

string

meta

required

object

requestId

required

string

Example^generated

{
  "errors": [
    {
      "code": "example",
      "detail": "example",
      "source": {
        "additionalProperty": "example"
      },
      "status": "example",
      "title": "example"
    }
  ],
  "meta": {
    "requestId": "example"
  }
}

Headers

Retry-After

integer

>= 1

Minimum delay in seconds before retrying.

X-RateLimit-Limit

integer

Maximum requests in the current window.

X-RateLimit-Remaining

integer

Requests remaining in the current window.

X-RateLimit-Reset

integer

Unix time in milliseconds when the current window resets.

X-Request-Id

string

Request correlation identifier.

502

The cell-local application returned an invalid response.

application/json

object

errors

required

Array<object>

object

code

required

string

detail

required

string

source

object

key

additional properties

string

status

required

string

/^[1-5][0-9]{2}$/

title

required

string

meta

required

object

requestId

required

string

Example^generated

{
  "errors": [
    {
      "code": "example",
      "detail": "example",
      "source": {
        "additionalProperty": "example"
      },
      "status": "example",
      "title": "example"
    }
  ],
  "meta": {
    "requestId": "example"
  }
}

503

A required cell-local dependency is unavailable.

application/json

object

errors

required

Array<object>

object

code

required

string

detail

required

string

source

object

key

additional properties

string

status

required

string

/^[1-5][0-9]{2}$/

title

required

string

meta

required

object

requestId

required

string

Example^generated

{
  "errors": [
    {
      "code": "example",
      "detail": "example",
      "source": {
        "additionalProperty": "example"
      },
      "status": "example",
      "title": "example"
    }
  ],
  "meta": {
    "requestId": "example"
  }
}

Create a project

Authorizations

Parameters

Header Parameters

Request Bodyrequired

Examplegenerated

Responses

200

Example

Headers

201

Example

Headers

400

Examplegenerated

401

Examplegenerated

403

Examplegenerated

409

Examplegenerated

429

Examplegenerated

Headers

502

Examplegenerated

503

Examplegenerated

Request Body^required

Example^generated

Example^generated

Example^generated

Example^generated

Example^generated

Example^generated

Example^generated

Example^generated