Query parameters

• organization_id string Required

  Logto organization id of the tenant to inspect.

Responses

• 200 application/json

  Effective configuration report

  Hide response attributes Show response attributes object

  • code integer
  • message string
  • data object
    Hide data attributes Show data attributes object

    • organization_id string
    • chain array[object]

      Contributing layers ordered Owner first → tenant last. Orgs with no saved layer are listed with has_layer: false and an empty layer.

      Hide chain attributes Show chain attributes object

      • organization_id string
      • organization_name string
      • organization_role string

        Values are owner, distributor, reseller, or customer.

      • has_layer boolean
      • layer object

        The caller's alerting configuration. This is what POST /alerts/config accepts and what GET /alerts/config returns; the merged effective config that backs Mimir is computed server-side and never exposed.

        Each recipient carries its own severities[] (empty = all severities); email recipients additionally carry per-recipient language and format. Channel toggles under enabled are tri-state: null = no opinion at this layer (inherit), true = enabled, false = disabled (Owner only — non-Owner false is normalised to null on save).

        Body size: the request body is capped at 1 MiB on POST. Oversized requests are rejected with HTTP 413 before binding.

        Hide layer attributes Show layer attributes object

        • enabled object

          Per-layer enable/disable for each notification channel. Each value is tri-state:

          • true — explicitly enabled at this layer
          • false — explicitly disabled (Owner only; non-Owner false is normalised to null on save)
          • null — no opinion at this layer; effective state inherits from the merge of any ancestor layer that took a position. If no layer in the chain enables a channel, the channel stays off.
          Hide enabled attributes Show enabled attributes object

          • email boolean | null
          • webhook boolean | null
          • telegram boolean | null
        • email_recipients array[object]

          Not more than 50 elements.

          Hide email_recipients attributes Show email_recipients attributes object

          • address string(email) Required

            Maximum length is 320.

          • severities array[string]

            Severity scope for this recipient. Empty (or omitted) means "all severities" — the recipient lands on every per-severity receiver. A non-empty subset narrows delivery to those severities.

            Not more than 3 elements. Values are critical, warning, or info.

          • language string

            Rendering language for this recipient's email body and subject. Defaults to en when omitted.

            Values are en or it.

          • format string

            Body format preference. html (default) emits multipart with an html primary body and text alternative; plain emits only a text body.

            Values are html or plain.

          • scope object

            Narrows a recipient to the alerts of some organizations and/or some systems; an alert matches when it falls in any list. Omitted or all lists empty means every system the layer reaches. Every id must belong to the caller's hierarchy, otherwise the save fails with out_of_scope on <channel>_recipients.<i>.scope.

            Hide scope attributes Show scope attributes object

            • managed_organization_ids array[string]

              "Managed by": the systems of each organization and of its whole sub-tree (a distributor's resellers and customers, a reseller's customers).

              Not more than 100 elements. Format of each should match the following pattern: ^[A-Za-z0-9_-]{1,255}$.

            • assigned_organization_ids array[string]

              Only the systems assigned to each organization itself, not those of the organizations it manages.

              Not more than 100 elements. Format of each should match the following pattern: ^[A-Za-z0-9_-]{1,255}$.

            • system_ids array[string]

              Not more than 500 elements. Format of each should match the following pattern: ^[A-Za-z0-9_-]{1,255}$.

        • webhook_recipients array[object]

          Not more than 20 elements.

          Hide webhook_recipients attributes Show webhook_recipients attributes object

          • name string Required

            Descriptive label for the webhook target (UI only).

            Maximum length is 100.

          • url string(uri) Required

            Webhook URL. Validation rejects non-public destinations (loopback, RFC1918, RFC6598 CGNAT, link-local, multicast, cloud metadata) and requires a canonical hostname (containing at least one letter) or a valid IP literal. Only http/https schemes are accepted; URLs cannot embed userinfo.

            Maximum length is 2048.

          • severities array[string]

            Not more than 3 elements. Values are critical, warning, or info.

          • scope object

            Narrows a recipient to the alerts of some organizations and/or some systems; an alert matches when it falls in any list. Omitted or all lists empty means every system the layer reaches. Every id must belong to the caller's hierarchy, otherwise the save fails with out_of_scope on <channel>_recipients.<i>.scope.

            Hide scope attributes Show scope attributes object

            • managed_organization_ids array[string]

              "Managed by": the systems of each organization and of its whole sub-tree (a distributor's resellers and customers, a reseller's customers).

              Not more than 100 elements. Format of each should match the following pattern: ^[A-Za-z0-9_-]{1,255}$.

            • assigned_organization_ids array[string]

              Only the systems assigned to each organization itself, not those of the organizations it manages.

              Not more than 100 elements. Format of each should match the following pattern: ^[A-Za-z0-9_-]{1,255}$.

            • system_ids array[string]

              Not more than 500 elements. Format of each should match the following pattern: ^[A-Za-z0-9_-]{1,255}$.

        • telegram_recipients array[object]

          Not more than 20 elements.

          Hide telegram_recipients attributes Show telegram_recipients attributes object

          • bot_token string Required

            Maximum length is 256.

          • chat_id integer(int64) Required
          • message_thread_id integer(int64)

            Topic of a forum-enabled supergroup to post into. Omit to post in the General topic (or in the plain chat when topics are off).

            Minimum value is 1.

          • severities array[string]

            Not more than 3 elements. Values are critical, warning, or info.

          • scope object

            Narrows a recipient to the alerts of some organizations and/or some systems; an alert matches when it falls in any list. Omitted or all lists empty means every system the layer reaches. Every id must belong to the caller's hierarchy, otherwise the save fails with out_of_scope on <channel>_recipients.<i>.scope.

            Hide scope attributes Show scope attributes object

            • managed_organization_ids array[string]

              "Managed by": the systems of each organization and of its whole sub-tree (a distributor's resellers and customers, a reseller's customers).

              Not more than 100 elements. Format of each should match the following pattern: ^[A-Za-z0-9_-]{1,255}$.

            • assigned_organization_ids array[string]

              Only the systems assigned to each organization itself, not those of the organizations it manages.

              Not more than 100 elements. Format of each should match the following pattern: ^[A-Za-z0-9_-]{1,255}$.

            • system_ids array[string]

              Not more than 500 elements. Format of each should match the following pattern: ^[A-Za-z0-9_-]{1,255}$.

      • updated_by_name string | null
      • updated_at string(date-time) | null
    • effective object

      The caller's alerting configuration. This is what POST /alerts/config accepts and what GET /alerts/config returns; the merged effective config that backs Mimir is computed server-side and never exposed.

      Each recipient carries its own severities[] (empty = all severities); email recipients additionally carry per-recipient language and format. Channel toggles under enabled are tri-state: null = no opinion at this layer (inherit), true = enabled, false = disabled (Owner only — non-Owner false is normalised to null on save).

      Body size: the request body is capped at 1 MiB on POST. Oversized requests are rejected with HTTP 413 before binding.

      Hide effective attributes Show effective attributes object

      • enabled object

        Per-layer enable/disable for each notification channel. Each value is tri-state:

        • true — explicitly enabled at this layer
        • false — explicitly disabled (Owner only; non-Owner false is normalised to null on save)
        • null — no opinion at this layer; effective state inherits from the merge of any ancestor layer that took a position. If no layer in the chain enables a channel, the channel stays off.
        Hide enabled attributes Show enabled attributes object

        • email boolean | null
        • webhook boolean | null
        • telegram boolean | null
      • email_recipients array[object]

        Not more than 50 elements.

        Hide email_recipients attributes Show email_recipients attributes object

        • address string(email) Required

          Maximum length is 320.

        • severities array[string]

          Severity scope for this recipient. Empty (or omitted) means "all severities" — the recipient lands on every per-severity receiver. A non-empty subset narrows delivery to those severities.

          Not more than 3 elements. Values are critical, warning, or info.

        • language string

          Rendering language for this recipient's email body and subject. Defaults to en when omitted.

          Values are en or it.

        • format string

          Body format preference. html (default) emits multipart with an html primary body and text alternative; plain emits only a text body.

          Values are html or plain.

        • scope object

          Narrows a recipient to the alerts of some organizations and/or some systems; an alert matches when it falls in any list. Omitted or all lists empty means every system the layer reaches. Every id must belong to the caller's hierarchy, otherwise the save fails with out_of_scope on <channel>_recipients.<i>.scope.

          Hide scope attributes Show scope attributes object

          • managed_organization_ids array[string]

            "Managed by": the systems of each organization and of its whole sub-tree (a distributor's resellers and customers, a reseller's customers).

            Not more than 100 elements. Format of each should match the following pattern: ^[A-Za-z0-9_-]{1,255}$.

          • assigned_organization_ids array[string]

            Only the systems assigned to each organization itself, not those of the organizations it manages.

            Not more than 100 elements. Format of each should match the following pattern: ^[A-Za-z0-9_-]{1,255}$.

          • system_ids array[string]

            Not more than 500 elements. Format of each should match the following pattern: ^[A-Za-z0-9_-]{1,255}$.

      • webhook_recipients array[object]

        Not more than 20 elements.

        Hide webhook_recipients attributes Show webhook_recipients attributes object

        • name string Required

          Descriptive label for the webhook target (UI only).

          Maximum length is 100.

        • url string(uri) Required

          Webhook URL. Validation rejects non-public destinations (loopback, RFC1918, RFC6598 CGNAT, link-local, multicast, cloud metadata) and requires a canonical hostname (containing at least one letter) or a valid IP literal. Only http/https schemes are accepted; URLs cannot embed userinfo.

          Maximum length is 2048.

        • severities array[string]

          Not more than 3 elements. Values are critical, warning, or info.

        • scope object

          Narrows a recipient to the alerts of some organizations and/or some systems; an alert matches when it falls in any list. Omitted or all lists empty means every system the layer reaches. Every id must belong to the caller's hierarchy, otherwise the save fails with out_of_scope on <channel>_recipients.<i>.scope.

          Hide scope attributes Show scope attributes object

          • managed_organization_ids array[string]

            "Managed by": the systems of each organization and of its whole sub-tree (a distributor's resellers and customers, a reseller's customers).

            Not more than 100 elements. Format of each should match the following pattern: ^[A-Za-z0-9_-]{1,255}$.

          • assigned_organization_ids array[string]

            Only the systems assigned to each organization itself, not those of the organizations it manages.

            Not more than 100 elements. Format of each should match the following pattern: ^[A-Za-z0-9_-]{1,255}$.

          • system_ids array[string]

            Not more than 500 elements. Format of each should match the following pattern: ^[A-Za-z0-9_-]{1,255}$.

      • telegram_recipients array[object]

        Not more than 20 elements.

        Hide telegram_recipients attributes Show telegram_recipients attributes object

        • bot_token string Required

          Maximum length is 256.

        • chat_id integer(int64) Required
        • message_thread_id integer(int64)

          Topic of a forum-enabled supergroup to post into. Omit to post in the General topic (or in the plain chat when topics are off).

          Minimum value is 1.

        • severities array[string]

          Not more than 3 elements. Values are critical, warning, or info.

        • scope object

          Narrows a recipient to the alerts of some organizations and/or some systems; an alert matches when it falls in any list. Omitted or all lists empty means every system the layer reaches. Every id must belong to the caller's hierarchy, otherwise the save fails with out_of_scope on <channel>_recipients.<i>.scope.

          Hide scope attributes Show scope attributes object

          • managed_organization_ids array[string]

            "Managed by": the systems of each organization and of its whole sub-tree (a distributor's resellers and customers, a reseller's customers).

            Not more than 100 elements. Format of each should match the following pattern: ^[A-Za-z0-9_-]{1,255}$.

          • assigned_organization_ids array[string]

            Only the systems assigned to each organization itself, not those of the organizations it manages.

            Not more than 100 elements. Format of each should match the following pattern: ^[A-Za-z0-9_-]{1,255}$.

          • system_ids array[string]

            Not more than 500 elements. Format of each should match the following pattern: ^[A-Za-z0-9_-]{1,255}$.

    • yaml string

      Rendered Alertmanager YAML (secrets redacted).

• 400 application/json

  Bad request - validation error

  Hide response attributes Show response attributes object

  • code integer

    HTTP error code

  • message string

    Error message

  • data object
    Hide data attributes Show data attributes object

    • type string

      Type of error

      Values are validation_error or external_api_error.

    • errors array[object]
      Hide errors attributes Show errors attributes object

      • key string

        Field name that failed validation

      • message string

        Error code or message

      • value string

        Value that failed validation

    • details

      Additional error details

• 401 application/json

  Unauthorized - invalid or missing token

  Hide response attributes Show response attributes object

  • code integer
  • message string
  • data object | null
• 403 application/json

  Forbidden - insufficient permissions

  Hide response attributes Show response attributes object

  • code integer
  • message string
  • data object | null
• 422 application/json

  Unprocessable entity - business logic error

  Hide response attributes Show response attributes object

  • code integer

    HTTP error code

  • message string

    Error message

  • data object
    Hide data attributes Show data attributes object

    • type string

      Type of error

      Values are validation_error or external_api_error.

    • errors array[object]
      Hide errors attributes Show errors attributes object

      • key string

        Field name that failed validation

      • message string

        Error code or message

      • value string

        Value that failed validation

    • details

      Additional error details