Operations

Submit private agent workflow feedback

Store a bounded private operational feedback event after a concrete posterly workflow outcome. Requires a bearer API key with posts:write and active API add-on access; browser-session fallback is rejected. Limited to 60 events/hour per API key. Do not include API keys, prompts, captions, media URLs, personal data, or arbitrary metadata. Events are private service-role telemetry retained for 180 days.

post/api/v1/agent-feedback

Request

Base URL: https://www.poster.ly
URL: https://www.poster.ly/api/v1/agent-feedback
Auth: HTTP bearer

Request body

source'mcp' | 'cli' | 'rest' | 'skill' required

toolstring required

outcome'success' | 'error' | 'abandoned' required

error_codestring

clientstring

commentstring

Optional bounded operational note. Never include API keys, prompts, captions, media URLs, or personal data.

Example request

{
  "source": "mcp",
  "tool": "create_post",
  "outcome": "error",
  "error_code": "invalid_media_url",
  "client": "example-agent",
  "comment": "The media URL had expired.",
  "context": {
    "request_id": "req_example123",
    "http_status": 400,
    "latency_ms": 812,
    "attempt": 1
  }
}

Response

Feedback accepted

acceptedtrue required

feedback_idstring uuid required

request_idstring required

Example response

{
  "accepted": true,
  "feedback_id": "708bd269-7067-4c72-9916-4abde7199287",
  "request_id": "req_example123"
}

Changes

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