App

Generated from Huudis's own code: every route in this area, what it takes and how to call it.

Method Path What it does
GET /api/v1/app/overview One row per OIDC client that has ever minted a refresh token: distinct users, 30-day signups, last signup + last activity.
GET /api/v1/app/stats List stats
GET /api/v1/app/users List users
GET /api/v1/app/workspaces List workspaces

One row per OIDC client that has ever minted a refresh token: distinct users, 30-day signups, last signup + last activity.

GET /api/v1/app/overview

One row per OIDC client that has ever minted a refresh token: distinct users, 30-day signups, last signup + last activity. Plus a recent- signups feed (latest 20 first-logins across every client) so the Forjio admin portal can show "who just signed up, where" at a glance.

Authentication: Your app's OIDC client credentials, not a person's token: HTTP Basic client_id:client_secret (or X-Client-Id + X-Client-Secret). The app reads its own users only. See client credentials.

Example

curl -X GET "https://huudis.com/api/v1/app/overview" \
  -H "Authorization: Basic <base64 of client_id:client_secret>"

List stats

GET /api/v1/app/stats

Authentication: Your app's OIDC client credentials, not a person's token: HTTP Basic client_id:client_secret (or X-Client-Id + X-Client-Secret). The app reads its own users only. See client credentials.

Query parameters

Name Type Required Notes
q string no max length 200
status all or active or disabled no
limit integer no min 1; max 500
clientId string no max length 100

Example

curl -X GET "https://huudis.com/api/v1/app/stats" \
  -H "Authorization: Basic <base64 of client_id:client_secret>"

List users

GET /api/v1/app/users

Authentication: Your app's OIDC client credentials, not a person's token: HTTP Basic client_id:client_secret (or X-Client-Id + X-Client-Secret). The app reads its own users only. See client credentials.

Query parameters

Name Type Required Notes
q string no max length 200
status all or active or disabled no
limit integer no min 1; max 500
clientId string no max length 100

Example

curl -X GET "https://huudis.com/api/v1/app/users" \
  -H "Authorization: Basic <base64 of client_id:client_secret>"

List workspaces

GET /api/v1/app/workspaces

Authentication: Your app's OIDC client credentials, not a person's token: HTTP Basic client_id:client_secret (or X-Client-Id + X-Client-Secret). The app reads its own users only. See client credentials.

Query parameters

Name Type Required Notes
ids string yes max length 5000

Example

curl -X GET "https://huudis.com/api/v1/app/workspaces" \
  -H "Authorization: Basic <base64 of client_id:client_secret>"
Huudis Docs · App — reference | Huudis