API reference / Apps / Fetch one app

Fetch one app

GET/apps/{appId}

Authenticate with an operator token or an app API key or a signed-in Foliot Console session.

No signing secret here, for anyone. The only way a secret leaves this server is the reveal endpoint, which records it.

Path parameters

appId

string

REQUIRED

The app's name.

Responses

200 object OK

401 Error Missing, malformed or unknown bearer token.

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

404 Error No such resource.

503 Error A dependency this route needs is unreachable.

cURL

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

RESPONSE 200 OK

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