Delete a signature
Deletes the signature and ends public access after its current revision has been verified. Remove its connected custom domains before deleting it.
/api/v1/marketing/signatures/{signatureId}Workspace automation for approved Dashio products. Each token is scoped to one Space and independently granted operations. Requests spend shared minute credits, and selected operation groups also share hourly quotas.
Required token scope is marketing:signatures:manage. Scopes are independent.
This operation uses 10 credits from a shared budget of 60 credits per token and 300 per Space each UTC minute. The file transfer group shares 24 requests per token and 60 per Space each UTC hour.
Run these examples on a trusted server with DASHIO_API_TOKEN configured. Use a private terminal when inspecting response data. Examples send one request with a bounded timeout and do not retry automatically.
Authentication
Dashio developer token (HTTP Bearer) API authentication guide
Path parameters
signatureIdstring (uuid)RequiredStable signature UUID.
Query parameters
revisionintegerRequiredCurrent signature revision. Minimum: 1. Maximum: 2147483646.
Header parameters
None documented.
Request body
No content type declared
No request body schema is documented.
Responses
Headers on every response
X-Request-Idstring (uuid)OptionalServer-generated ID to include in a support request.
204
The signature was deleted.
Response headers
RateLimit-LimitintegerOptionalPer-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway. Minimum: 1.
RateLimit-RemainingintegerOptionalRequests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway. Minimum: 0.
RateLimit-ResetintegerOptionalUnix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway. Minimum: 0.
No response body.
400
The request fields, selectors or resource identifiers are invalid.
application/json
statusCodeintegerRequiredMinimum: 400. Maximum: 599.
statusMessagestringOptionalA safe explanation suitable for display.
dataobjectRequiredNo field description supplied.
401
A valid Developer API bearer token is required.
Response headers
WWW-AuthenticatestringOptionalBearer authentication challenge. A rejected token can include the invalid_token error.
application/json
Uses the same response body schema as HTTP 400.
402
An active eligible Marketing entitlement is required.
application/json
Uses the same response body schema as HTTP 400.
403
The token scope, current Space role or plan allowance does not permit this operation.
application/json
Uses the same response body schema as HTTP 400.
404
The resource was not found in the token Space or the operation is unavailable.
application/json
Uses the same response body schema as HTTP 400.
408
The request body could not be read before the deadline.
application/json
Uses the same response body schema as HTTP 400.
409
The revision, connection, quota reservation or current resource state conflicts with the request.
application/json
Uses the same response body schema as HTTP 400.
413
This operation does not accept a request body.
application/json
Uses the same response body schema as HTTP 400.
429
The request rate limit was reached. Edge traffic limits can also return 429.
Response headers
RateLimit-LimitintegerOptionalPer-token capacity in the reported gateway window, expressed in requests of this operation. A shared Space budget also applies. Present when the request reaches the authenticated gateway. Minimum: 1.
RateLimit-RemainingintegerOptionalRequests of this operation remaining under the current token, Space and applicable operation-group quotas. Present when the request reaches the authenticated gateway. Minimum: 0.
RateLimit-ResetintegerOptionalUnix timestamp in seconds when the reported gateway quota resets. Present when the request reaches the authenticated gateway. Minimum: 0.
Retry-AfterintegerOptionalSeconds to wait before retrying, when the limiting policy supplies a retry time. Minimum: 1.
application/json
Uses the same response body schema as HTTP 400.
503
The operation is temporarily unavailable.
application/json
Uses the same response body schema as HTTP 400.
Was this helpful?