Skip to content
Skills Library
DevOps & cloud · Tool integration

pressable

/pressable

Manage Pressable WordPress hosting via API. Use when creating/cloning sites, managing backups, purging cache, updating PHP versions, managing plugins, checking site status, or any Pressable hosting operations.

Licence
MIT
Last repository change
31.08.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
41
Deprecation

No signals detected. Repository changed on 31.08.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Manage Pressable WordPress hosting via API. Use when creating/cloning sites, managing backups, purging cache, updating PHP versions, managing plugins, checking site status, or any Pressable hosting operations.

Original author description

Manage Pressable WordPress hosting via API. Use when creating/cloning sites, managing backups, purging cache, updating PHP versions, managing plugins, checking site status, or any Pressable hosting operations.

How it works

  1. Overview
  2. Setup
  3. API Reference
  4. SSH & WP-CLI
  5. GitHub Auto-Deploy
  6. Best Practices
  7. Quick Reference
Original SKILL.md headings · 414 lines, 1,391 words
SKILL.md preview
---
name: pressable
description: Manage Pressable WordPress hosting via API. Use when creating/cloning sites, managing backups, purging cache, updating PHP versions, managing plugins, checking site status, or any Pressable hosting operations.
---

# Pressable Hosting Skill

Manage WordPress sites on [Pressable](https://pressable.com) managed hosting.

## Overview

This skill covers:
- **API** — Site management, cache, backups, plugins, DNS
- **SSH/SFTP** — Command-line access, WP-CLI
- **Git Deploy** — Auto-deploy from GitHub on push

---

## Setup

### 1. Enable API Access

1. Log in to [my.pressable.com](https://my.pressable.com)
2. Navigate to **API Applications** → **Create New API Application**
3. Name your app and select permission levels:
   - **Read-only** — Safe for monitoring/reporting
   - **Full access** — Required for modifications
4. Save the **Client ID** and **Client Secret**

📚 [Pressable API Setup Guide](https://pressable.com/knowledgebase/connecting-to-the-pressable-api/)

### 2. Store Credentials Securely

Create a credentials file (keep outside of git repos):

```bash
mkdir -p ~/.credentials
chmod 700 ~/.credentials
```

```json
// ~/.credentials/pressable.json
{
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET"
}
```

```bash
chmod 600 ~/.credentials/pressable.json
```

**Agent configuration:** Reference as `{baseDir}/../../.credentials/pressable.json` (relative to workspace).

### 3. Set Up SSH Keys (Recommended)

SSH keys allow passwordless access to all your Pressable sites.

```bash
# Generate a dedicated key
ssh-keygen -t ed25519 -f ~/.credentials/pressable-ssh/id_ed25519 -C "pressable-agent"

# Secure permissions
chmod 700 ~/.credentials/pressable-ssh
chmod 600 ~/.credentials/pressable-ssh/id_ed25519
```

Add the **public key** to Pressable:
1. Go to [my.pressable.com](https://my.pressable.com) → **Profile** → **Settings** → **SSH Keys**
2. Paste contents of `~/.credentials/pressable-ssh/id_ed25519.pub`

Supported key types:
- `ssh-ed25519` (256 bit) — recommended
- `ecdsa-sha2-nistp256` (256 bit)
- `ssh-rsa` (2048–16384 bit)

📚 [Pressable SSH Key Setup](https://pressable.com/knowledgebase/how-to-create-ssh-keys/)

---

## API Reference

### Authentication

```bash
# Load credentials
CREDS=$(cat ~/.credentials/pressable.json)
CLIENT_ID=$(echo $CREDS | jq -r '.client_id')
CLIENT_SECRET=$(echo $CREDS | jq -r '.client_secret')

# Get access token (valid 1 hour)
TOKEN=$(curl -s --location 'https://my.pressable.com/auth/token' \
  --form "grant_type=\"client_credentials\"" \
  --form "client_id=\"$CLIENT_ID\"" \
  --form "client_secret=\"$CLIENT_SECRET\"" | jq -r '.access_token')

# Use in requests
curl -s -H "Authorization: Bearer $TOKEN" "https://my.pressable.com/v1/sites"
```

**Note:** Tokens expire after 1 hour. Refresh before expiry for long-running operations.

### Sites

```bash
# List all sites
curl -s -H "Authorization: Bearer $TOKEN" "https://my.pressable.com/v1/sites" | jq '.data'

# Get site details
curl -s -H "Authorization: Bearer $TOKEN" "https://my.pressable.com/v1/sites/{id}"

# Create site
curl -s -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  "https://my.pressable.com/v1/sites" \
  -d '{"name":"my-new-site","datacenter_code":"DFW"}'

# Clone site
curl -s -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  "https://my.pressable.com/v1/sites/{id}/clone" \
  -d '{"name":"cloned-site"}'

# Delete site
curl -s -X DELETE -H "Authorization: Bearer $TOKEN" "https://my.pressable.com/v1/sites/{id}"

# Update PHP version (8.2, 8.3, 8.4, 8.5)
curl -s -X PUT -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  "https://my.pressable.com/v1/sites/{id}" \
  -d '{"php_version":"8.3"}'
```

### Datacenters

| Code | Location |
|------|----------|
| AMS | Amsterdam |
| BUR | Burbank |
| DCA | Washington DC |
| DFW | Dallas |

### Edge Cache

```bash
# Get cache status
curl -s -H "Authorization: Bearer $TOKEN" "https://my.pressable.com/v1/sites/{id}/edge-cache"

# Toggle cache on/off
curl -s -X PUT -H "Authorization: Bearer $TOKEN" "https://my.pressable.com/v1/sites/{id}/edge-cache"

# Purge cache
curl -s -X DELETE -H "Authorization: Bearer $TOKEN" "https://my.pressable.com/v1/sites/{id}/edge-cache"

# Enable defensive mode (DDoS protection)
curl -s -X PUT -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  "https://my.pressable.com/v1/sites/{id}/edge-cache/defensive-mode" \
  -d '{"duration":"1-hour"}'
```

### On-Demand Backups

```bash
# List backups
curl -s -H "Authorization: Bearer $TOKEN" "https://my.pressable.com/v1/sites/{id}/ondemand-backups"

# Create backup (type: "fs" for filesystem, "db" for database)
curl -s -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  "https://my.pressable.com/v1/sites/{id}/ondemand-backups" \
  -d '{"backup_type":"db"}'

# Download backup
curl -s -H "Authorization: Bearer $TOKEN" \
  "https://my.pressable.com/v1/sites/{site_id}/ondemand-backups/{backup_id}/download"

# Delete backup
curl -s -X DELETE -H "Authorization: Bearer $TOKEN" \
  "https://my.pressable.com/v1/sites/{site_id}/ondemand-backups/{backup_id}"
```

**Limits:** 3 filesystem + 3 database backups max. Auto-deleted after 7–30 days.

### Plugins

```bash
# List plugins
curl -s -H "Authorization: Bearer $TOKEN" "https://my.pressable.com/v1/sites/{id}/plugins"

# Install & activate (from WordPress.org or URL)
curl -s -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  "https://my.pressable.com/v1/sites/{id}/plugins" \
  -d '{"plugins":[{"path":"jetpack"},{"path":"akismet","version":"5.1"}]}'

# Update plugins
curl -s -X PUT -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  "https://my.pressable.com/v1/sites/{id}/plugins" \
  -d '{"plugins":[{"path":"jetpack"}]}'

# Activate / Deactivate
curl -s -X PUT -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  "https://my.pressable.com/v1/sites/{id}/plugins/activate" \
  -d '{"plugins":[{"path":"jetpack"}]}'

curl -s -X PUT -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  "https://my.pressable.com/v1/sites/{id}/plugins/deactivate" \
  -d '{"plugins":[{"path":"jetpack"}]}'

# Delete
curl -s -X DELETE -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  "https://my.pressable.com/v1/sites/{id}/plugins" \
  -d '{"plugins":[{"path":"jetpack"}]}'
```

**Note:** Plugin operations are async. Use webhooks for completion status.

### DNS Zones

```bash
# List zones
curl -s -H "Authorization: Bearer $TOKEN" "https://my.pressable.com/v1/zones"

# Get zone records
curl -s -H "Authorization: Bearer $TOKEN" "https://my.pressable.com/v1/zones/{zone_id}/records"

# Create record
curl -s -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  "https://my.pressable.com/v1/zones/{zone_id}/records" \
  -d '{"type":"A","name":"www","value":"192.0.2.1","ttl":3600}'

# Delete record
curl -s -X DELETE -H "Authorization: Bearer $TOKEN" \
  "https://my.pressable.com/v1/zones/{zone_id}/records/{record_id}"
```

### Account & Collaborators

```bash
# Get account info
curl -s -H "Authorization: Bearer $TOKEN" "https://my.pressable.com/v1/account"

# Activity logs
curl -s -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  "https://my.pressable.com/v1/account/logs/activity" \
  -d '{"page":1,"per_page":20}'

# List collaborators
curl -s -H "Authorization: Bearer $TOKEN" "https://my.pressable.com/v1/collaborators"

# Add collaborator to sites
curl -s -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  "https://my.pressable.com/v1/collaborators/batch_create" \
  -d '{"email":"user@example.com","siteIds":[123,456],"roles":["wp_access","sftp_access"]}'
```

---

## SSH & WP-CLI

### SSH Access

Each Pressable site has unique SSH credentials. To connect:

1. Go to **Sites** → Select site → **Connections** tab
2. Find **SSH Username** and click **Reset** to generate password
3. Note the **SSH/SFTP URL** (format: `ssh.pressable.com`)

```bash
# Connect with password
ssh {ssh-username}@ssh.pressable.com

# Connect with SSH key (after adding to account)
ssh -i ~/.credentials/pressable-ssh/id_ed25519 {ssh-username}@ssh.pressable.com
```

**SSH Config (optional):** For easier access, add to `~/.ssh/config`:

```
Host pressable-mysite
  HostName ssh.pressable.com
  User {ssh-username}
  IdentityFile ~/.credentials/pressable-ssh/id_ed25519
  IdentitiesOnly yes
```

Then connect with: `ssh pressable-mysite`

📚 [Pressable SSH Guide](https://pressable.com/knowledgebase/connect-to-ssh-on-pressable/)

### WP-CLI Commands

WP-CLI is pre-installed. After connecting via SSH:

```bash
# List plugins
wp plugin list

# Deactivate a problem plugin
wp plugin deactivate plugin-name

# Activate a theme
wp theme activate theme-name

# View PHP errors
wp php-errors

# Skip themes/plugins (for broken sites)
wp --skip-plugins --skip-themes plugin deactivate plugin-name
```

📚 [Pressable WP-CLI Guide](https://pressable.com/knowledgebase/how-to-use-wp-cli/)

### WP-CLI via API

Run WP-CLI commands without SSH:

```bash
curl -s -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  "https://my.pressable.com/v1/sites/{id}/ssh/command" \
  -d '{"command":["plugin list --format=json"]}'
```

**Note:** Don't include `wp` prefix — it's added automatically. Use webhooks for async responses.

### SSH Limitations

- **Session time:** 8 hours max
- **Memory:** 1GB RAM per session
- **Processes:** 25 max concurrent
- **Connections:** 10 per site (across all users)
- **Background processes:** Killed on disconnect (even with `nohup`)
- **Root access:** Not available

---

## GitHub Auto-Deploy

Deploy changes automatically when you push to GitHub.

### Setup

1. **Prepare your repo:**
   ```
   your-repo/
   └── wp-content/
       ├── themes/
       ├── plugins/
       └── mu-plugins/
   ```

2. **Connect to Pressable:**
   - Go to **Sites** → Select site → **Git** tab
   - Paste your repo's **HTTPS URL** (from GitHub's "Code" button)
   - Click **Set Repository URL**
   - Click **Authorize** and log in to GitHub

3. **Select branch:**
   - Choose the branch to deploy (e.g., `main`)
   - Configure sync settings:
     - ✅ Sync themes / plugins / mu-plugins
     - ⚠️ Delete files not in repo (optional, use carefully)
   - Click **Set and Deploy**

### How It Works

1. Push changes to configured branch
2. GitHub sends webhook to Pressable
3. Pressable clones repo and rsyncs to `wp-content/`
4. Only themes, plugins, mu-plugins sync (not core or uploads)

📚 [Pressable Git Deploy Guide](https://pressable.com/knowledgebase/how-deploy-to-your-sites-using-git/)

### Troubleshooting

- **Private repos:** Must grant OAuth access to organization
- **Wrong branch:** Check Git tab settings
- **Files not syncing:** Ensure they're in `wp-content/{themes,plugins,mu-plugins}/`
- **Deployments failing:** Check GitHub History in Git tab

---

## Best Practices

### Security

- Store credentials in `~/.credentials/` with `600` permissions
- Use SSH keys instead of passwords when possible
- Create read-only API apps for monitoring/reporting
- Rotate API credentials periodically

### Operations

- **Always backup before destructive operations**
- Test on staging sites first
- Use webhooks for async operation status
- Cache API tokens (1hr validity) to reduce auth calls

### Agent Usage

When the agent uses this skill:
1. Load credentials from configured path
2. Get fresh token if expired
3. Look up site ID from name if needed
4. Execute operation
5. Verify result

---

## Quick Reference

| Task | Method |
|------|--------|
| List sites | `GET /v1/sites` |
| Purge cache | `DELETE /v1/sites/{id}/edge-cache` |
| Create backup | `POST /v1/sites/{id}/ondemand-backups` |
| Run WP-CLI | `POST /v1/sites/{id}/ssh/command` or SSH |
| Deploy from Git | Push to connected branch |

**API Base:** `https://my.pressable.com`
**SSH Host:** `ssh.pressable.com`
**Docs:** [my.pressable.com/documentation/api/v1](https://my.pressable.com/documentation/api/v1)

Versions

The database has no other skills named pressable.

Database snapshot: 13.11.2026 · package version 55f5d06d61c5 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100site-from-host
    Set up a local WordPress Studio site that mirrors a hosted Pressable or WordPress.com site — creates <siteurl>.local from the source site's domain, clones the given GitHub repo as wp-content, pulls that site's plugins and (optionally) its database with the team51 CLI, and…
  • 98wp-migration
    Migrate a WordPress site from local dev to live hosting, or sync content between environments. Use when the user asks to move, deploy or sync a WordPress site.
  • 90wordpress-maintenance-ops
    Use when maintaining a WordPress site: updates, health checks, backups, plugin and theme hygiene.
  • 100sites
    Manage existing xCloud sites — list/inspect sites, status, events, deployment logs, monitoring and uptime history, backups (including Docker app backups and schedules), rescue, snapshots, staging environments, domains & redirections, cache purge, SSH/SFTP config, site cron jobs,…
  • 100hostinger-hosting
    Use when managing websites on Hostinger hosting — hPanel navigation, WordPress staging environment, LiteSpeed Cache configuration, PHP version management, SSH access (port 65002), DNS zone editor, SSL/TLS certificates, email setup (IMAP/SMTP settings, SPF/DKIM/DMARC), backup and…
  • 100wordpress
    Publish and manage posts on a self-hosted WordPress site via the WordPress REST API. Use when the user mentions WordPress, wp-admin, publishing / updating a blog post, managing categories or tags, or uploading media to their own WordPress site.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.