API ReferencePublisher Deployments
Deploy the current draft privately
Creates an immutable version from the current draft and makes it available only inside the publisher Workspace.
Authorization
bearerAuth AuthorizationBearer <token>
Send a SimpleServe API key as Authorization: Bearer <key>.
In: header
Path Parameters
agent_id*string
Publisher-owned agent ID.
Match
^agent_[A-Za-z0-9]+$Header Parameters
If-Match*string
ETag from the latest draft response.
Match
^"draft-[1-9][0-9]*"$Idempotency-Key?string
Prevents duplicate work and charges when a request is retried. Reusing
a key with a different request returns 409 idempotency_conflict.
Length
8 <= length <= 255Response 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/v1/publisher/agents/string/deploy-private" \ -H "If-Match: "draft-12"" \ -H "Idempotency-Key: 01JXYZ1234567890ABCDEF"{ "id": "dep_01JXYZPRIVATE01", "object": "agent.deployment", "agent_id": "agent_01JXYZ1234567890", "version_id": "aver_01JXYZVERSION01", "visibility": "private", "status": "active", "review_feedback": [], "created_at": "2026-08-30T14:00:00Z", "activated_at": "2026-08-30T14:00:00Z"}