Run Report
This page describes how the endpoint behaves today.
Endpoint
Section titled “Endpoint”POST /v1/reports/reports/runAuthentication
Section titled “Authentication”Include your API key in the x-api-key header. See Authentication.
Required Scope
Section titled “Required Scope”reports:runRequest Body
Section titled “Request Body”This endpoint does not read a request body. No report types or report parameters are accepted.
Example Request
Section titled “Example Request”curl -X POST "https://api.crewsum.com/v1/reports/reports/run" \ -H "x-api-key: $CREWSUM_API_KEY"const response = await fetch("https://api.crewsum.com/v1/reports/reports/run", { method: "POST", headers: { "x-api-key": process.env.CREWSUM_API_KEY },});const result = await response.text();POST /v1/reports/reports/run HTTP/1.1Host: api.crewsum.comx-api-key: <your-api-key>Response
Section titled “Response”The API returns HTTP 200 OK with a plain-text body (Content-Type: text/plain), not JSON.
Example Response
Section titled “Example Response”POST /reports/runBehavior
Section titled “Behavior”- The response is always the same placeholder text. No report runs and no data is returned.
- The endpoint has no side effects.
Error Responses
Section titled “Error Responses”This endpoint does not return its own errors.
Authentication and scope failures are described in Errors.
Related Webhooks
Section titled “Related Webhooks”This endpoint does not trigger a webhook.