Skip to content
Menu
SilktideDevelopers

Delete a report

DELETE/v1/reports/{reportId}
View as Markdown

Deletes a report and its results at once. It cannot be undone.

The response is an empty 201. Deleting it again returns 404.

Deleting a snapshot a report schedule made leaves the schedule as it is, and it goes on making new ones.

Request
curl -X DELETE "https://api.eu.silktide.com/v1/reports/5" \
  -H "Authorization: silktide token=$SILKTIDE_API_KEY"

Request

Path parameters

  • reportIdintegerrequiredat least 1

    The report.

Response

201No body.

Errors

StatusTypeWhen
403EditionNotAvailableThe account does not have Silktide 4. Reports, report schedules and report templates are Silktide 4's, so an account with only Silktide 5 cannot use them.
400InvalidRequestreportId is not a whole number. properties.field is reportId.
404ModelNotFoundNo report with that id exists in the account.
403AccessDeniedThe API key's user cannot see or admin the report.
401NotLoggedInNo API key was sent, or it is not a key for this region.(any operation)
429TooManyRequestsToo many requests to this path in five seconds. Retry after the number of seconds in the Retry-After header, which properties.retryAfter repeats.(any operation)
503-Silktide is busy. Retry after the number of seconds in the Retry-After header.(any operation)

Every error has the same body. See Errors.

Access

Permission
Can admin this dashboard / snapshot
Plan feature
None
Edition
Silktide 4 only
Cost
Free
Available since
v1.0.0

Try it

Sends a real request to your account from this browser. Your key stays in this tab and goes only to the Silktide API.

This changes your account. It is not a sandbox.