Manage projects

List your projects

List all the projects in your account.

👍 Required scope : project.list

curl --location --request GET 'https://api.flagship.io/v1/accounts/{ACCOUNT_ID}/projects' \
--header 'Authorization: Bearer {ACCESS_TOKEN}'

Swagger documentation here.

Create a project

👍 Required scope : project.create

curl --location --request POST 'https://api.flagship.io/v1/accounts/{ACCOUNT_ID}/projects' \
--header 'Authorization: Bearer {ACCESS_TOKEN}'
--data-raw '{
    "name": "New project"
}'

Swagger documentation here.

View a project

👍 Required scope : project.read

curl --location --request GET 'https://api.flagship.io/v1/accounts/{ACCOUNT_ID}/projects/{PROJECT_ID}' \
--header 'Authorization: Bearer {ACCESS_TOKEN}'

Swagger documentation here.

Update a project

👍 Required scope : project.update

curl --location --request PUT 'https://api.flagship.io/v1/accounts/{ACCOUNT_ID}/projects/{PROJECT_ID}' \
--header 'Authorization: Bearer {ACCESS_TOKEN}'
--data-raw '{
    "name": "New project name"
}'

Swagger documentation here.

Toggle a project

Toggle all the campaigns of the project to a new state

👍 Required scope : project.toggle

curl --location --request PATCH 'https://api.flagship.io/v1/accounts/{ACCOUNT_ID}/projects/{PROJECT_ID}/toggle' \
--header 'Authorization: Bearer {ACCESS_TOKEN}'
--data-raw '{
    "state": "active"
}'

📘 The different states are active , paused , interrupted .

Swagger documentation here.

Delete a project

👍 Required scope : project.delete

❗️ Be careful, there is no confirmation step when you call this route. It will delete the project definitively.

curl --location --request DELETE 'https://api.flagship.io/v1/accounts/{ACCOUNT_ID}/projects/{PROJECT_ID}' \
--header 'Authorization: Bearer {ACCESS_TOKEN}'
--data-raw ''

Swagger documentation here.