# Downloads

OpenAPI spec and Postman collection for API v5.9.3.3

### Postman Package

#### Import into Postman to test all public REST endpoints against your installation.

#### Download Postman Package (.zip)

Collection + environment + OpenAPI spec. Version 5.9.3.3.

#### Download Static Docs (.zip)

Portable HTML documentation — no PHP required.

### Individual Files

File | Format | Use
--- | --- | ---
agents.html / agents.md | Markdown | AI agents — canonical machine-readable API reference
llms.txt | Plain text | Agent discovery index
for-agents.html | HTML | Agent landing page with instructions
RPM-PRO-API.postman_collection.json | Postman Collection v2.1 | Import → Collections
RPM-PRO-Local.postman_environment.json | Postman Environment | Import → Environments, set `baseUrl` and credentials
rpm-pro-api.openapi.yaml | OpenAPI 3.0 | Import into Postman, Swagger UI, or code generators

### Postman Setup

1. Download and unzip the Postman package, or import the JSON files directly.
2. In Postman: Import → select collection and environment files.
3. Select the RPM PRO — Local environment.
4. Set variables:
   - `baseUrl` — your site root (e.g. `https://demo.rpm-pro.com`)
   - `adminAPIKey` / `adminAPISecret` — from `admins` table (for Admin Auth folder)
   - `tenantEmail` / `tenantPassword` — for tenant auth tests
5. Run Admin Auth → Admin Login first if testing admin session endpoints.
6. For tenant endpoints, run Tenant Auth → Tenant Login (cookies are stored automatically).

Regenerate packages: After version bumps in `versions.html`, run `php bin/generate-api-docs.html` from the project root to refresh zips and static exports.

    # From project root (Docker)
    docker compose exec app php bin/generate-api-docs.html

    # Or local PHP
    php bin/generate-api-docs.html