Create a gamification-event

POST

/gamification-events

• Current canonical versioned path (F3.API.01)

Authorizations

• bearerAuth
• apiTokenAuth

Request Body ^required

object

data

object

user

required

One of:

string

DocumentId reference to plugin::users-permissions.user

string

object

object

key

additional properties

any

action_type

required

Whitelist kept identical to the internal action-type map in gamification-consumer (F4.GAM.02). ‘easter_egg_triggered’ added by F4.GAM.02 for the stochastic easter-egg budget log (persisted so the consumer can compute each user’s remaining per-year allowance).

string

Allowed values: provisioning_completed runbook_success incident_resolved login_streak automation_score_snapshot badge_awarded manual_admin_grant easter_egg_triggered

xp_granted

required

integer

organisation

One of:

string

DocumentId reference to api::organisation.organisation

string

object

object

key

additional properties

any

metadata

Arbitrary JSON value (object, array, string, number, boolean, or null)

idempotency_key

required

SHA-256 hash of the source RabbitMQ message — prevents duplicate XP grants on redelivery

string

Responses

200

Created

object

data

object

user

required

One of:

string

DocumentId reference to plugin::users-permissions.user

string

object

object

key

additional properties

any

action_type

required

Whitelist kept identical to the internal action-type map in gamification-consumer (F4.GAM.02). ‘easter_egg_triggered’ added by F4.GAM.02 for the stochastic easter-egg budget log (persisted so the consumer can compute each user’s remaining per-year allowance).

string

Allowed values: provisioning_completed runbook_success incident_resolved login_streak automation_score_snapshot badge_awarded manual_admin_grant easter_egg_triggered

xp_granted

required

integer

organisation

One of:

string

DocumentId reference to api::organisation.organisation

string

object

object

key

additional properties

any

metadata

Arbitrary JSON value (object, array, string, number, boolean, or null)

idempotency_key

required

SHA-256 hash of the source RabbitMQ message — prevents duplicate XP grants on redelivery

string

documentId

string

id

integer

createdAt

string format: date-time

updatedAt

string format: date-time

publishedAt

string format: date-time

nullable

400

Validation error

401

Missing or invalid authentication

403

Not authorized (tenant scope or capability)