Projects

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

View as Markdown Open in Claude Open in ChatGPT

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

{
  "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	Description
`name`required	body	string
`timezone`	body	string	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	Description
`id`required	path	string	Opaque id from a previous response.
`name`required	body	string