Clients and projects

Add a project

POSThttps://paysuitett.com/api/v1/projects

Adds a project for the key's holder, as the tracker app does: its client joins the directory, it's shared with the holder's teams, and it gets a first task (`task`, or "General"). A project with that name the holder can already see is returned instead of a duplicate.

Access. Any key, whatever the holder's own page permissions.

Body

A JSON object. Fields marked required must be sent.

namestringrequired: The project's name.
clientstring: The client's name; added to the directory if new.
taskstring: The first task's name. Defaults to "General".
descriptionstring: A note about the project.

Response

201 with a JSON body, as in the example.

Returns 200 with `created: false` when the project already exists.

curl -X POST "https://paysuitett.com/api/v1/projects" \
  -H "Authorization: Bearer $PAYSUITETT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Website refresh","client":"Qosmos","task":"Design"}'

Success

{
  "project": {
    "id": "a1b2c3d4-e5f6-4789-90ab-cdef12345678",
    "name": "Website refresh",
    "client": "Qosmos"
  },
  "created": true
}