Skip to content

Revoke a partner API key. Idempotent — repeats are no-ops.

DELETE
/workspaces/{workspaceId}/partner-keys/{keyId}
curl --request DELETE \
--url https://api.swft.co.uk/workspaces/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/partner-keys/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0
workspaceId
required
string format: uuid
keyId
required
string format: uuid

Revoked.

Bad request — malformed input or missing/invalid parameters.

Media type application/json
object
error
required
object
type
required
string format: uri
code
required
string
message
required
string
doc_url
required
string format: uri
request_id
required
string
param
string
meta
object
key
additional properties
Example generated
{
"error": {
"type": "https://example.com",
"code": "example",
"message": "example",
"doc_url": "https://example.com",
"request_id": "example",
"param": "example",
"meta": {
"additionalProperty": "example"
}
}
}

Missing or invalid authentication.

Media type application/json
object
error
required
object
type
required
string format: uri
code
required
string
message
required
string
doc_url
required
string format: uri
request_id
required
string
param
string
meta
object
key
additional properties
Example generated
{
"error": {
"type": "https://example.com",
"code": "example",
"message": "example",
"doc_url": "https://example.com",
"request_id": "example",
"param": "example",
"meta": {
"additionalProperty": "example"
}
}
}

Authenticated but not authorised (e.g. wrong workspace).

Media type application/json
object
error
required
object
type
required
string format: uri
code
required
string
message
required
string
doc_url
required
string format: uri
request_id
required
string
param
string
meta
object
key
additional properties
Example generated
{
"error": {
"type": "https://example.com",
"code": "example",
"message": "example",
"doc_url": "https://example.com",
"request_id": "example",
"param": "example",
"meta": {
"additionalProperty": "example"
}
}
}

Resource not found.

Media type application/json
object
error
required
object
type
required
string format: uri
code
required
string
message
required
string
doc_url
required
string format: uri
request_id
required
string
param
string
meta
object
key
additional properties
Example generated
{
"error": {
"type": "https://example.com",
"code": "example",
"message": "example",
"doc_url": "https://example.com",
"request_id": "example",
"param": "example",
"meta": {
"additionalProperty": "example"
}
}
}

Conflict — idempotency-key reuse, duplicate resource, etc.

Media type application/json
object
error
required
object
type
required
string format: uri
code
required
string
message
required
string
doc_url
required
string format: uri
request_id
required
string
param
string
meta
object
key
additional properties
Example generated
{
"error": {
"type": "https://example.com",
"code": "example",
"message": "example",
"doc_url": "https://example.com",
"request_id": "example",
"param": "example",
"meta": {
"additionalProperty": "example"
}
}
}

Rate-limited.

Media type application/json
object
error
required
object
type
required
string format: uri
code
required
string
message
required
string
doc_url
required
string format: uri
request_id
required
string
param
string
meta
object
key
additional properties
Example generated
{
"error": {
"type": "https://example.com",
"code": "example",
"message": "example",
"doc_url": "https://example.com",
"request_id": "example",
"param": "example",
"meta": {
"additionalProperty": "example"
}
}
}

Internal server error.

Media type application/json
object
error
required
object
type
required
string format: uri
code
required
string
message
required
string
doc_url
required
string format: uri
request_id
required
string
param
string
meta
object
key
additional properties
Example generated
{
"error": {
"type": "https://example.com",
"code": "example",
"message": "example",
"doc_url": "https://example.com",
"request_id": "example",
"param": "example",
"meta": {
"additionalProperty": "example"
}
}
}