Skip to main content
POST
/
partner
/
links
/
{linkId}
/
revoke
Revoke a magic link
curl --request POST \
  --url https://m2m-backend-qa.up.railway.app/partner/links/{linkId}/revoke \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "reason": "User requested cancellation"
}
'
{
  "success": true,
  "data": {
    "linkId": "link_acme_a1b2c3d4e5f6",
    "status": "revoked",
    "revokedAt": "2026-02-10T15:00:00.000Z"
  }
}

Authorizations

​
X-API-Key
string
header
required

Your partner API key. Use m2m_test_* keys for the sandbox environment.

Path Parameters

​
linkId
string
required

Unique magic link identifier

Example:

"link_acme_a1b2c3d4e5f6"

Body

application/json
​
reason
string

Human-readable reason for revoking the link. Stored for audit purposes.

Example:

"User requested cancellation"

Response

Magic link revoked successfully

​
success
boolean
required
Example:

true

​
data
object
required