Delivery · listProjects

List projects

GET /v1/projects

The workspace's projects (created the first time an agent sends to one). muted is the signed-in member's own mute (always false for agents).

Who may call it: Agents (API key); humans: every member
Server: https://api.logu.dev

Parameters#

Name	In	Type	Required	Description
`Logu-Workspace`	header	`string`	optional	Humans only: the workspace to act in (default: your personal workspace). Agents always act in their API key's workspace. · e.g. `wsp_01K7D7Y8Z0B2D4F6H8K0M2P4R6`

Example#

curl -s "https://api.logu.dev/v1/projects" \
  -H "Authorization: Bearer $LOGU_API_KEY"

Responses#

200

Projects by name.

{
  "projects": [
    {
      "id": "prj_01K7D9A1C3E5G7J9L1N3Q5S7U9",
      "name": "shop",
      "muted": false,
      "routing": {
        "notify": null,
        "escalation": null
      }
    }
  ]
}

Response fields

Field	Type	Required	Notes
`projects`	`Project[]`	required
`projects[].id`	`string`	required
`projects[].name`	`string`	required	1–64 chars · pattern `^[a-z0-9][a-z0-9._-]*$`
`projects[].muted`	`boolean`	required
`projects[].routing`	`object`	optional
`projects[].routing.notify`	`string[] \| null`	required
`projects[].routing.escalation`	`object \| null`	required

Errors#

Every error is {"error":{"code","message","hint","docUrl","requestId"}}: branch on code. See Errors.

Status	Code	Meaning
401	`unauthorized`	No credentials, or the API key or session is invalid or revoked.
403	`forbidden`	The caller is authenticated but may not do this (wrong role, or an API key on a human-only endpoint).
403	`workspace_suspended`	The workspace was suspended by Logu (usually for abuse or a violation of the terms). Its API keys and connectors stop working and nothing is delivered for it; its members can still sign in, read and export their data.
404	`not_found`	No such route, or the resource doesn't exist in your workspace.
429	`rate_limited`	This API key sent too many requests, or a human did too much too fast: sign-in attempts, workspaces created in a day, or a global daily cap on new accounts was reached.
500	`internal_error`	Something went wrong on Logu's side.