Reward Zone

---
name: reward-zone-d32a5c1424f4
description: Send and receive recognition awards on Red Hat Reward Zone. Uses pure HTTP SAML. Use when user says "send reward", "give recognition", "check reward zone points", or "view received awards".
---

# Reward Zone

Interact with rewardzone.redhat.com: send awards, view received/sent, check points. Pure HTTP, no browser.

## Inputs

| Input       | Type   | Default         | Purpose                                              |
| ----------- | ------ | --------------- | ---------------------------------------------------- |
| `action`    | string | required        | "send", "view_received", "check_points", "view_sent" |
| `recipient` | string | -               | Name or email (required for send)                    |
| `award`     | string | "Focus on Team" | Award name                                           |
| `category`  | string | "RH Multiplier" | RH Multiplier, Team Advocate, Customer Focus         |
| `points`    | int    | 25              | Points to award                                      |
| `message`   | string | -               | Recognition message (required for send)              |
| `dry_run`   | bool   | false           | Preview without submitting                           |

## Prerequisites

- Redhatter service on localhost:8009
- Red Hat SSO (Kerberos ID + PIN/token)

## Workflow

### 1. Validate Inputs

- action in ["send", "view_received", "check_points", "view_sent"]
- For send: recipient and message required; points positive int

### 2. Create HTTP Session

- `http_session_create(name="reward_zone", base_url="https://rewardzone.redhat.com")`

### 3. Authenticate

- `http_saml_auth(session="reward_zone")` — pure HTTP SAML
- If not successful → return auth troubleshooting (redhatter, VPN, credentials)

### 4. Dispatch by Action

**check_points:**

- `http_request(session="reward_zone", method="GET", path="/api/v1/NominationPoints/getNominationPoints")`
- Parse and return available points

**view_received:**

- `http_request(session="reward_zone", method="GET", path="/api/v1/Awards/getReceivedAwards")`
- Parse and return awards table (Date, From, Award, Points, Message)

**view_sent:**

- `http_request(session="reward_zone", method="GET", path="/api/v1/Awards/getSentAwards")`
- Parse and return awards table

**send:**

- `http_request(session="reward_zone", method="GET", path="/api/v1/Members/advancedMemberSearch", params='{"searchText": "recipient"}')`
- Parse for pin, name; if not found → return "Recipient not found"
- If dry_run → return preview and exit
- `http_request(session="reward_zone", method="POST", path="/api/v1/Awards/submitNomination", json_body='{"nomineePin": "pin", "awardName": "award", "points": N, "description": "msg", "message": "msg"}')`

### 5. Post-Action

- `memory_session_log("Reward Zone {action}", ...)`

## Key Details

- **No browser:** Pure HTTP SAML flow
- **Auth:** redhatter → `systemctl --user start redhatter`
- **Categories:** RH Multiplier, Team Advocate, Customer Focus