---
title: "Collect private candidates for the current or a historical week"
method: POST
path: "/marketing/product_updates/weekly_candidates"
tags: ["marketing"]
---

# Collect private candidates for the current or a historical week

`POST /marketing/product_updates/weekly_candidates`

## 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/weekly_candidates`
- Auth: HTTP productupdates

## Request body

- ProductupdatesWeeklyCandidatesHTTPInput
  - `schema_version` integer, required
  - `week_start` string: Los Angeles Monday YYYY-MM-DD; omitted selects the current week. Future weeks are refused.

## Response `200`

OK

- ProductupdatesWeeklyCandidatesOutput
  - `data` ProductupdatesCandidate[], nullable, required
    - `body` string, required
    - `released_ts` string, date-time, required
    - `source_keys` string[], nullable, required
    - `title` string, required
  - `entry` ProductupdatesEntry
    - `approved_by` string
    - `approved_ts` string, date-time, nullable
    - `availability_note` string
    - `body` string, required
    - `category` string
    - `content_hash` string
    - `documentation_url` string
    - `id` string
    - `pending_proposal` ProductupdatesContent
      - `body` string, required
      - `title` string, required
    - `pending_proposal_hash` string
    - `published_ts` string, date-time, nullable
    - `released_ts` string, date-time
    - `requires_save` boolean
    - `revision` integer
    - `rollback_invalidated` boolean
    - `state` 'draft' | 'approved' | 'published' | 'needs_correction'
    - `title` string, required
    - `updated_ts` string, date-time, nullable
    - `week_start` string
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required
  - `snapshot_hash` string, required
  - `total_count` integer, nullable
  - `week_end` string, required
  - `week_start` string, required

## Other responses

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

## Changes

- **2026-11-18** `2c46cafab451`: 4 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 `503` status
  - added the optional property `error/errors/items/field_id` to the response with the `default` status
- **2026-11-12** `225234008c8d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/stablesea/apis/stable-sea-backend/changes/marketing/product_updates/weekly_candidates/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)
