# craaft Projects API

**Canonical:** https://apis.io/apis/craaft-io/craaft-io-projects-api/  
**Provider:** craaft — https://apis.io/providers/craaft-io/  
**Base URL:** https://craaft.io/api/v1  
**Documentation:** https://craaft.io/docs

craaft Projects API is one of 17 APIs that [craaft](https://apis.io/providers/craaft-io/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 4 JSON Schema definitions. Tagged areas include Project. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 4 JSON Schemas.

The Projects API from craaft — 25 operation(s) for projects.

## Operations (41)

| Method | Path | Summary |
|---|---|---|
| GET | `/projects` | List projects |
| POST | `/projects` | Create a project |
| GET | `/projects/{id}` | Get a project (with columns + counts) |
| PATCH | `/projects/{id}` | Update a project (partial) |
| DELETE | `/projects/{id}` | Delete a project |
| GET | `/projects/{id}/export` | Export a project as JSON or CSV |
| GET | `/projects/{id}/cards` | List cards in a project |
| POST | `/projects/{id}/cards` | Create a card |
| GET | `/projects/{id}/files` | List and search the files on a board |
| GET | `/projects/{id}/activity` | Board activity feed |
| GET | `/projects/{id}/cards/archived` | List a board's archived cards |
| POST | `/projects/{id}/cards/bulk` | Create up to 100 cards in one transaction |
| POST | `/projects/{id}/cards/rebalance` | Rewrite a column's card order in one transaction |
| POST | `/projects/{id}/background-image` | Upload a board background image |
| GET | `/projects/{id}/background-image` | Download the board background image |
| DELETE | `/projects/{id}/background-image` | Remove the board background image |
| GET | `/projects/{id}/tags` | Distinct tags used on a project's cards |
| POST | `/projects/{id}/share` | Enable public sharing (mint a read-only share token) |
| DELETE | `/projects/{id}/share` | Revoke public sharing |
| GET | `/projects/{id}/milestones` | List a project's milestones |
| POST | `/projects/{id}/milestones` | Add a milestone |
| GET | `/projects/{id}/webhooks` | List webhooks for a board |
| POST | `/projects/{id}/webhooks` | Create a webhook subscription |
| GET | `/projects/{id}/github` | The board's GitHub connection |
| PUT | `/projects/{id}/github` | Connect the board to a repository (workspace owners and admins) |
| DELETE | `/projects/{id}/github` | Disconnect the board (workspace owners and admins) |
| GET | `/projects/{id}/github/repos` | Repositories the workspace's GitHub installations can reach (workspace owners… |
| GET | `/projects/{id}/github/pulls` | Pull requests linked to the board's live cards |
| POST | `/projects/{id}/github/install` | Link to install the craaft GitHub App |
| GET | `/projects/{id}/inbound-email` | Get inbound email address for a board |
| POST | `/projects/{id}/inbound-email` | Enable inbound email for a board |
| PATCH | `/projects/{id}/inbound-email` | Update inbound email configuration |
| DELETE | `/projects/{id}/inbound-email` | Disable inbound email for a board |
| POST | `/projects/{id}/inbound-email/senders` | Allow a sender to email the board |
| DELETE | `/projects/{id}/inbound-email/senders/{senderId}` | Remove an allowed sender |
| GET | `/projects/{id}/events` | Server-Sent Events stream for a board (realtime) |
| POST | `/projects/{id}/columns` | Add a column to a project |
| GET | `/projects/{id}/members` | List everyone who can see the board |
| POST | `/projects/{id}/members` | Add a workspace member to the board |
| PATCH | `/projects/{id}/members/{userId}` | Change an explicit board grant's role |
| DELETE | `/projects/{id}/members/{userId}` | Remove an explicit board grant |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/craaft-io/openapi/craaft-io-projects-api-openapi.yml
- **OpenAPI** — https://craaft.io/openapi.yaml
- **Documentation** — https://craaft.io/docs
- **JSONSchema** — https://artifacts.apis.io/craaft-io/json-schema/craaft-io-project-schema.json
- **JSONSchema** — https://artifacts.apis.io/craaft-io/json-schema/craaft-io-project-export-schema.json
- **JSONSchema** — https://artifacts.apis.io/craaft-io/json-schema/craaft-io-board-activity-schema.json
- **JSONSchema** — https://artifacts.apis.io/craaft-io/json-schema/craaft-io-card-schema.json

## Other craaft APIs (12)

- [craaft Attachments API](https://apis.io/apis/craaft-io/craaft-io-attachments-api/)
- [craaft Board Templates API](https://apis.io/apis/craaft-io/craaft-io-board-templates-api/)
- [craaft Cards API](https://apis.io/apis/craaft-io/craaft-io-cards-api/)
- [craaft Checklist API](https://apis.io/apis/craaft-io/craaft-io-checklist-api/)
- [craaft Columns API](https://apis.io/apis/craaft-io/craaft-io-columns-api/)
- [craaft Comments API](https://apis.io/apis/craaft-io/craaft-io-comments-api/)
- [craaft Imports API](https://apis.io/apis/craaft-io/craaft-io-imports-api/)
- [craaft Invitations API](https://apis.io/apis/craaft-io/craaft-io-invitations-api/)
- [craaft Me API](https://apis.io/apis/craaft-io/craaft-io-me-api/)
- [craaft Members API](https://apis.io/apis/craaft-io/craaft-io-members-api/)
- [craaft Milestones API](https://apis.io/apis/craaft-io/craaft-io-milestones-api/)
- [craaft Public API](https://apis.io/apis/craaft-io/craaft-io-public-api/)

## Tags

Project

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/craaft-io/craaft-io-projects-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/craaft-io/.