Workspaces

List the workspaces your API key can act on. Use a workspace ID as the X-Workspace-Id header on every other endpoint when using an all-scope key.

List Workspaces

Returns the workspaces owned by the key's account. An all-scope key returns every workspace you own; a workspace-scoped key returns only its single bound workspace. This is the discovery endpoint that lets an all-scope key learn the workspace IDs the other endpoints require, so it takes no X-Workspace-Id header itself.

GET/v1/workspacesList the workspaces your key can act on

Headers

Parameter	Type	Required	Description
`Authorization`	string	Required	Your API key. qgl_... (bare or Bearer-prefixed). No workspace header is needed on this endpoint.

Example Request

List your workspaces

curl https://api.quegly.com/v1/workspaces \
  -H "Authorization: qgl_your_api_key"

Response

200 OK

{
  "workspaces": [
    {
      "id": "b3f1c2d4-5e6a-7b8c-9d0e-1f2a3b4c5d6e",
      "name": "Faith Hero",
      "slug": "faith-hero",
      "description": "Faith Hero app marketing",
      "is_archived": false,
      "created_at": "2026-06-01T12:00:00Z"
    },
    {
      "id": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d",
      "name": "Personal",
      "slug": "personal",
      "description": null,
      "is_archived": false,
      "created_at": "2026-05-15T09:30:00Z"
    }
  ]
}

Response Fields

Parameter	Type	Required	Description
`id`	string	Required	Workspace UUID. Pass this as X-Workspace-Id on other endpoints.
`name`	string	Required	Display name
`slug`	string	Required	URL slug used in the dashboard (quegly.com/<slug>/...)
`description`	string \| null	Optional	Optional description
`is_archived`	boolean	Required	When true, the workspace is read-only and rejects posting. Still listed so its ID never silently disappears.
`created_at`	string	Required	ISO 8601 creation timestamp. Results are ordered newest first.

Creating workspaces

Workspaces are created in the Quegly dashboard, and every plan includes as many as you need. The API does not create or delete workspaces.

Every connected account lives in one workspace. Its owner can move it to another of their workspaces on the dashboard (not while it has scheduled posts or drafts in the one it is in): it keeps its ID, and from then on GET /v1/accounts lists it in its new workspace. Its posts stay in the workspace they were made in, but their analytics move with it, older posts included: a workspace's analytics cover the accounts in it now.