Help
Endpoints for in-app help and feedback. Both endpoints use multi-tenant mode (do NOT send X-Farfalla-Tenant-Id).
List Help Subjects
GET /api/v2/help
Returns the available help/contact subjects for the current app context.
Request:
curl https://app.publica.la/api/v2/help \
-H "Authorization: Bearer {access_token}" \
-H "Accept: application/json" \
-H "X-Fenice-Lang: es"
The response language is determined by the X-Fenice-Lang header (set globally by middleware). It is not a query parameter.
Response: 200 OK
{
"missing-issues": "Missing publications",
"missing-store": "Missing stores",
"cancel-subscription": "Cancel subscription",
"offline-not-working": "Offline content not working",
"delete-account-and-data": "Delete account and data",
"other": "Other"
}
The available subjects vary by tenant. For example, missing-store only appears for the Publica.la generic app, and some subjects are hidden for specific tenants.
Submit Help Request
POST /api/v2/help
Submits a help or feedback request. The request is routed to support email, engineering, or Slack depending on the subject.
Request:
curl -X POST https://app.publica.la/api/v2/help \
-H "Authorization: Bearer {access_token}" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "X-Fenice-App-Version: 2.5.0" \
-H "X-FeniceBase-Version: 1.30.0" \
-d '{
"subject": "missing-issues",
"message": "I purchased a subscription but some issues are not appearing in my library."
}'
| Parameter | Type | Required | Description |
|---|---|---|---|
subject | string | Yes | One of the keys from the list endpoint |
message | string | Yes | User message (min 10 characters) |
Optional Body Fields:
| Field | Type | Description |
|---|---|---|
volpe_version | string | Reader engine version |
device | string | Device model |
so | string | Operating system |
Response: 201 Created with empty body.
The delete-account-and-data subject triggers permanent account deletion (if the user is not an admin). This is irreversible.
See Also
- API v2 Overview - General API information
- Authentication - Login and session management