A valid request URL is required to generate request examples{
"post": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"environment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"body": "<string>",
"status": "open",
"votes": 123,
"weight": {
"currency": "<string>",
"amount_minor": 123,
"paying_customers": 123,
"other_currency_customers": 123,
"free_customers": 123
},
"author_contact_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"merged_into_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_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"
}
}Write a feedback post
Requires feedback:write. For seeding the board, or for filing what somebody said in a call.
Always open, and there is no status on this body — a status is an answer your users read on a public board, so it is PUT /v1/organization/feedback/{id}/status, an act a client makes on purpose.
author_contact_id cannot be set. A post carrying somebody’s name that they did not write is a quote nobody said, on a page their colleagues read; a post written here is attributed to staff, and one of your users writing their own is POST /v1/contact/feedback.
A valid request URL is required to generate request examples{
"post": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"environment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"body": "<string>",
"status": "open",
"votes": 123,
"weight": {
"currency": "<string>",
"amount_minor": 123,
"paying_customers": 123,
"other_currency_customers": 123,
"free_customers": 123
},
"author_contact_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"merged_into_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_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"
}
}Authorizations
A staff session token, uk_st_…. Minted by sign-up, sign-in or the two-factor exchange. Only a 401 means it is spent; not_a_member (403) is about the organization named in X-Organization-Id and leaves the token good for the others.
Headers
The organization the caller is acting on — the org_… code that appears in the panel URL. It identifies; the membership JOIN is what authorizes, so a forged code reads nothing: the answer is not_a_member (403), which does not mean the session is over. Absent, the session's default organization answers, or — if that membership was revoked while the session was open — any other one the caller still holds.
Query Parameters
Which environment to act in. A view parameter, valid only on the staff surface — a machine credential never chooses its environment, it is resolved from the key.
live, test Body
Response
The post.
One thing somebody asked for. Written by one of your users or by your staff on their behalf, answered by a status, and folded into another post when it turns out to be a duplicate.
Show child attributes
Show child attributes