Gift GAMPEONS to an account

POST

/v1/admin/wallet/grants

curl --request POST \
  --url https://api.gampeon.com/v1/admin/wallet/grants \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example' \
  --data '{ "handle": "example", "coins": 1, "reason": "example" }'

• Production

Never to yourself. Gifted GAMPEONS can be spent but never paid out.

Requires the role admin.

Not available with access tokens.

Rate limit: 50 per hour per admin.

Authorizations

• session

Parameters

Header Parameters

Idempotency-Key

required

string

Required. 8 to 100 characters (A-Z a-z 0-9 _ - : .). The same key with the same body returns the stored answer (replayed: true) without booking again.

Request Body^required

Media typeapplication/json

object

handle

required

string

coins

required

integer

>= 1 <= 100000

reason

required

Reason, 5 to 500 characters. Stored in the audit log.

string

>= 5 characters <= 500 characters

Example ^generated

{
  "handle": "example",
  "coins": 1,
  "reason": "example"
}

Responses

201

Gifted

Media typeapplication/json

object

handle

required

string

coins

required

Amount in GAMPEONS

integer

Example ^generated

{
  "handle": "example",
  "coins": 1
}

400

Error codes: invalid_field, idempotency_key_required

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

401

Error codes: unauthorized

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

403

Error codes: forbidden, token_not_allowed, four_eyes_required

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

404

Error codes: not_found

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

409

Error codes: idempotency_conflict

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

429

Limit: 50 per hour per admin. Error codes: rate_limited

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

503

Error codes: payments_disabled

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}