Endpoint
Headers
Request body
Response
Success — new deployment (201)
Success — updated existing (200)
When a deployment with the samedeploymentId already exists:
Validation error (400)
Authentication error (401)
Organization mismatch (403)
WhenorganizationSlug in the payload does not match the key’s organization:
Behavior
Idempotency
ThedeploymentId field is the idempotency key. Sending the same deploymentId twice updates the existing record rather than creating a duplicate. This is safe for retries.
PR linking
On successful production deployments, Periscope automatically links the deployment to merged PRs using thecommitSha and calculates lead time for each linked PR.