---
title: "Queue engagement and message collection"
method: POST
path: "/engagement-and-messaging/refresh"
tags: ["Capabilities"]
---

# Queue engagement and message collection

`POST /engagement-and-messaging/refresh`

## Request

- Base URL: `https://app.openpo.st/api/v1`
- URL: `https://app.openpo.st/api/v1/engagement-and-messaging/refresh`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `openpost_session`

## Request body

- RefreshCapabilitiesInputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `workspace_id` string, required

## Response `200`

OK

- RefreshCapabilitiesResult
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `engagement` RefreshCapabilityOutcome, required
    - `$schema` string, uri: A URL to the JSON Schema for this object.
    - `error_code` string
    - `queued` integer, required
    - `status` 'queued' | 'failed' | 'unavailable', required
  - `messaging` RefreshCapabilityOutcome, required
    - `$schema` string, uri: A URL to the JSON Schema for this object.
    - `error_code` string
    - `queued` integer, required
    - `status` 'queued' | 'failed' | 'unavailable', required

## Other responses

- `default`: 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)