Give recognition

Send recognition (a bonus) to one or more colleagues on behalf of the
authenticated caller. Inputs: one or more recipients, an integer points
amount, a free-form reason, and one company hashtag.

Inputs:

  • recipients (array of strings) — each entry is a user id, email address,
    or display name.
  • amount (integer) — points to give. Pass 0 only if your company allows zero-point.
  • reason (string) — free-form recognition message (no need to include @mentions or
    +amount — they're synthesized from recipients and amount).
  • hashtag (string) — one company hashtag without the leading # (e.g. "teamwork").

When any required input is missing or a recipient cannot be resolved, the response
either carries a requestedSchema (for clients that declared elicitation at
initialize) or a standard INVALID_PARAMS error.

Returns the new bonus id and a permalink path on success.

Required OAuth scope: recognition:write

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
enum
required
Allowed:
string
enum
required
Allowed:
params
object
required
string
required
Responses

401

Unauthorized

403

Forbidden

Language
Credentials
Bearer
OAuth2 access token
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json