Create a Post - Suggix Help Center

`POST /posts`

Creates a feedback post in the API key’s workspace. The post creator is the workspace member who created the key. The response includes the created post with its board, creator, owner, and status details.

Headers

Header	Value
`Authorization`	`Bearer sgx_api_your_key` (or send the key in `X-API-Key`)
`Content-Type`	`application/json`

Request body

Field	Type	Required	Description
`board_id`	integer	Yes	ID of the destination board in the same workspace.
`title`	string	Yes	Post title, 1 to 255 characters.
`text`	string	No	Markdown content. It is converted to Suggix’s rich text format.
`owner_id`	integer	No	User ID to assign as the post owner.
`due_date`	integer	No	Due date as a Unix timestamp in milliseconds.
`status_id`	integer	No	ID of a status in the workspace.
`priority`	integer	No	`1` Low, `2` Medium, `3` High, or `4` Urgent.
`tags`	integer array	No	Tag IDs to associate with the post.

Request

POST https://www.suggix.com/v1/posts
Authorization: Bearer sgx_api_your_key
Content-Type: application/json

{
  "board_id": 10,
  "title": "Add keyboard shortcuts",
  "text": "## Why this helps\n\nIt would make common actions faster.",
  "priority": 2,
  "tags": []
}

Successful response

201 Created returns a post object. See New Posts response fields for the field descriptions.

{
  "id": 367,
  "workspace_id": 7,
  "board_id": 10,
  "board_name": "Feature Request",
  "board_url": "feature-request",
  "creator_id": 14,
  "creator_name": "Alex",
  "title": "Add keyboard shortcuts",
  "url": "add-keyboard-shortcuts",
  "text": "{\"time\":1791609328716,\"blocks\":[...],\"version\":\"2.31.6\"}",
  "html": "<div class=\"ce-block\">...</div>",
  "preview": "Why this helps\n\nIt would make common actions faster.",
  "is_pinned": false,
  "is_spam": false,
  "comments": 0,
  "votes": 1,
  "views": 0,
  "status_id": null,
  "priority": 2,
  "tags": [],
  "voted": true,
  "created_at": 1791609328722,
  "updated_at": 1791609328722
}

Errors

HTTP status	Response	Cause
`400`	`{"error":"invalid request body"}`	The body is not valid JSON.
`400`	`{"error":"invalid title"}`	The title is empty or longer than 255 characters.
`400`	`{"error":"board not found"}`	The board does not exist in the API key’s workspace.
`400`	`{"error":"..."}`	Another field or business rule is invalid; `error` contains the reason.
`401`	`{"error":"invalid or missing API key"}`	The API key is absent or invalid.