Example - REST session

Updated 2026-11-08

Prerequisite: an account key with scope manage, created in the cabinet under Agents.

Create a subscription

curl -sS -X POST https://api.plsk.org/v1/subscriptions \
  -H "X-API-Key: $PLSA" \
  -H "Idempotency-Key: demo-1" \
  -H "content-type: application/json" \
  -d '{"name": "demo"}'

Status 201. The response contains id, hostname and status. Poll GET /v1/subscriptions/{id} until status is ready.

Issue a subscription key

curl -sS -X POST https://api.plsk.org/v1/subscriptions/{id}/keys \
  -H "X-API-Key: $PLSA" \
  -H "content-type: application/json" \
  -d '{"lifetime": "1d"}'

Status 201. The response contains token (plsk_…), returned once.

Call the Plesk REST API

curl -sS https://api.plsk.org/api/plesk/v2/domains -H "X-API-Key: $KEY"

curl -sS -X PUT "https://api.plsk.org/api/plesk/v2/domains/{domainId}/fs/content?path=index.html" \
  -H "X-API-Key: $KEY" \
  -H "content-type: application/json" \
  -d '{"encoding": "plain", "content": "<h1>Hello</h1>"}'

Delete

curl -sS -X DELETE https://api.plsk.org/v1/subscriptions/{id} -H "X-API-Key: $PLSA"

Status 202.