Skip to content

API Endpoints Quick Reference

Fresh

REST API v2 — Base: /wp-json/mainwp/v2/

Sites

MethodEndpointDescription
GET/sitesList all sites
GET/sites/{id}Get site details
POST/sitesAdd new site
PUT/sites/{id}Update site
DELETE/sites/{id}Remove site
POST/sites/{id}/syncSync site
POST/sites/{id}/reconnectReconnect site
GET/sites/{id}/pluginsList site plugins
GET/sites/{id}/themesList site themes
POST/sites/{id}/plugins/installInstall plugin
POST/sites/{id}/plugins/activateActivate plugin
POST/sites/{id}/plugins/deactivateDeactivate plugin
POST/sites/{id}/plugins/deleteDelete plugin
POST/sites/{id}/themes/installInstall theme
POST/sites/{id}/themes/activateActivate theme
POST/sites/{id}/themes/deleteDelete theme
GET/sites/{id}/postsList site posts
GET/sites/{id}/pagesList site pages
GET/sites/{id}/usersList site users
POST/sites/{id}/users/importImport users (CSV)
GET/sites/{id}/securitySecurity scan
POST/sites/{id}/maintenanceToggle maintenance mode

Updates

MethodEndpointDescription
GET/updatesList all available updates
GET/updates/sites/{id}Site-specific updates
POST/updates/pluginsBulk update plugins
POST/updates/themesBulk update themes
POST/updates/coreUpdate WordPress core

Clients

MethodEndpointDescription
GET/clientsList clients
GET/clients/{id}Get client
POST/clientsCreate client
PUT/clients/{id}Update client
DELETE/clients/{id}Delete client

Tags

MethodEndpointDescription
GET/tagsList tags
POST/tagsCreate tag
PUT/tags/{id}Update tag
DELETE/tags/{id}Delete tag

Other Resources

MethodEndpointDescription
GET/monitoringUptime data
GET/extensionsExtension list
GET/settingsDashboard settings
GET/costsCost tracking data
POST/batchBatch operations
GET/api-keysList API keys
POST/api-keysCreate API key

Abilities API — Base: /wp-json/wp-abilities/v1/

Discovery

MethodEndpointDescription
GET/abilitiesList all abilities
GET/abilities?category=mainwp/sitesFilter by category
GET/abilities/{provider}/{slug}Get ability schema

Execution

MethodEndpointDescription
POST/abilities/{provider}/{slug}/runExecute ability

Sites (30 abilities)

SlugMethodDescription
list-sites-v1GETList sites with pagination
count-sites-v1GETTotal site count
get-site-v1POSTSingle site details
add-site-v1POSTConnect new site
remove-site-v1POSTRemove site (destructive)
sync-site-v1POSTSync single site
sync-sites-v1POSTSync multiple/all sites
reconnect-site-v1POSTReconnect single site
reconnect-sites-v1POSTReconnect multiple sites
disconnect-site-v1POSTDisconnect site
disconnect-sites-v1POSTDisconnect multiple sites
check-site-v1POSTHTTP health check
check-sites-v1POSTBulk health check
suspend-site-v1POSTSuspend site
suspend-sites-v1POSTSuspend multiple sites
unsuspend-site-v1POSTReactivate site
get-site-plugins-v1POSTList plugins
get-site-themes-v1POSTList themes
install-plugin-v1POSTInstall plugin
activate-plugin-v1POSTActivate plugin
deactivate-plugin-v1POSTDeactivate plugin
delete-plugin-v1POSTDelete plugin
install-theme-v1POSTInstall theme
activate-theme-v1POSTActivate theme
delete-theme-v1POSTDelete theme
get-site-posts-v1POSTList posts
get-site-pages-v1POSTList pages
get-site-users-v1POSTList users
get-site-categories-v1POSTList categories
get-site-options-v1POSTGet WP options

Updates (13 abilities)

SlugMethodDescription
list-updates-v1GETAll available updates
get-site-updates-v1POSTSingle site updates
list-ignored-updates-v1GETIgnored updates
run-updates-v1POSTUpdate multiple sites
update-site-core-v1POSTUpdate WP core
update-site-plugins-v1POSTUpdate plugins
update-site-themes-v1POSTUpdate themes
update-site-translations-v1POSTUpdate translations
update-all-v1POSTUpdate everything
set-ignored-updates-v1POSTManage ignore list
ignore-site-core-v1POSTIgnore core update
ignore-site-plugins-v1POSTIgnore plugin updates
ignore-site-themes-v1POSTIgnore theme updates

Clients (11 abilities)

SlugMethodDescription
list-clients-v1GETList clients
count-clients-v1GETCount clients
get-client-v1POSTGet client
add-client-v1POSTCreate client
update-client-v1POSTUpdate client
delete-client-v1POSTDelete client
get-client-sites-v1POSTClient's sites
count-client-sites-v1POSTCount client's sites
get-client-costs-v1POSTClient costs
suspend-client-v1POSTSuspend client
unsuspend-client-v1POSTUnsuspend client

Tags (7 abilities)

SlugMethodDescription
list-tags-v1GETList tags
get-tag-v1POSTGet tag
add-tag-v1POSTCreate tag
update-tag-v1POSTUpdate tag
delete-tag-v1POSTDelete tag
get-tag-sites-v1POSTTag's sites
get-tag-clients-v1POSTTag's clients

Batch (1 ability)

SlugMethodDescription
get-batch-job-status-v1POSTCheck batch job status