Posts

Update a post

Updates an existing post. Only provided fields will be modified.

PATCH

/v2/posts/{id}

Update a post

curl --request PATCH \
  --url https://do.featurebase.app/v2/posts/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Featurebase-Version: 2026-08-19.orbit' \
  --header 'Content-Type: application/json' \
  --data '
{
  "assigneeId": "507f1f77bcf86cd799439013",
  "author": {
    "email": "john@example.com",
    "id": "507f1f77bcf86cd799439011",
    "name": "John Doe",
    "profilePicture": "https://example.com/avatar.png",
    "userId": "usr_12345"
  },
  "boardId": "507f1f77bcf86cd799439011",
  "commentsEnabled": true,
  "content": "<p>Updated content with more details.</p>",
  "createdAt": "2025-01-15T10:30:00.000Z",
  "customFields": {
    "507f1f77bcf86cd799439011": "high",
    "507f1f77bcf86cd799439012": 5
  },
  "eta": "2025-12-31T23:59:59.000Z",
  "inReview": false,
  "sendStatusUpdateEmail": false,
  "statusId": "507f1f77bcf86cd799439012",
  "tags": [
    "feature",
    "ui"
  ],
  "title": "Updated: Add dark mode support",
  "upvotes": 10,
  "visibility": "public"
}
'

{
  "access": {
    "companyExternalIds": [],
    "userIds": []
  },
  "anchor": {
    "commentId": "<string>",
    "conversationId": "<string>",
    "messageId": "<string>",
    "ranges": [
      {
        "end": 123,
        "start": 123
      }
    ],
    "sourceRecordId": "<string>",
    "submissionId": "<string>"
  },
  "assigneeId": "507f1f77bcf86cd799439013",
  "author": {
    "email": "john@example.com",
    "id": "507f1f77bcf86cd799439011",
    "name": "John Doe",
    "profilePicture": "https://cdn.example.com/avatars/john.png",
    "type": "customer"
  },
  "boardId": "507f1f77bcf86cd799439011",
  "commentCount": 5,
  "content": "<p>It would be great to have a dark mode option for the dashboard.</p>",
  "createdAt": "2023-12-12T00:00:00.000Z",
  "customFields": {
    "cf_effort": 3,
    "cf_priority": "high"
  },
  "deduped": true,
  "eta": "2025-01-01T00:00:00.000Z",
  "features": {
    "commentsEnabled": true
  },
  "groupKey": null,
  "id": "507f1f77bcf86cd799439011",
  "inReview": false,
  "insightSource": {
    "capturedBy": "manual",
    "channel": "slack",
    "conversationId": "<string>",
    "externalId": "<string>",
    "sourceLabel": "<string>",
    "url": "<string>"
  },
  "intakeMode": "request",
  "integrations": {
    "clickup": [
      {
        "id": "86a1b2c3d",
        "title": "Add dark mode support",
        "url": "https://app.clickup.com/t/86a1b2c3d"
      }
    ],
    "devops": [
      {
        "id": 1234,
        "projectId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "projectName": "My Project",
        "title": "Add dark mode support",
        "url": "https://dev.azure.com/org/project/_workitems/edit/1234"
      }
    ],
    "github": [
      {
        "id": "1234567890",
        "number": "42",
        "repositoryFullName": "acme/backend",
        "repositoryName": "backend",
        "title": "Add dark mode support",
        "url": "https://github.com/acme/backend/issues/42"
      }
    ],
    "hubspot": [
      {

Updatable Fields

title - Post title (minimum 2 characters)
content - Post content in HTML format
boardId - Move post to a different board
statusId - Update post status
tags - Replace existing tags with new set
commentsEnabled - Enable/disable comments
inReview - Put post in/out of moderation queue
customFields - Update custom field values
eta - Set estimated completion date (null to clear)
createdAt - Update creation date (for backdating)
assigneeId - Admin ID to assign this post to (null to unassign)
visibility - Post-level restriction: 'public', 'authorOnly' (author and admins) or 'companyOnly' (the author's company). Board and organization access controls still apply.
author - Change post attribution (id, userId, email, name, profilePicture)

Status Update Notifications

sendStatusUpdateEmail - When changing status, optionally send email notification to voters (default: false)

Response

Returns the updated post object with all fields populated.

Autorizaciones

Authorizationstringheaderobligatorio

API key as Bearer token. Use: Authorization: Bearer sk_...

Parámetros de ruta

idstringobligatorio

Post unique identifier

Ejemplo: 507f1f77bcf86cd799439011

Encabezados

Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Opciones disponibles: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover

Ejemplo: 2026-08-19.orbit

Cuerpo

assigneeIdstring | null

Admin ID to assign this post to (null to unassign)

Ejemplo: 507f1f77bcf86cd799439013

authorobject

Author to attribute the post to. If not provided, uses the authenticated user — unless source is given, in which case a guest author is synthesised from source.label (or the channel name), because a relayed request belongs to the customer who said it. Supports multiple identification methods: id (Featurebase ID), userId (external SSO ID), or email.

Mostrar child attributes

boardIdstring

Board ID to move post to

Ejemplo: 507f1f77bcf86cd799439011

commentsEnabledboolean | null

Whether comments are enabled on this post

Ejemplo: true

contentstring

Post content (HTML)

Ejemplo: <p>Updated content with more details.</p>

createdAtstring | null

Creation date (for backdating)

Ejemplo: 2025-01-15T10:30:00.000Z

customFieldsobject

Custom field values keyed by field ID (ObjectId). Send each value in the form its field type takes: text: a string; number: a number or a numeric string ("5"); checkbox: true/false or "true"/"false"; date: an ISO 8601 string; select: an option label or id; multi-select: an option label or id, or an array of them. null clears a field. A value the field type cannot take is rejected with a 400.

etastring | null

Estimated completion date (null to clear)

Ejemplo: 2025-12-31T23:59:59.000Z

inReviewboolean | null

Whether post is pending moderation

Ejemplo: false

sendStatusUpdateEmailboolean | null

Whether to send status update email to voters

Ejemplo: false

statusIdstring

Status ID to set

Ejemplo: 507f1f77bcf86cd799439012

tagsstring | string[]

Tag names to set (replaces existing)

titlestring

Post title

Required string length: 2 - 512

Ejemplo: Updated: Add dark mode support

upvotesinteger | null

Set the upvotes count directly. Use with caution as this overrides the actual vote count.

Rango requerido: 0 <= x

Ejemplo: 10

visibilityenum<string>

Post visibility. 'public' = visible to all users, 'authorOnly' = only visible to the author and admins, 'companyOnly' = only visible to users in the same company as the author

Opciones disponibles: public, authorOnly, companyOnly

Ejemplo: public

Respuesta

Success

accessobjectobligatorio

Mostrar child attributes

anchorobject | nullobligatorio

When kind is 'insight', where exactly the insight points back into its origin: an insight source record with character ranges into its fullText, or the native conversation/message/comment/post ids.

Mostrar child attributes

assigneeIdstring | nullobligatorio

ID of the admin assigned to this post, null if unassigned

Ejemplo: 507f1f77bcf86cd799439013

authorobject | nullobligatorio

Mostrar child attributes

boardIdstringobligatorio

Board (category) ID this post belongs to

Ejemplo: 507f1f77bcf86cd799439011

commentCountnumberobligatorio

Total number of comments

Ejemplo: 5

contentstringobligatorio

Post content in HTML format

Ejemplo: <p>It would be great to have a dark mode option for the dashboard.</p>

createdAtstringobligatorio

ISO 8601 timestamp when created

Ejemplo: 2023-12-12T00:00:00.000Z

customFieldsobjectobligatorio

Custom field values keyed by field ID

dedupedenum<boolean>

Present and true only on POST /v2/posts, when the request carried a source.externalId that already had a post. The existing post is returned unchanged with HTTP 200; a newly created post returns HTTP 201 without this field.

Opciones disponibles: true

Ejemplo: true

etastring | nullobligatorio

Estimated completion time as ISO 8601 timestamp, null if not set

Ejemplo: 2025-01-01T00:00:00.000Z

featuresobjectobligatorio

Mostrar child attributes

groupKeystring | nullobligatorio

When kind is 'insight', the triage grouping key (source record id, conversation id, origin post id, or the insight's own id for singletons). Legacy insights may be null and group as singletons.

idstringobligatorio

Unique identifier

Ejemplo: 507f1f77bcf86cd799439011

inReviewbooleanobligatorio

Whether the post is pending moderation review

Ejemplo: false

insightSourceobject | nullobligatorio

Provenance of an insight: which channel it came from and how it was captured.

Mostrar child attributes

intakeModeenum<string>

Present only on POST /v2/posts: the intakeMode the post was processed under ('request' when the request named none). On an idempotent replay (deduped: true) this is the mode the post was ORIGINALLY created with.

Opciones disponibles: request, feedback

Ejemplo: request

integrationsobjectobligatorio

Third-party integration links associated with this post

Mostrar child attributes

isPinnedbooleanobligatorio

Whether the post is pinned to the top

Ejemplo: false

kindenum<string>obligatorio

Discriminates an actionable work item ('issue') from a customer submission whose claims were extracted into insights ('record' — not a work item). Defaults to 'issue' for all pre-existing posts. Default list responses return issues only; pass kind='record' to opt in. Raw signal ('insight') is never returned by the posts resource — insights are served by /v2/insights.

Opciones disponibles: issue, insight, record

Ejemplo: issue

linkedInsightCountnumberobligatorio

Number of insights linked to this issue as supporting evidence. Only meaningful when kind is 'issue'.

Ejemplo: 0

linkedIssueIdstring | nullobligatorio

When kind is 'insight', the ID of the issue this insight supports. Null when the insight is unlinked or when kind is 'issue'.

objectenum<string>obligatorio

Object type identifier

Opciones disponibles: post

Ejemplo: post

opportunityAmountnumber | nullobligatorio

Total opportunity amount from linked HubSpot deals and Salesforce opportunities

Ejemplo: 30000

portalHiddenbooleanobligatorio

True when the issue is hidden from portal/public surfaces. Missing stored values are returned as false.

Ejemplo: false

postUrlstringobligatorio

Full URL to view the post

Ejemplo: https://feedback.example.com/p/add-dark-mode-support

processingobject

On POST /v2/posts — queued: a processing run (claim extraction or the Organize rewrite) was enqueued and its result lands asynchronously on the post. skipped: nothing was enqueued; reason says which gate decided ('request_mode' for every intakeMode: 'request' create). existing: the create was an idempotent replay and the post was not processed again. On GET /v2/posts/{id} this field is present only for posts created with intakeMode: 'feedback' and reports how far that processing has got ('queued', 'processing', 'complete', 'needs_review', or 'skipped' with the same reason the create returned), with results listing what was made of the submission once the run has finished.

Mostrar child attributes

slugstringobligatorio

URL-friendly slug

Ejemplo: add-dark-mode-support

statusobjectobligatorio

Mostrar child attributes

tagsobject[]obligatorio

Tags attached to this post

Mostrar child attributes

titlestringobligatorio

Post title

Ejemplo: Add dark mode support

updatedAtstringobligatorio

ISO 8601 timestamp when last modified

Ejemplo: 2023-12-13T00:00:00.000Z

upvotesnumberobligatorio

Total number of upvotes

Ejemplo: 42

¿Aún necesitas ayuda? Pregunta al equipo