API ReferencePublisher Deployments

Withdraw a deployment

POST
/v1/publisher/deployments/{deployment_id}/withdraw

Removes an active private or public release. A pending public review is cancelled. Repeating this request returns the withdrawn deployment.

Authorization

bearerAuth
AuthorizationBearer <token>

Send a SimpleServe API key as Authorization: Bearer <key>.

In: header

Path Parameters

deployment_id*string

Agent deployment ID.

Match^dep_[A-Za-z0-9]+$

Header Parameters

Idempotency-Key?string

Prevents duplicate work and charges when a request is retried. Reusing a key with a different request returns 409 idempotency_conflict.

Length8 <= length <= 255

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/publisher/deployments/string/withdraw" \  -H "Idempotency-Key: 01JXYZ1234567890ABCDEF"
{  "id": "dep_01JXYZPUBLIC001",  "object": "agent.deployment",  "agent_id": "agent_01JXYZ1234567890",  "version_id": "aver_01JXYZVERSION02",  "visibility": "public",  "status": "withdrawn",  "review_feedback": [],  "created_at": "2026-08-30T15:00:00Z",  "activated_at": null}