SaaSFlow
DevelopersAPIReferencereports

List versions

List the superseded versions of a report, oldest first. Regenerating a report keeps what it replaced, so this is the audit trail of how the numbers and commentary changed. Documents are omitted; fetch a single version for its document. The current version is not in this list, it is the report itself.

Authentication

You're not signed in. Either sign in at app.saasflow.com and reload (then pick sessionCookie), or paste a SaaSFlow sf_… API key in the bearerAuth field below.
GET
/companies/{companyId}/reports/{id}/versions

Authorization

Authorization<token>

A SaaSFlow API key (format sf_…) or an OAuth bearer token. Paste only the key — the proxy adds the Bearer prefix. Create an API key in Settings → Company settings → API keys — see API keys.

In: header

Path Parameters

companyId*string
Length1 <= length
id*string
Length1 <= length

Response Body

application/json

curl -X GET "https://example.com/companies/string/reports/string/versions"
[  {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "companyId": "8bb73d03-06b4-47c7-80c7-59301f770eda",    "reportId": "836df459-dc40-4aa1-972a-6eb0a864dff9",    "supersededBy": "string",    "createdTime": "2019-08-24T14:15:22Z"  }]

Delete report

Delete a report and its superseded versions. A report that is still generating returns 409; wait for the run to finish before removing it.

Retrieve version

Retrieve one superseded report version with its full document, for reading what an earlier run of the same report actually said. Returns 404 if the version does not exist or does not belong to this report.