Sites (projects)

In the API, a site is called a project: the path is /manage/projects, and a site ID is projectId.

Authentication

Requires a root client. See the Authentication guide.

Base URL

plaintext

https://api.pieowl.com/manage/projects

Endpoints

Method	Path	What it does
`GET`	`/manage/projects`	Lists all sites in your team
`GET`	`/manage/projects/{id}`	Gets one site
`POST`	`/manage/projects`	Creates a site
`PATCH`	`/manage/projects/{id}`	Updates a site
`DELETE`	`/manage/projects/{id}`	Schedules the site for deletion in 24 hours

Create a site

bash

curl -X POST 'https://api.pieowl.com/manage/projects' \
  -H 'Content-Type: application/json' \
  -H 'pieowl-client-id: YOUR_ROOT_CLIENT_ID' \
  -H 'pieowl-client-secret: YOUR_ROOT_CLIENT_SECRET' \
  -d '{
    "name": "My website",
    "domain": "https://example.com",
    "cors": ["https://example.com"],
    "types": ["website"]
  }'

When you create a site, Pieowl also creates a default write client and returns it in the response. The client secret is only shown once, so save it right away.

For full request and response schemas, see the API Reference.