​

Feedback Endpoints

Use these endpoints to manage feedback entries within your organization. Some routes also apply to “spaces” (i.e., subsets or collections within your org).

​

List All Feedback

GET /api/v1/organizations/{org_uuid}/feedbacks

Returns a paginated list of feedback for the specified organization.

​

Path Parameters

• org_uuid (string) – The UUID of the organization.

​

Query Parameters (optional)

• page_size (integer, default: 25)
• page_number (integer, default: 1)
• customer_uuids, company_uuids (comma-separated strings)
• feedback_types (comma-separated strings)
• from_date, to_date
• search
• Other filters (e.g., priority, min_sentiment, etc.).

​

Example Request

GET /api/v1/organizations/abc123/feedbacks?page_size=10

​

Example Response

{
  "feedbacks": [
    {
      "uuid": "fdbk-1111-2222-3333",
      "organization_uuid": "abc123",
      "customer_uuid": "cust-0001",
      "feedback_contents": "I love this feature!",
      "feedback_date": "2025-01-01T12:34:56",
      "priority": 0,
      "feedback_type": "FEEDBACK_RESPONSE",
      // ...
    }
  ],
  "total_feedback_count": 42
}

​

Create Feedback

POST /api/v1/organizations/{org_uuid}/feedbacks

Creates a new feedback entry in the specified organization.

​

Path Parameters

• org_uuid (string)

​

Request Body

{
  "feedback_contents": "The UI could be simpler.",
  "feedback_date": "2025-03-20T10:15:00",
  "customer_uuid": "cust-0001",
  "priority": 1,
  "feedback_type": "FEEDBACK_RESPONSE",
  "space_uuids": ["space-xyz"]    // optional
}

​

Example Request

curl -X POST "https://your-domain.com/api/v1/organizations/abc123/feedbacks" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "feedback_contents": "The UI could be simpler.",
    "customer_uuid": "cust-0001"
  }'

​

Example Response

{
  "feedbacks": [
    {
      "uuid": "fdbk-2222-3333-4444",
      "organization_uuid": "abc123",
      "customer_uuid": "cust-0001",
      "feedback_contents": "The UI could be simpler.",
      "priority": 1,
      "feedback_type": "FEEDBACK_RESPONSE"
      // ...
    }
  ]
}

​

Delete Feedback (Bulk)

DELETE /api/v1/organizations/{org_uuid}/feedbacks

Removes one or more feedback items from the organization. This removes all highlights associated with the feedback items.

​

Path Parameters

• org_uuid (string)

​

Request Body

{
  "feedback_uuids": ["fdbk-1111-2222", "fdbk-3333-4444"]
}

​

Example Request

curl -X DELETE "https://your-domain.com/api/v1/organizations/abc123/feedbacks" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "feedback_uuids": ["fdbk-1111-2222", "fdbk-3333-4444"]
  }'

​

Example Response

{}

​

Get a Single Feedback

GET /api/v1/organizations/{org_uuid}/feedbacks/{feedback_uuid}

Retrieves a single feedback entry, including details such as highlights.

​

Path Parameters

• org_uuid (string)
• feedback_uuid (string)

​

Example Response

{
  "feedbacks": [
    {
      "uuid": "fdbk-1234",
      "feedback_date": "2025-03-01T00:00:00Z",
      "feedback_contents": "Sample feedback text...",
      "highlights": [
        {
          "uuid": "high-1234",
          "quote": "Sample highlighted text",
          "sentiment_score": 0.8,
          "archived": false
        }
      ]
    }
  ]
}

​

Feedback Highlights (List)

GET /api/v1/organizations/{org_uuid}/feedbacks/{feedback_uuid}/highlights

Returns the highlights for a single feedback item.

​

Path Parameters

• org_uuid (string)
• feedback_uuid (string)

​

Query Parameters (optional)

• page_size (integer, default: 25)
• page_number (integer, default: 1)

​

Example Request

GET /api/v1/organizations/abc123/feedbacks/fdbk-1234/highlights

​

Example Response

{
  "highlights": [
    {
      "uuid": "high-1234",
      "quote": "Sample highlighted text",
      "sentiment_score": 0.8
      // ...
    }
  ],
  "total_highlight_count": 1
}

​

Get Feedback in a Space

GET /api/v1/organizations/{org_uuid}/spaces/{space_uuid}/feedbacks

Lists feedback entries associated with a particular space.

​

Path Parameters

• org_uuid (string)
• space_uuid (string)

​

Example Request

GET /api/v1/organizations/abc123/spaces/xyz456/feedbacks

​

Get Top Feedback Highlights

GET /api/v1/organizations/{org_uuid}/feedback_highlights

Lists the most “notable” feedback highlights (sorted by sentiment, likes, etc.).

​

Path Parameters

• org_uuid (string)

​

Query Parameters

• liked_only (boolean, default: false)
• page_size (integer, default: 25)
• page_number (integer, default: 1)
• sort_by (string, default: sentiment)
• sort_direction (string, default: desc)

​

Example Request

GET /api/v1/organizations/abc123/feedback_highlights?liked_only=true

​

Example Response

{
  "feedback_highlights": [
    {
      "uuid": "high-9999",
      "quote": "This app exceeded my expectations!",
      "sentiment_score": 0.95,
      "liked": true,
      // ...
    }
  ],
  "total_highlight_count": 1,
  "total_customer_count": 1
}

​

Additional Notes

• Pagination: All list endpoints support page_size (max=100 or 1000, depending on the route) and page_number.
• Filtering: Many routes accept query params like search, customer_uuids, company_uuids, etc.
• Error Handling:
  • 400: Bad request or invalid parameters.
  • 401: Unauthorized.
  • 404: Feedback or organization not found.
  • 500: Unexpected server error.
• Space-Specific Endpoints: Use the /spaces/{space_uuid} portion to manage feedback specifically tied to a space.