# Projects

3 endpoints for projects, with parameters and a real response example.

## GET /projects

**List projects**

Lists the account's projects, with each one's Instagram handle, how many projects the plan allows, and whether another one still fits.

Response:

```json
{
  "projects": [
    {
      "id": "c85848ba-2881-4a2e-9bdd-841b26d07359",
      "name": "Projeto de teste",
      "instagram": null,
      "createdAt": "2026-07-31T14:29:14.237659+00:00"
    }
  ],
  "limit": 1,
  "canCreateMore": false
}
```

## POST /projects

**Create a project**

Creates a new project. A project is an Instagram account with its own brand. Born without brand DNA and without Instagram connected; rejected when the plan's project limit is already reached.

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `name` | body | string | yes |  |
| `timezone` | body | string | no | IANA, e.g. America/Sao_Paulo. Without it, born in Sao Paulo. |

## PATCH /projects/{id}

**Rename a project**

Changes a project's display name in the app. Does not touch the profile name inside the brand DNA, which signs the posts' artwork.

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string | yes | Opaque id from a previous response. |
| `name` | body | string | yes |  |