Support

Ask authenticated posterly Support AI

Ask posterly Support AI a docs-backed question with read-only account/post diagnostics for the caller workspace. This is not a public endpoint: API-key callers need posts:read and accounts:read scopes, and hosted/Web MCP callers must be authenticated. Human tickets are never opened on the first answer; ticket creation requires a follow-up in a continued conversation that already has an assistant answer, plus request_human: true and confirm_escalation: true after explicit user confirmation.

post/api/v1/support/chat

Request

  • Base URL: https://www.poster.ly
  • URL: https://www.poster.ly/api/v1/support/chat
  • Auth: HTTP bearer

Request body

OR

Response

Support answer generated successfully

successboolean required
workspace_idstring required
confidencenumber
docs_confidence'high' | 'medium' | 'low'
needs_humanboolean
escalation_reasonstring nullable
modelobject

Example response

{
  "success": true,
  "workspace_id": "workspace_123",
  "conversation": {
    "id": "support_conversation_123",
    "status": "open",
    "title": "Post failure"
  },
  "message": {
    "id": "support_message_123",
    "role": "assistant",
    "content": "Post 3041 failed because the connected account token has expired. Reconnect the account, then retry the post.",
    "citations": [],
    "created_at": "2026-06-06T11:39:04.000Z"
  },
  "support_access": {
    "can_use_human_support": true,
    "confirmation_required": false,
    "ticket_created": false
  },
  "confidence": 0.86,
  "docs_confidence": "medium",
  "needs_human": false
}

Changes

No recorded changes to this operation across all 1 revision of this API.