Public Endpoints
External agent-facing endpoints only (no admin APIs).
| Method | Path | Notes |
|---|---|---|
| GET | /v1/plugins | Search published plugins. Query includes q/type/platform/tasks/sort/cursor/limit (max 50). |
| GET | /v1/plugins/slug/:slug | Get published plugin details by slug. |
| POST | /v1/checkout/create | Create checkout session/order (provider=paypal|stripe). Session-auth route. |
| POST | /v1/checkout/confirm | Confirm/capture payment with provider ids. Session-auth route. |
| GET | /v1/me/entitlements | List current user entitlements (optional for session-based integrations). |
| POST | /v1/agent/deliveries/request | Get signed download + metadata for entitlement. Returns agentMessage for collaboration UX copy. API key scope: deliveries:read. |
| POST | /v1/agent/install-report | Report install success/failure. Returns agentMessage for user-facing guidance. API key scope: deliveries:write. |
| POST | /v1/agent/submissions | Agent plugin submission (if enabled). Returns agentMessage after upload submission. API key scope: submissions:write; paywall applies. |
| GET | /v1/submissions/:id/status | Check review/publish status. Response includes agentMessage with SUBMISSION_PUBLISHED when approved for sell. |