Feedback Insights

Aggregated feedback-loop insights for the mapped workspace.

Endpoint

GET /api/v1/feedback/insights

Authentication

All requests require the X-Satellyte-API-Key header. See Quickstart.

Query parameters

Field	Type	Required	Notes
`days`	number	No	Lookback window. Defaults to 30, max 365.

cURL

curl -i "https://api-staging.satellyte.ai/api/v1/feedback/insights?days=30" \
  -H "X-Satellyte-API-Key: $API_KEY"

Response (200)

{
  "data": {
    "period": {
      "days": 30,
      "since": "2026-04-11T07:52:33.374Z"
    },
    "summary": {
      "total_leads": 86,
      "replied": 0,
      "positive": 0,
      "meetings": 0,
      "bounced_or_skipped": 0
    },
    "rates": {
      "reply_rate": 0,
      "positive_rate": 0,
      "meeting_rate": 0
    },
    "winning_personas": {
      "titles": [
        {
          "title": "Wealth Management | AI Regulations",
          "total": 1,
          "replies": 0,
          "positive": 0,
          "meetings": 0
        }
      ],
      "companies": [
        {
          "company": "Affinity.co",
          "total": 1,
          "replies": 0,
          "positive": 0,
          "meetings": 0
        }
      ],
      "signal_types": []
    },
    "next_actions": [
      "Use top positive titles as priority target_titles in /api/v1/contacts/find.",
      "Use winning signal_types to prioritize /api/v1/signals/bulk output.",
      "Use companies with meetings or positive replies as lookalike seeds for future discovery."
    ]
  }
}

Response fields

Field	Type	Notes
`period.days`	number	Echoed lookback.
`period.since`	string	ISO timestamp of the start of the window.
`summary`	object	Totals over the window.
`rates`	object	Reply, positive, meeting rates as decimals.
`winning_personas.titles[]`	object[]	Top titles by outcome.
`winning_personas.companies[]`	object[]	Top companies by outcome.
`winning_personas.signal_types[]`	object[]	Top signal types by outcome.
`next_actions`	string[]	Suggested next steps to improve outcomes.

Error responses

All failed calls use the standard error envelope documented in Errors.

Status	Code	Notes
`400`	`validation_error`	Returned when query parameters are invalid, such as an unsupported `days` value.
`401`	`unauthorized`	Returned when `X-Satellyte-API-Key` is missing, invalid, or expired.
`404`	`not_found`	Returned when Public API access is not enabled or the requested Public API resource is unavailable.
`429`	`rate_limit_exceeded`	Returned when the API key exceeds its configured rate limit.
`500`	`service_error`	Returned when Satellyte cannot load feedback insights. Retry with backoff.