Toloka documentation

create_user_bonus

toloka.client.TolokaClient.create_user_bonus

Issues payments directly to the performer

You can send a maximum of 10,000 requests of this kind per day.

Parameters Description

Parameters Type Description
user_bonus UserBonus

To whom, how much to pay and for what.

operation_id Optional[str]

Operation ID. If asynchronous creation is used, by this identifier you can later get results of creating bonuses.

skip_invalid_items Optional[bool]

Validation parameters of objects:

  • True - Award a bonus if the object with bonus information passed validation. Otherwise, skip the bonus.
  • False - Default behaviour. Stop the operation and don't award bonuses if at least one object didn't pass validation.

  • Returns:

    Created bonus.

  • Return type:

    UserBonus

Examples:

Create bonus for specific assignment.

import decimal
new_bonus = toloka_client.create_user_bonus(
    UserBonus(
        user_id='1',
        amount=decimal.Decimal('0.50'),
        public_title={
            'EN': 'Perfect job!',
            'RU': 'Прекрасная работа!',
        },
        public_message={
            'EN': 'You are the best performer!',
            'RU': 'Молодец!',
        },
        assignment_id='012345'
    )
)