Overview

The Projects API allows you to create, update, and manage projects programmatically. All endpoints require authentication via API key.

Base URL: https://cencori.com/api/v1

List Projects

Get all projects in your organization.

Request

Codetext

GET /organizations/{orgSlug}/projects
Headers: { "Authorization": "Bearer YOUR_API_KEY" }

Response

Codetext

{
  "projects": [
    {
      "id": "proj_123",
      "name": "Production API",
      "slug": "production-api",
      "status": "active",
      "created_at": "2024-01-01T00:00:00Z"
    }
  ]
}

Create Project

Create a new project in your organization.

Request

Codetext

POST /organizations/{orgSlug}/projects
Headers: { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }
Body: { "name": "My New Project", "visibility": "public" }

Parameters

Field	Type	Required	Description
`name`	string	Yes	Project name
`description`	string	No	Project description
`visibility`	string	No	`public` or `private`

Get Project

Retrieve details for a specific project.

Request

Codetext

GET /organizations/{orgSlug}/projects/{projectSlug}

Update Project

Update an existing project.

Request

Codetext

PATCH /organizations/{orgSlug}/projects/{projectSlug}
Body: { "name": "Updated Name" }

Delete Project

Permanently delete a project and all associated data.

Request

Codetext

DELETE /organizations/{orgSlug}/projects/{projectSlug}

[!WARNING] This action is irreversible. All API keys, logs, and analytics for this project will be permanently deleted.

Error Responses

400: Missing or invalid parameters
401: Invalid API key
403: No permission to access project
404: Project doesn't exist
409: Project with same name exists