Token - Token Delete

Endpoint

/i/token/delete

Overview

Deletes one token owned by the authenticated user.

Authentication

Pass api_key or auth_token as a query parameter, or send countly-token as a header. See Authentication.

Permissions

• Any authenticated dashboard user.

Request Parameters

Parameter	Type	Required	Description
api_key	String	Yes (or use auth_token)	Dashboard API key.
auth_token	String	Yes (or use api_key)	Dashboard auth token.
tokenid	String	Yes	Token ID to revoke.

Examples

Example 1: Delete token

/i/token/delete?api_key=YOUR_API_KEY&tokenid=884803f9e9eda51f5dbbb45ba91fa7e2b1dbbf4b

Response

Success Response

{
  "result": {
    "n": 1,
    "ok": 1,
    "deletedCount": 1
  }
}

Response Fields

Field	Type	Description
result	Object	Mongo remove result object.
result.deletedCount	Number	Number of token rows deleted.

Error Responses

Status Code: 404 Not Found

{
  "result": "Token id not provided"
}

Status Code: 400 Bad Request

{
  "result": "Missing parameter \"api_key\" or \"auth_token\""
}

Status Code: 404 Not Found

{
  "result": "Database error message"
}

Behavior

Behavior Modes

Mode	Trigger	Processing Path	Response Shape
Delete success	Valid tokenid and ownership match	Removes token by _id and owner.	Wrapped DB remove result object.
Missing token id	tokenid omitted	Rejects before DB call.	Wrapped error string.

Limitations

• Endpoint only removes tokens owned by the caller.

Related Endpoints

• Token Create
• Token List

Implementation details

Database Collections

Collection	Used for	Data touched by this endpoint
countly.members	Auth validation	Resolves authenticated member.
countly.auth_tokens	Token revocation target	Removes token row matching _id and owner.