POST /projects

POST /projects

Create a new project.

Creates a new project scoped to the authenticated team. Use a team API key as the Bearer token (not a project API key). The response includes the new project's api_key, which you use to authenticate all subsequent project-scoped API calls (e.g. POST /organizations).

Code Examples

API Key:
Language:

API Explorer

POST https://api.ditchcarbon.com/projects

Authentication

No parameters for this endpoint
Send a request to see the response

Request Body

Content type: application/json

Responses

201 Project created successfully

Content type: application/json

Response Fields

Field Type Description
id integer Unique identifier for the project
name string Name of the project
api_key string API key for this project. Use this as the Bearer token for all project-scoped endpoints.

Example Response

{
  "id": 42,
  "name": "My Supplier Portfolio",
  "api_key": "dc_production_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2"
}

401 Missing or invalid team API key

422 Validation failed (e.g. missing name, free plan project limit reached)

POST /projects