---
title: "Queue an explicit provider reply"
method: POST
path: "/renditions/{id}/reply"
tags: ["Publications"]
---

# Queue an explicit provider reply

`POST /renditions/{id}/reply`

## Request

- Base URL: `https://app.openpo.st/api/v1`
- URL: `https://app.openpo.st/api/v1/renditions/{id}/reply`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `openpost_session`

## Path parameters

- `id` string, required: Rendition ID

## Request body

- ReplyInputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `body` string, required: Reply body
  - `media` PublicationMediaInput[], nullable: Reply media
    - `alt_text` string: Alt text override
    - `media_id` string, required: Media attachment ID
    - `role` string: Media role: attachment, cover, thumbnail
    - `settings` object: Media-item settings
    - `thumbnail_timestamp_ms` integer: Video thumbnail timestamp
  - `parent_id` string: External comment or post ID to reply to
  - `run_at` string, date-time: Optional scheduled reply time
  - `settings` object: Provider-specific reply settings

## Response `200`

OK

- ActionOutputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `activation_publication_id` string
  - `job_id` string
  - `message` string, required
  - `publication_id` string
  - `renditions` RenditionActionOutcome[], nullable: Exact destination outcomes after this action
    - `delivery` ProviderDeliveryResponse
      - `current_attempt_created_at` string, required
      - `current_attempt_id` string, required
      - `current_attempt_number` integer, required
      - `error_code` string: Safe normalized provider failure code
      - `error_http_status` integer
      - `error_kind` string: Safe normalized provider failure class
      - `external_id` string
      - `external_url` string
      - `last_reconciled_at` string
      - `next_reconciliation_at` string
      - `recovery_action` 'none' | 'retry' | 'reconcile' | 'manual_resolution', required
      - `state` string, required
      - `target_key` string, required
      - `terminal_reason` string
    - `id` string, required
    - `platform` string, required
    - `social_account_id` string, required
    - `status` string, required
    - `target_key` string, required
  - `revision` integer
  - `workspace_activated` boolean

## Other responses

- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

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