---
title: "Record a trusted CI deploy"
method: POST
path: "/v1/deploys/"
tags: ["Deploys", "Automation"]
---

# Record a trusted CI deploy

`POST /v1/deploys/`

## Request

- Base URL: `https://api.agentry.sh`
- URL: `https://api.agentry.sh/v1/deploys/`
- Auth: HTTP bearer

Record one deploy after a real successful deploy from CI, a provider deploy hook, or a release script using AGENTRY_CI_API_KEY. A deploy bound to an automation run must include both automation_run_id and source_commit_sha and must match the immutable CI PR proof. Do not call this from app startup, instrumentation/register/bootstrap hooks, cron routes, workers, request handlers, browser/client code, or product flows.

## Headers

- `Idempotency-Key` string, required

## Request body

- DeployIngestRequest
  - `sha` string, required
  - `branch` string
  - `environment` string
  - `message` string
  - `url` string
  - `actor` string
  - `automation_run_id` string
  - `source_commit_sha` string

## Response `200`

OK

- DeployAcceptedResponse
  - `data_boundary` object
  - `content_inspection` object
  - `id` string, required
  - `project_id` string, required
  - `sha` string, required
  - `automation_run_id` string, nullable
  - `source_commit_sha` string, nullable
  - `received_at` integer, required
  - `idempotent_replay` boolean, required
  - `provenance` object
    - `trust_level` 'trusted_ci', required
    - `credential_kind` 'ci_deploy', required
    - `credential_id` string, required
  - `next_action` string

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/agentry/apis/agentry-api.md) · [All operations](https://skmtc.dev/agentry/apis/agentry-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentry/apis/agentry-api/revisions/abdecddf009f?raw)