---
id: SCR-PFM-INT-015
title: Needs Attention
route: '/console/{tenantId}/configuration/platform/integrations/needs-attention'
surface: console
product_area: platform
module: integrations
revision: 1
status: draft
design_intent: proposed
implementation_evidence: observed
inference: []
source_sha:
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
  services-platform: ad3f6a6582843008ed0f5a17b131878d15829af1
purpose: Group unresolved operational problems and offer the controls available for each kind.
supports:
  - JNY-PFM-INT-001
  - JNY-PFM-INT-004
  - CAP-PFM-INT-006
  - CAP-PFM-INT-010
  - CAP-PFM-INT-013
  - CAP-PFM-INT-014
permission: platform.integrations.read
entry_from:
  - '/console/{tenantId}/configuration/platform/integrations'
exits_to:
  - '/console/{tenantId}/configuration/platform/integrations/activity/{executionId}'
  - '/console/{tenantId}/configuration/platform/integrations/{integrationKey}/connections/{connectionId}'
  - '/console/{tenantId}/configuration/platform/integrations/events'
displays:
  - field: 'Calls that need attention, excluding those still being looked up'
    source: 'listIntegrationExecutions (needs_attention, unknown with settling state)'
  - field: Dead deliveries
    source: listIntegrationDeliveries
  - field: 'Failed, degraded and re-authorization-required connections'
    source: listIntegrationConnections
  - field: Connector notices
    source: listIntegrationConnectionNotices
  - field: 'Installations, subscriptions and catalogue names for labels'
    source: 'listIntegrationInstallations, listIntegrationSubscriptions, listIntegrationCatalog'
actions:
  - label: Verify
    operation_id: verifyIntegrationConnection
    permission: platform.integrations.manage
    confirm: false
  - label: Check Health
    operation_id: checkIntegrationConnectionHealth
    permission: platform.integrations.manage
    confirm: false
  - label: Retry delivery
    operation_id: retryIntegrationDelivery
    permission: 'Console control: platform.integrations.manage; API: platform.integration-executions.operate'
    confirm: false
  - label: Rotate Secret
    operation_id: rotateIntegrationWebhookEndpoint
    permission: platform.integrations.manage
    confirm: false
  - label: Resolve
    operation_id: resolveIntegrationExecution
    permission: 'Console control: platform.integrations.manage; API: platform.integration-executions.operate'
    confirm: true
states:
  - empty
  - loading
  - error
  - read-only
validation:
  - BR-CAP-PFM-INT-006-10
  - BR-CAP-PFM-INT-010-07
patterns:
  - LibraryPage with breadcrumb navigation.
  - 'ReadState, Empty and shared error presentation for data reads.'
  - The Library access boundary controls entry; each action retains its implemented permission gate.
  - Grouped attention cards with independent read outcomes.
component: components/integrations/needs-attention-screen.tsx
evidence:
  - >-
    react-console at baf6dae3: components/integrations/needs-attention-screen.tsx; lib/integrations/client.ts
    (listNeedsAttention), needs-attention.ts
controls: [TC-AVL-001, TC-AVL-004, TC-AVL-005, TC-AZ-001, TC-AZ-002, TC-AZ-003, TC-AZ-004, TC-CRY-001, TC-CRY-002, TC-CRY-003, TC-CRY-004, TC-DAT-001, TC-DAT-002, TC-DAT-003, TC-IAM-001, TC-IAM-002, TC-IAM-004, TC-IAM-005, TC-IAM-006, TC-LOG-001, TC-LOG-002, TC-LOG-003, TC-LOG-004, TC-LOG-005, TC-MON-001, TC-MON-002, TC-PI-001, TC-PI-002, TC-PI-003, TC-PI-004, TC-PI-005, TC-PRV-001, TC-PRV-002, TC-PRV-004, TC-SEC-001, TC-SEC-002, TC-SEC-003, TC-SEC-004, TC-TEN-001, TC-TEN-002, TC-TEN-003, TC-VEN-001, TC-VEN-002, TC-VEN-003]
---

# Needs Attention

## What the Screen Is For

Group unresolved operational problems and offer the controls available for each kind.

## What It Shows and Lets People Do

Groups combine unresolved calls, dead deliveries, failing account links and connector notices. Resolution and delivery retry controls use integration management in this screen while their APIs require execution-operation authority. A group omitted by a refused read does not prevent other successful groups from being displayed.

## States and Errors

The Library rejects entry without its read authority. Shared loading and error presentation handles data reads; mutation controls are gated separately. A visible control can still be refused by the API’s independent authorization or lifecycle validation.

## Patterns It Must Respect

LibraryPage with breadcrumb navigation. ReadState, Empty and shared error presentation for data reads. The Library access boundary controls entry; each action retains its implemented permission gate. Grouped attention cards with independent read outcomes.