Analytics apiFeedback

Log Feedback

Copy page

Logs new feedback or updates an existing one.

API Key Types: WEB, API

POST
/feedback
AuthorizationBearer <token>

The API key for an API integration. For more details, see authentication documentation

In: header

Note: The maximum size of the request body is 2 MB.

id?string
typestring
Value in"positive" | "negative"
messageIdstring
createdAt?string | null

A timestamp in ISO 8601 format with timezone information. If not provided, the current time will be used.

Formatdate-time
updatedAt?string | null

A timestamp in ISO 8601 format with timezone information. If not provided, the current time will be used.

Formatdate-time
reasons?array<object> | null
detailsstring
properties?object | null

A customizable collection of custom properties or attributes.

Empty Object

userProperties?object | null

A customizable collection of custom properties or attributes. Some properties have first class support for the Inkeep Portal or Widget and are noted in the description.

sources?array<object> | null

Response Body

curl -X POST "https://api.analytics.inkeep.com/feedback" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "positive",
    "messageId": "string",
    "details": "string"
  }'
{
  "id": "string",
  "type": "positive",
  "messageId": "string",
  "createdAt": "string",
  "updatedAt": "string",
  "reasons": [
    {
      "label": "string",
      "details": "string"
    }
  ],
  "details": "string",
  "properties": {},
  "userProperties": {
    "id": "string",
    "identificationType": "COOKIED",
    "userId": "string",
    "supportAgentName": "string",
    "userType": "string"
  },
  "sources": [
    {
      "type": "positive",
      "title": "string",
      "url": "string"
    }
  ]
}
{
  "title": "Bad Request",
  "status": 400,
  "detail": "Bad Request",
  "instance": "/conversations/123",
  "requestId": "req_1234567890",
  "code": "bad_request",
  "error": {
    "code": "bad_request",
    "message": "Bad Request"
  }
}
{
  "title": "Unauthorized",
  "status": 401,
  "detail": "Unauthorized",
  "instance": "/conversations/123",
  "requestId": "req_1234567890",
  "code": "unauthorized",
  "error": {
    "code": "unauthorized",
    "message": "Unauthorized"
  }
}
{
  "title": "Forbidden",
  "status": 403,
  "detail": "Forbidden",
  "instance": "/conversations/123",
  "requestId": "req_1234567890",
  "code": "forbidden",
  "error": {
    "code": "forbidden",
    "message": "Forbidden"
  }
}
{
  "title": "Unprocessable Entity",
  "status": 422,
  "detail": "Unprocessable Entity",
  "instance": "/conversations/123",
  "requestId": "req_1234567890",
  "code": "unprocessable_entity",
  "error": {
    "code": "unprocessable_entity",
    "message": "Unprocessable Entity"
  }
}
{
  "title": "Internal Server Error",
  "status": 500,
  "detail": "Internal Server Error",
  "instance": "/conversations/123",
  "requestId": "req_1234567890",
  "code": "internal_server_error",
  "error": {
    "code": "internal_server_error",
    "message": "Internal Server Error"
  }
}