Skip to content

ISS-11 Add Rewards (Alpha) API documentation#215

Open
diegofranck-paxos wants to merge 11 commits intomainfrom
df/ISS-11
Open

ISS-11 Add Rewards (Alpha) API documentation#215
diegofranck-paxos wants to merge 11 commits intomainfrom
df/ISS-11

Conversation

@diegofranck-paxos
Copy link
Copy Markdown

@diegofranck-paxos diegofranck-paxos commented Mar 30, 2026

Summary

  • Add new Rewards (Alpha) section to the API Reference with four endpoint groups: Reward Addresses, Claims, Payout Groups, and Rewards
  • Create 19 new MDX files (overview pages + individual endpoint files, and changelog) across four new directories
  • Update docs.json navigation to include the new section after the existing Rewards group
  • Add changelog entry dated March 30, 2026

Endpoints documented

Group Endpoints
Reward Addresses GET/POST /rewards/addresses, PUT/DELETE /rewards/addresses/{id}
Claims GET/POST /rewards/claim-schedules, PUT/DELETE /rewards/claim-schedules/{id}, GET /rewards/claims
Payout Groups GET/POST /rewards/payout-groups, PUT/DELETE /rewards/payout-groups/{id}
Rewards GET /rewards/details

Test plan

  • Verify new Rewards (Alpha) section appears in the sidebar after the existing Rewards group
  • Confirm all endpoint pages render correctly from the OpenAPI spec
  • Check overview pages display the Alpha availability note
  • Validate changelog entry renders correctly

🤖 Generated with Claude Code

Add new Rewards (Alpha) section to the API Reference with four endpoint
groups: Reward Addresses, Claims, Payout Groups, and Rewards. Includes
overview pages, individual endpoint MDX files, docs.json navigation
updates, and a changelog entry.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@mintlify
Copy link
Copy Markdown
Contributor

mintlify bot commented Mar 30, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
paxos-0ac97319 🟢 Ready View Preview Mar 30, 2026, 5:45 PM

The validate-scopes CI check requires scope blocks only when the
OpenAPI spec defines OAuth2 security on the endpoint. These alpha
endpoints have no OAuth security defined in the spec.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Add paxos-v2-preview-rewards.openapi.json to define OAuth2 security
on all Rewards (Alpha) endpoints, satisfying the validate-scopes CI
check. Restore scope blocks in all 14 endpoint MDX files.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Replace stub responses with complete schemas from the live OpenAPI spec,
including all request bodies, query parameters, and response objects for
all 14 Rewards (Alpha) endpoints.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
diegofranck-paxos and others added 2 commits March 30, 2026 19:29
Replace the group name and move the alpha indicator to a Mintlify
sidebar tag, matching the design shown in the product screenshot.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Replace all Alpha references with Preview language across overview
pages and the preview spec version field.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant