API ReferencePublisher Deployments
Submit the current draft for review
Creates an immutable version from the current draft and submits it for SimpleServe review. The current public version stays available until the submitted version is approved.
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/submit-public" \ -H "If-Match: "draft-12"" \ -H "Idempotency-Key: 01JXYZ1234567890ABCDEF"{ "id": "dep_01JXYZPUBLIC001", "object": "agent.deployment", "agent_id": "agent_01JXYZ1234567890", "version_id": "aver_01JXYZVERSION02", "visibility": "public", "status": "in_review", "review_feedback": [], "created_at": "2026-08-30T15:00:00Z", "activated_at": null}