Project Groups

Changed on
post/project-groups

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/project-groups
  • Auth: HTTP bearer

Request body

descriptionstring nullable
namestring required
project_idsinteger[]

Projects to place in the group right away, in display order. A project that is already in another group is moved.

slugstring nullable

URL-safe identifier. Derived from name when omitted.

Example request

{
  "name": "Acme Shop",
  "slug": "acme-shop"
}

Response

Project group created

created_atstring date-time required
descriptionstring nullable
idinteger required
namestring required
slugstring required
updated_atstring date-time required

Example response

{
  "created_at": "2026-09-28T12:15:47.609192Z",
  "projects": [
    {
      "directory": "apps/web",
      "last_deployment": "2026-09-28T12:15:47.609192Z",
      "main_branch": "main"
    }
  ],
  "repository": {
    "main_branch": "main",
    "public_provider": "github",
    "repo_name": "shop",
    "repo_owner": "acme"
  },
  "updated_at": "2026-09-28T12:15:47.609192Z"
}

Changes