API reference / Apps / List apps

List apps

GET/apps

An operator sees every app. An app key sees only itself. A signed-in person is refused: they list the apps of their workspaces with GET /me/apps, which is paged.

Responses

200 object OK

401 Error Missing, malformed or unknown bearer token.

403 Error The token is valid but not permitted on this route.

503 Error A dependency this route needs is unreachable.

cURL

curl "https://api.foliot.app/apps" \
  -H "Authorization: Bearer $FOLIOT_TOKEN"

RESPONSE 200 OK

{
  "apps": [
    {
      "createdAt": "2026-10-01T09:30:00Z",
      "description": null,
      "handlerBaseUrl": "string",
      "id": "string",
      "name": "string",
      "updatedAt": "2026-10-01T09:30:00Z"
    }
  ]
}