customer-insights

Operations related to customer-insights

Create Download

Create Customer Insights Presigned URLsThe rate limit for this endpoint is 30 requests per day per workspaceId, which is lower than the default due to access pattern restrictions. Once reached, this endpoint will respond with the 429 HTTP status code with headers indicating the limit parameters. See Rate Limiting for more information.

Securitytoken
Request
Request Body schema: application/vnd.segment.v1alpha+json
required
collectionId
required
string (collectionId)

The collection's unique id.

hour
required
string (hour)

The ISO8601 formatted timestamp corresponding to a specific hour and day to retrieve data for. E.g.: 2025-05-07T23:00:00Z Objects are bucketed by hour and a month of data is retained.

Responses
200

OK

404

Resource not found

422

Validation failure

429

Too many requests

post/customer-insights/download
Request samples
application/vnd.segment.v1alpha+json
{
  • "collectionId": "2wmpXTGB69A8BwGJ4hD5XvQ03aD",
  • "hour": "2006-01-02T15:04:05.000Z"
}
Response samples
application/vnd.segment.v1alpha+json
{}