P

Engage

Suggest Engage reply

AI draft only — never posts. Prefer commentUrn so the live comment/post text is loaded.

POST/api/public/engage/comments/suggest
cURLPOST /api/public/engage/comments/suggest
curl -X POST https://postiv.ai/api/public/engage/comments/suggest \
  -H "Authorization: Bearer pk_postiv_..." \
  -H "Content-Type: application/json" \
  -d '{}'
200Response
{
  "success": true,
  "suggestion": "Thanks — glad it resonated.",
  "tone": "professional"
}

Authorization

Requires an organization API key with the engage:write scope, sent as Authorization: Bearer or x-api-key.

Body parameters

commentUrnstring

Preferred: loads live comment + post text.

commentTextstring

Required if commentUrn omitted.

postTextstring

Optional post context override.

tonestring

professional | friendly | casual.

customPromptstring

Optional reply instructions, including phrases to avoid. Falls back to the selected reply profile’s saved Engage instructions. Pass an empty string to ignore saved instructions for this suggestion.

Response

Suggested reply text.

Errors

404comment_not_found

Good to know

  • REST contract unchanged. MCP uses list_engagement_posts/get_post_comments and shared comment, reply, reaction, dismissal and deletion tools; obtain opaque postId values through MCP discovery.