Skip to main content
POST
/
partner
/
users
/
{userId}
/
block
Block a user
curl --request POST \
  --url https://m2m-backend-qa.up.railway.app/partner/users/{userId}/block \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "reason": "Suspicious activity detected on multiple transactions"
}
'
{
  "success": true,
  "data": {
    "userId": "user_acme_x1y2z3",
    "blocked": true,
    "blockedAt": "2026-02-10T15:00:00.000Z",
    "blockedReason": "Suspicious activity detected"
  }
}

Authorizations

​
X-API-Key
string
header
required

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

Path Parameters

​
userId
string
required

M2M user identifier

Example:

"user_acme_x1y2z3"

Body

application/json
​
reason
string

Human-readable reason for blocking the user. Stored for audit purposes and returned in user detail responses. Max 500 characters.

Example:

"Suspicious activity detected on multiple transactions"

Response

User blocked successfully

​
success
boolean
required
Example:

true

​
data
object
required