Skip to Content
APIProjects

Projects API

Organize workflows into projects for better management.

List Projects

GET /api/projects

Returns all projects for the current organization, including workflow counts.

Response

[
  {
    "id": "proj_123",
    "name": "DeFi Monitoring",
    "description": "All DeFi-related workflows",
    "color": "#4A90D9",
    "organizationId": "org_456",
    "workflowCount": 5,
    "createdAt": "2024-01-01T00:00:00Z",
    "updatedAt": "2024-01-01T00:00:00Z"
  }
]

Create Project

POST /api/projects

Request Body

{
  "name": "My Project",
  "description": "Optional description",
  "color": "#7B61FF"
}

The color field is optional. If omitted, a color is automatically assigned from a default palette.

Response

Returns the created project with status: 201.

Update Project

PATCH /api/projects/{projectId}

Request Body

All fields are optional. Only provided fields are updated.

{
  "name": "Updated Name",
  "description": "Updated description",
  "color": "#E06C75"
}

Delete Project

DELETE /api/projects/{projectId}

Deletes the project. Workflows assigned to this project are not deleted but become unassigned.

IntegrationsTags