# dce_badges.grantuserbadge: Discourse Package for Badges operations that could not be mapped to a table.
dce_badges.grantuserbadge: Discourse Package for Badges operations that could not be mapped to a table.Parameters of Procedure
The following parameters can be used to control the behaviour of the procedure `dce_badges.grantuserbadge`. A value must be provided at all times for required parameters, but optional parameters in general do not need to have a value and the execution will default to a pre-defined behaviour. Values can be specified by position and by name. In both cases, all parameters not specified will be evaluated using their default values.
Value specification by position is done by listing all values from the first to the last needed value. For example: a `begin package.procedure(value1, value2, value3); end` on a procedure with four parameters will use the default value for the fourth parameter and the specified values for the first three.
Value specification by name is done by listing all values that require a value. For example with `begin package.procedure(name1 => value1, name3 => value3); end` on the same procedure will use the default values for the second and fourth parameters and the specified values for the first and third.
| Name | Data Type | Required | Default Value | Documentation |
|---|:---:|:---:|:---:|---|
| `username` | `string` | ☑ | | The username of the user to grant the badge to. |
| `badge_id` | `int64` | ☐ | | The ID of the badge to grant. Either badge_id or badge_name
is required. |
| `badge_name` | `string` | ☐ | | The name of the badge to grant. Either badge_id or
badge_name is required. |
| `reason` | `string` | ☐ | | Optional URL of a post or topic associated with the
grant. Cannot be used together with post_id. |
| `post_id` | `int64` | ☐ | | Optional ID of a visible, non-deleted post associated
with the grant. Cannot be used together with reason. |
| `suppress_notification` | `boolean` | ☐ | False | Suppress the notification for this grant only. Omit
or set to false to preserve normal notification behavior, including
existing suppression rules. The badge is still granted and grant
events still occur. |