PricingDocsCompareGuidesBlog
API referenceConnections

Change the Cloudflare data plane

POST/connections/{id}/data-plane

Dashboard only, Cloudflare connections. Upgrades, redeploys, rolls back or rotates the keys of what Stamp0 deployed in your Cloudflare account, with a setup token Stamp0 holds sealed for at most an hour. One change runs at a time.

Authorization

apiKey
AuthorizationBearer <token>

A project API key: Authorization: Bearer s0_…

In: header

Path Parameters

id*string
Length1 <= length <= 64

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/connections/string/data-plane" \  -H "Content-Type: application/json" \  -d '{    "action": "upgrade",    "setup_token": "string"  }'
{  "object": "data_plane_change",  "connection_id": "string",  "action": "deploy",  "status": "queued",  "setup_session_expires_at": "2019-08-24T14:15:22Z"}

Replace the Cloudflare API token PUT

Dashboard only, Cloudflare connections. Checks the runtime token (every permission it needs, and that it cannot upload a Worker) before it replaces the stored one, then re-verifies the connection. Returns the checklist.

Unpin the Cloudflare data plane DELETE

Dashboard only (owners and admins), Cloudflare connections. Removes the pin; nothing is deployed.