Delete AceDataCloud Platform API Credential

Permanently delete an API credential. Once deleted, it cannot be recovered immediately, and all business interfaces using that Token will receive a 401 right away.

ℹ️ This interface belongs to the AceDataCloud Platform Management API, with a unified prefix of https://platform.acedata.cloud/api/v1/.

Interface Overview

Item Content
Method DELETE
URL https://platform.acedata.cloud/api/v1/credentials/{credential_id}
Auth ✅ Requires account token

⚠️ The URL should not have a trailing slash — /credentials/{id} is not /credentials/{id}/.

Authentication Instructions (How to Obtain Account Token)

Request Header:

Authorization: Bearer platform-v1-92eb****629c

For obtaining the token, see Manage AceDataCloud Platform Account Token.

Path Parameters

Parameter Type Required Description
credential_id UUID ✅ The ID of the credential to delete

Request Example

cURL

curl -X DELETE 'https://platform.acedata.cloud/api/v1/credentials/df3e1b1b-9e72-4c4f-9a83-1e23f7c8b4d6' \
  -H 'authorization: Bearer platform-v1-92eb****629c'

Python

import requests

cred_id = "df3e1b1b-9e72-4c4f-9a83-1e23f7c8b4d6"
resp = requests.delete(
    f"https://platform.acedata.cloud/api/v1/credentials/{cred_id}",
    headers={"authorization": "Bearer platform-v1-92eb****629c"},
    timeout=10,
)
assert resp.status_code == 204, resp.text
print("✅ Deleted")

Node.js

const credId = 'df3e1b1b-9e72-4c4f-9a83-1e23f7c8b4d6'
const r = await fetch(`https://platform.acedata.cloud/api/v1/credentials/${credId}`, {
  method: 'DELETE',
  headers: { authorization: 'Bearer platform-v1-92eb****629c' },
})
console.log('status:', r.status) // 204

Response

  • Success: HTTP 204 No Content, no response body.
  • Failure: Returns error JSON, see the table below.

Error Handling

HTTP Code Meaning
401 not_authenticated Missing account token
403 permission_denied This credential does not belong to you
404 not_found Credential does not exist or has been deleted
500 — Trailing slash mistakenly added to URL, retry after removing it

Practical Tips

  • Deletion is irreversible — the platform does not keep a copy of the Token. If you only suspect a leak and want to retain monitoring data, you should use Rotate AceDataCloud Platform API Credential instead of deleting.
  • Deletion will not refund the quota already consumed by the credential. Application balance is deducted in real-time based on consumption, and deleting the credential does not affect the balance on record.
  • The credentials_count field is updated in real-time: You can see the current number of issued credentials for that Application through Get AceDataCloud Platform Service Application Details.
  • Batch clean up zombie credentials: First call the List Interface to find those with used_at IS NULL or used_at greater than 90 days ago, and call this interface to delete them one by one.