1 Authentication

Always authenticate first to get a JWT token. The token expires in 7 days.

$creds = @{
    username = 'your-email@example.com'
    password = 'your-password'
}

$login = Invoke-RestMethod -Uri 'https://api.rocket.net/v1/login' `
    -Method Post `
    -Body ($creds | ConvertTo-Json) `
    -ContentType 'application/json'

$token = $login.token
$headers = @{
    Authorization = "Bearer $token"
    'Content-Type' = 'application/json'
}

Important: If you get 401 errors, re-authenticate to get a fresh token.

2 List All Sites (with Pagination)

Rocket.net accounts can have 100+ sites. Always paginate to get all sites.

$allSites = @()
$page = 1

do {
    $response = Invoke-RestMethod `
        -Uri "https://api.rocket.net/v1/sites?page=$page&page_size=100" `
        -Method Get `
        -Headers $headers
    
    $allSites += $response.result
    $page++
} while ($response.result.Count -eq 100)

Write-Host "Total sites: $($allSites.Count)"

3 Check Plugins on a Site

Use the Plugins API endpoint to see what WordPress knows about.

# Find site by domain
$site = $allSites | Where-Object {
    $_.domain -match 'example.com'
}

# List all plugins
$plugins = Invoke-RestMethod `
    -Uri "https://api.rocket.net/v1/sites/$($site.id)/plugins" `
    -Method Get `
    -Headers $headers

# Check for specific plugin
$mlPlugins = $plugins.result | Where-Object {
    $_.name -like '*ml-plugin-manager*'
}

if ($mlPlugins) {
    $mlPlugins | ForEach-Object {
        Write-Host "Found: $($_.name)"
        Write-Host "  Status: $($_.status)"
        Write-Host "  Version: $($_.version)"
    }
}

Plugin Object Properties:

• name - Plugin display name (e.g., "ml-plugin-manager-3.0.19")
• status - "active" or "inactive"
• version - Version number
• slug - Plugin slug (may be empty)

4 Delete a Plugin

Use DELETE with the exact plugin name from the list.

$deleteBody = @{
    plugins = "ml-plugin-manager-3.0.19"
} | ConvertTo-Json

Invoke-RestMethod `
    -Uri "https://api.rocket.net/v1/sites/$($site.id)/plugins" `
    -Method Delete `
    -Headers $headers `
    -Body $deleteBody

Write-Host "Deleted: ml-plugin-manager-3.0.19"

Notes:

• Use the exact name from the plugin list (not slug)
• For multiple plugins: "plugins": "plugin1,plugin2,plugin3" (comma-separated)

5 Install a Plugin

Method A: Install from URL (Recommended for custom plugins)

$installBody = @{
    custom_url = "https://example.com/plugin.zip"
    activate = $true
} | ConvertTo-Json

Invoke-RestMethod `
    -Uri "https://api.rocket.net/v1/sites/$($site.id)/plugins" `
    -Method Post `
    -Headers $headers `
    -Body $installBody

Method B: Install from WordPress.org

$installBody = @{
    plugins = "plugin-slug"
    activate = $true
} | ConvertTo-Json

Invoke-RestMethod `
    -Uri "https://api.rocket.net/v1/sites/$($site.id)/plugins" `
    -Method Post `
    -Headers $headers `
    -Body $installBody

6 Activate/Deactivate a Plugin

# Activate
$activateBody = @{
    plugin = "ml-plugin-manager/ml-plugin-manager.php"
    status = "activate"
} | ConvertTo-Json

Invoke-RestMethod `
    -Uri "https://api.rocket.net/v1/sites/$($site.id)/plugins" `
    -Method Patch `
    -Headers $headers `
    -Body $activateBody

# Deactivate
$deactivateBody = @{
    plugin = "ml-plugin-manager/ml-plugin-manager.php"
    status = "deactivate"
} | ConvertTo-Json

Invoke-RestMethod `
    -Uri "https://api.rocket.net/v1/sites/$($site.id)/plugins" `
    -Method Patch `
    -Headers $headers `
    -Body $deactivateBody