Sites Endpoints
FreshSource: MainWP Sites API
The {id_or_domain} parameter accepts either numeric site IDs or domain names.
Global Operations
| Method | Path | Description |
|---|---|---|
| GET | /sites | List sites with filtering |
| GET | /sites/basic | Minimal site data (ID, URL, name) |
| GET | /sites/count | Total site count |
| POST | /sites/add | Add new child site |
| POST | /sites/batch | Batch create/update/delete |
| POST | /sites/sync | Bulk synchronization |
| POST | /sites/reconnect | Bulk reconnect |
| POST | /sites/disconnect | Bulk disconnect |
Per-Site Operations
| Method | Path | Description |
|---|---|---|
| GET | /sites/{id_or_domain} | Site details |
| PUT/PATCH | /sites/{id_or_domain}/edit | Update site |
| DELETE | /sites/{id_or_domain}/remove | Remove site |
| POST | /sites/{id_or_domain}/sync | Sync single site |
| POST | /sites/{id_or_domain}/reconnect | Reconnect site |
| POST | /sites/{id_or_domain}/disconnect | Disconnect site |
| POST | /sites/{id_or_domain}/suspend | Suspend site |
| POST | /sites/{id_or_domain}/check | Test connectivity |
Plugin/Theme Management
| Method | Path | Description |
|---|---|---|
| GET | /sites/{id_or_domain}/plugins | List installed plugins |
| GET | /sites/{id_or_domain}/themes | List installed themes |
| POST | /sites/{id_or_domain}/plugins/activate | Activate plugins |
| POST | /sites/{id_or_domain}/plugins/deactivate | Deactivate plugins |
| POST | /sites/{id_or_domain}/plugins/delete | Delete plugins |
| POST | /sites/{id_or_domain}/themes/activate | Activate theme |
| POST | /sites/{id_or_domain}/themes/delete | Delete themes |
Relationship Queries
| Method | Path | Description |
|---|---|---|
| GET | /sites/{id_or_domain}/client | Client association |
| GET | /sites/{id_or_domain}/costs | Cost data |
| GET | /sites/{id_or_domain}/security | Security snapshot |
Example: List Sites
bash
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://your-dashboard.com/wp-json/mainwp/v2/sites/basic"Postman Collection
Use the MainWP Postman collection as the source of truth for request and response schemas.