Admin
Rep

Grant D-Sports Direct Rep to a user

Changed on

isAdmin only. Body: { amount: integer 1–100000, reason?: string max 200, idempotencyKey?: string }. Retries: send an Idempotency-Key header (or body idempotencyKey; the header wins), 1–128 of letters, digits, '_', '-', ':' or '.'. The ledger keys the grant per admin, so a retry returns the original entry with alreadyRecorded: true and grants nothing new; reusing a key with a different amount is 409 IDEMPOTENCY_KEY_REUSED. Without a key each POST is a new grant.

post/api/admin/users/{userId}/rep

Request

  • Base URL
    https://app.d-sports.org
  • Auth
    HTTP bearer

Path parameters

userIdstring required

Headers

Idempotency-Keystring

Client retry key, scoped to the calling admin.

Request body

amountinteger required
reasonstring
idempotencyKeystring

Same as the Idempotency-Key header; used only when the header is absent.

Response

{ userId, amount, reason, entryId, alreadyRecorded } — alreadyRecorded is true when an idempotency key replayed an earlier grant.

Changes

    • info

      added the new optional header request parameter Idempotency-Key

    • info

      added the new optional request property

    • info

      added the non-success response with the status