---
title: "Ingest private product update drafts"
method: POST
path: "/marketing/product_updates/ingestions"
tags: ["marketing"]
---

# Ingest private product update drafts

`POST /marketing/product_updates/ingestions`

## Request

- Base URL: `https://api.stablesea.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stablesea.com/marketing/product_updates/ingestions`
- Auth: HTTP productupdates

## Request body

- ProductupdatesIngestHTTPInput
  - `check_evidence` ProductupdatesCheckEvidence
    - `context_source` 'source_declared', required
    - `definition_sha` string, required
    - `observations` ProductupdatesCheckObservation[], nullable, required
      - `app_key` string
      - `completed_ts` string, date-time, nullable
      - `conclusion` string, nullable
      - `context` string, required
      - `created_ts` string, date-time, nullable
      - `kind` 'check_run' | 'commit_status', required
      - `record_key` string, required
      - `started_ts` string, date-time, nullable
      - `state` 'queued' | 'in_progress' | 'completed' | 'waiting' | 'requested' | 'pending' | 'error' | 'failure' | 'success', required
      - `suite_key` string
      - `updated_ts` string, date-time, nullable
    - `observed_ts` string, date-time, required
    - `release_sha` string, required
    - `required_contexts` string[], nullable, required
    - `schema_version` integer, required
  - `drafts` ProductupdatesIngestDraft[], nullable
    - `body` string, required
    - `source_key` string, required
    - `source_keys` string[], nullable
    - `title` string, required
  - `release_event_key` string, required
  - `release_evidence` ProductupdatesReleaseEvidence
    - `approval` ProductupdatesApprovalEvidence, required
      - `expires_ts` string, date-time, required
      - `github_login` string, required
      - `method` 'signed_slack', required
      - `release_sha` string, required
      - `slack_key` string, required
      - `validator_sha` string, required
      - `verified_ts` string, date-time, required
    - `captured_ts` string, date-time, required
    - `deployment` ProductupdatesDeployEvidence, required
      - `backend_landed` 'success', required
      - `deployment_key` string, required
      - `edge` 'success' | 'not_configured', required
      - `post_deploy` 'success', required
      - `post_verify` ProductupdatesHTTPReleaseEvidence, required
        - `ended_ts` string, date-time, required
        - `http_status` integer, required
        - `outcome` 'success' | 'rejected' | 'error' | 'canceled' | 'aborted', required
        - `release_sha` string, required
        - `request_key` string, required
        - `span_key` string, required
        - `started_ts` string, date-time, required
        - `trace_key` string, required
      - `released_ts` string, date-time, required
      - `smoke` 'success', required
      - `status_key` string, required
    - `image` ProductupdatesImageEvidence, required
      - `builder` string, required
      - `digest` string, required
      - `release_sha` string, required
      - `signing_profile` 'github_keyless' | 'breakglass_kms', required
      - `validator_sha` string, required
      - `verified_ts` string, date-time, required
    - `release_event_key` string, required
    - `release_sha` string, required
    - `sandbox` ProductupdatesSandboxEvidence, required
      - `deploy_run_verified` boolean, required
      - `deployment_key` string, required
      - `release_sha` string, required
      - `status_key` string, required
      - `validator_sha` string, required
      - `verified_ts` string, date-time, required
    - `schema_version` integer, required
    - `staging` ProductupdatesStagingEvidence, required
      - `check_names` string[], nullable
      - `digest` string
      - `mode` 'digest_match' | 'armed_sha' | 'recorded_sha', required
      - `parameter_key` string, required
      - `release_sha` string, required
      - `validator_sha` string, required
      - `verified_ts` string, date-time, required
    - `workflow_sha` string, required
  - `release_sha` string
  - `released_ts` string, date-time, required
  - `removed_source_keys` string[], nullable
  - `schema_version` integer

## Response `200`

OK

- ProductupdatesIngestOutput
  - `accepted` boolean, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `409`: Conflict
- `503`: Service Unavailable
- `default`: Error response.

## Changes

- **2026-11-18** `2c46cafab451`: 5 info
  - added the optional property `error/errors/items/field_id` to the response with the `400` status
  - added the optional property `error/errors/items/field_id` to the response with the `401` status
  - added the optional property `error/errors/items/field_id` to the response with the `409` status
  - added the optional property `error/errors/items/field_id` to the response with the `503` status
  - …1 more
- **2026-11-13** `22a5c470b8c2`: 2 info
  - added the new optional request property `check_evidence`
  - added the new optional request property `release_evidence`
- **2026-11-12** `225234008c8d`: 5 warning
  - removed the request property `drafts/items/availability_note`
  - removed the request property `drafts/items/category`
  - removed the request property `drafts/items/documentation_url`
  - removed the request property `drafts/items/evidence`
  - …1 more
- **2026-11-11** `4a2af31868db`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/stablesea/apis/stable-sea-backend/changes/marketing/product_updates/ingestions/post.md)

---

[API](https://skmtc.dev/stablesea/apis/stable-sea-backend.md) - [All operations](https://skmtc.dev/stablesea/apis/stable-sea-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/stablesea/apis/stable-sea-backend/revisions/d500507aaa96?raw)
