API Endpoints Quick Reference
FreshREST API v2 — Base: /wp-json/mainwp/v2/
Sites
| Method | Endpoint | Description |
|---|---|---|
| GET | /sites | List all sites |
| GET | /sites/{id} | Get site details |
| POST | /sites | Add new site |
| PUT | /sites/{id} | Update site |
| DELETE | /sites/{id} | Remove site |
| POST | /sites/{id}/sync | Sync site |
| POST | /sites/{id}/reconnect | Reconnect site |
| GET | /sites/{id}/plugins | List site plugins |
| GET | /sites/{id}/themes | List site themes |
| POST | /sites/{id}/plugins/install | Install plugin |
| POST | /sites/{id}/plugins/activate | Activate plugin |
| POST | /sites/{id}/plugins/deactivate | Deactivate plugin |
| POST | /sites/{id}/plugins/delete | Delete plugin |
| POST | /sites/{id}/themes/install | Install theme |
| POST | /sites/{id}/themes/activate | Activate theme |
| POST | /sites/{id}/themes/delete | Delete theme |
| GET | /sites/{id}/posts | List site posts |
| GET | /sites/{id}/pages | List site pages |
| GET | /sites/{id}/users | List site users |
| POST | /sites/{id}/users/import | Import users (CSV) |
| GET | /sites/{id}/security | Security scan |
| POST | /sites/{id}/maintenance | Toggle maintenance mode |
Updates
| Method | Endpoint | Description |
|---|---|---|
| GET | /updates | List all available updates |
| GET | /updates/sites/{id} | Site-specific updates |
| POST | /updates/plugins | Bulk update plugins |
| POST | /updates/themes | Bulk update themes |
| POST | /updates/core | Update WordPress core |
Clients
| Method | Endpoint | Description |
|---|---|---|
| GET | /clients | List clients |
| GET | /clients/{id} | Get client |
| POST | /clients | Create client |
| PUT | /clients/{id} | Update client |
| DELETE | /clients/{id} | Delete client |
Tags
| Method | Endpoint | Description |
|---|---|---|
| GET | /tags | List tags |
| POST | /tags | Create tag |
| PUT | /tags/{id} | Update tag |
| DELETE | /tags/{id} | Delete tag |
Other Resources
| Method | Endpoint | Description |
|---|---|---|
| GET | /monitoring | Uptime data |
| GET | /extensions | Extension list |
| GET | /settings | Dashboard settings |
| GET | /costs | Cost tracking data |
| POST | /batch | Batch operations |
| GET | /api-keys | List API keys |
| POST | /api-keys | Create API key |
Abilities API — Base: /wp-json/wp-abilities/v1/
Discovery
| Method | Endpoint | Description |
|---|---|---|
| GET | /abilities | List all abilities |
| GET | /abilities?category=mainwp/sites | Filter by category |
| GET | /abilities/{provider}/{slug} | Get ability schema |
Execution
| Method | Endpoint | Description |
|---|---|---|
| POST | /abilities/{provider}/{slug}/run | Execute ability |
Sites (30 abilities)
| Slug | Method | Description |
|---|---|---|
list-sites-v1 | GET | List sites with pagination |
count-sites-v1 | GET | Total site count |
get-site-v1 | POST | Single site details |
add-site-v1 | POST | Connect new site |
remove-site-v1 | POST | Remove site (destructive) |
sync-site-v1 | POST | Sync single site |
sync-sites-v1 | POST | Sync multiple/all sites |
reconnect-site-v1 | POST | Reconnect single site |
reconnect-sites-v1 | POST | Reconnect multiple sites |
disconnect-site-v1 | POST | Disconnect site |
disconnect-sites-v1 | POST | Disconnect multiple sites |
check-site-v1 | POST | HTTP health check |
check-sites-v1 | POST | Bulk health check |
suspend-site-v1 | POST | Suspend site |
suspend-sites-v1 | POST | Suspend multiple sites |
unsuspend-site-v1 | POST | Reactivate site |
get-site-plugins-v1 | POST | List plugins |
get-site-themes-v1 | POST | List themes |
install-plugin-v1 | POST | Install plugin |
activate-plugin-v1 | POST | Activate plugin |
deactivate-plugin-v1 | POST | Deactivate plugin |
delete-plugin-v1 | POST | Delete plugin |
install-theme-v1 | POST | Install theme |
activate-theme-v1 | POST | Activate theme |
delete-theme-v1 | POST | Delete theme |
get-site-posts-v1 | POST | List posts |
get-site-pages-v1 | POST | List pages |
get-site-users-v1 | POST | List users |
get-site-categories-v1 | POST | List categories |
get-site-options-v1 | POST | Get WP options |
Updates (13 abilities)
| Slug | Method | Description |
|---|---|---|
list-updates-v1 | GET | All available updates |
get-site-updates-v1 | POST | Single site updates |
list-ignored-updates-v1 | GET | Ignored updates |
run-updates-v1 | POST | Update multiple sites |
update-site-core-v1 | POST | Update WP core |
update-site-plugins-v1 | POST | Update plugins |
update-site-themes-v1 | POST | Update themes |
update-site-translations-v1 | POST | Update translations |
update-all-v1 | POST | Update everything |
set-ignored-updates-v1 | POST | Manage ignore list |
ignore-site-core-v1 | POST | Ignore core update |
ignore-site-plugins-v1 | POST | Ignore plugin updates |
ignore-site-themes-v1 | POST | Ignore theme updates |
Clients (11 abilities)
| Slug | Method | Description |
|---|---|---|
list-clients-v1 | GET | List clients |
count-clients-v1 | GET | Count clients |
get-client-v1 | POST | Get client |
add-client-v1 | POST | Create client |
update-client-v1 | POST | Update client |
delete-client-v1 | POST | Delete client |
get-client-sites-v1 | POST | Client's sites |
count-client-sites-v1 | POST | Count client's sites |
get-client-costs-v1 | POST | Client costs |
suspend-client-v1 | POST | Suspend client |
unsuspend-client-v1 | POST | Unsuspend client |
Tags (7 abilities)
| Slug | Method | Description |
|---|---|---|
list-tags-v1 | GET | List tags |
get-tag-v1 | POST | Get tag |
add-tag-v1 | POST | Create tag |
update-tag-v1 | POST | Update tag |
delete-tag-v1 | POST | Delete tag |
get-tag-sites-v1 | POST | Tag's sites |
get-tag-clients-v1 | POST | Tag's clients |
Batch (1 ability)
| Slug | Method | Description |
|---|---|---|
get-batch-job-status-v1 | POST | Check batch job status |