guliel_docs

Settings

Caller's own preferences and platform utilities (e.g. exchange-rate refresh).

3 endpoints·Scopes: settings:read, settings:write
POST/api/exchange-rates/refresh#

Attach refresh to an exchange rate

scope · settings:write

Creates a new refresh attached to the given exchange rate.

Scope: settings:write
Endpoint: POST /api/exchange-rates/refresh

Example request

curl -X POST "https://guliel.com/api/exchange-rates/refresh" \
  -H "Authorization: Bearer $GULIEL_API_KEY"

Request body

    Response (200/201)

    • messagereq
      string
    • datereq
      stringISO date of the FX snapshot that's now active.
    • ratesCountreq
      integerHow many currency pairs were refreshed.

    Error responses

    400Validation
    401Unauthenticated
    403Forbidden
    429RateLimit
    500Internal
    GET/api/settings#

    List settingses

    scope · settings:read

    Lists settingses the caller can see. Results are filtered by the caller's accessible organizations; many routes paginate via page and limit.

    Scope: settings:read
    Endpoint: GET /api/settings

    Example request

    curl "https://guliel.com/api/settings" \
  -H "Authorization: Bearer $GULIEL_API_KEY"

    Response (200/201)

    • idreq
      string
    • userIdreq
      string
    • themereq
      stringlight | dark | system
    • languagereq
      string
    • defaultOrganizationIdreq
      string | null
    • preferencesreq
      object
    • createdAtreq
      string
    • updatedAtreq
      string

    Error responses

    400Validation
    401Unauthenticated
    403Forbidden
    500Internal
    PUT/api/settings#

    Update a settings

    scope · settings:write

    Replaces an existing settings. All required fields must be supplied — omitted fields revert to their schema defaults.

    Scope: settings:write
    Endpoint: PUT /api/settings

    Example request

    curl -X PUT "https://guliel.com/api/settings" \
  -H "Authorization: Bearer $GULIEL_API_KEY"

    Request body

    • theme
      enum<3>
      light · dark · system
    • language
      string
    • defaultOrganizationId
      string | null
    • preferences
      object

    Response (200/201)

    • idreq
      string
    • userIdreq
      string
    • themereq
      stringlight | dark | system
    • languagereq
      string
    • defaultOrganizationIdreq
      string | null
    • preferencesreq
      object
    • createdAtreq
      string
    • updatedAtreq
      string

    Error responses

    400Validation
    401Unauthenticated
    403Forbidden
    429RateLimit
    500Internal