A valid request URL is required to generate request examples{
"post": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"body": "<string>",
"status": "<string>",
"votes": 123,
"voted": true,
"created_at": "2023-11-07T05:31:56Z"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}Ask for something
One of your users writing a feature request. It lands as open and appears on the public board immediately — there is no review step, and what makes that tolerable is the gate rather than a queue: it takes a session whose identity was proven, an inbox somebody actually holds, and it is bounded to 10 posts per contact per day beside the route’s own per-IP limit.
An anonymous session is refused (403 identity_required), which is the one place this API refuses one after the verified gate let it through. A visitor’s session is minted per page load, so a board anybody could write to without holding an inbox has a per-person ceiling that costs nothing to reset.
Publishes feedback_post.created to your webhooks, carrying the title, the body and author_contact_id — your own identifier for your own user, so the request can be joined to the account it came from. Never an address.
body is stored and served as plain text.
A valid request URL is required to generate request examples{
"post": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"body": "<string>",
"status": "<string>",
"votes": 123,
"voted": true,
"created_at": "2023-11-07T05:31:56Z"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}Authorizations
A contact session token, uk_ct_…. Belongs to one of the developer's own users, and reads only that user's data.
Body
Response
The post, in the projection every other reader gets — the person who wrote it learns no more about it than anybody else.
Show child attributes
Show child attributes