## Update a post
**patch** `/v2/posts/{id}`
Updates an existing post. Only provided fields will be modified.
### 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 visibility restriction: 'public' (no additional restrictions), 'authorOnly' (only author and admins), or 'companyOnly' (only users in author's company). Note: even 'public' posts are still subject to board-level and organization-level access controls.
- `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.
### Path Parameters
- `id: string`
Post unique identifier
### Header Parameters
- `"Featurebase-Version": optional "2026-01-01.nova" or "2025-12-12.clover"`
- `"2026-01-01.nova"`
- `"2025-12-12.clover"`
### Body Parameters
- `assigneeId: optional string`
Admin ID to assign this post to (null to unassign)
- `author: optional AuthorInput`
Author to attribute the post to. If not provided, uses the authenticated user. Supports multiple identification methods: id (Featurebase ID), userId (external SSO ID), or email.
- `id: optional string`
Featurebase user ID to attribute content to
- `email: optional string`
Author email (used to find or create user)
- `name: optional string`
Author display name
- `profilePicture: optional string`
Author profile picture URL
- `userId: optional string`
External user ID from your system (matched via SSO)
- `boardId: optional string`
Board ID to move post to
- `commentsEnabled: optional boolean`
Whether comments are enabled on this post
- `content: optional string`
Post content (HTML)
- `createdAt: optional string`
Creation date (for backdating)
- `customFields: optional map[array of string or boolean or number or 2 more]`
Custom field values. Keys must be valid ObjectIds. Values can be: string, boolean, number, ISO date string, array of strings, ObjectId string, or null.
- `array of string`
- `boolean`
- `number`
- `string`
- `string`
- `eta: optional string`
Estimated completion date (null to clear)
- `inReview: optional boolean`
Whether post is pending moderation
- `sendStatusUpdateEmail: optional boolean`
Whether to send status update email to voters
- `statusId: optional string`
Status ID to set
- `tags: optional string or array of string`
Tag names to set (replaces existing)
- `string`
- `array of string`
- `title: optional string`
Post title
- `upvotes: optional number`
Set the upvotes count directly. Use with caution as this overrides the actual vote count.
- `visibility: optional "public" or "authorOnly" or "companyOnly"`
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
- `"public"`
- `"authorOnly"`
- `"companyOnly"`
### Returns
- `Post object { id, access, assigneeId, 20 more }`
- `id: string`
Unique identifier
- `access: object { companyExternalIds, userIds }`
- `companyExternalIds: array of string`
External company IDs explicitly granted access to this post. Empty array means no company-level restrictions. Non-empty means only users belonging to these companies can see the post.
- `userIds: array of string`
User IDs explicitly granted access to this post. Empty array means no user-level restrictions (post uses board/org visibility). Non-empty means only these users (plus admins) can see the post.
- `assigneeId: string`
ID of the admin assigned to this post, null if unassigned
- `author: object { id, email, name, 2 more }`
- `id: string`
Author unique identifier
- `email: string`
Author email (if available)
- `name: string`
Author display name
- `profilePicture: string`
Author profile picture URL
- `type: "admin" or "customer" or "guest" or 3 more`
Type of user who authored the post
- `"admin"`
- `"customer"`
- `"guest"`
- `"integration"`
- `"bot"`
- `"lead"`
- `boardId: string`
Board (category) ID this post belongs to
- `commentCount: number`
Total number of comments
- `content: string`
Post content in HTML format
- `createdAt: string`
ISO 8601 timestamp when created
- `customFields: map[unknown]`
Custom field values keyed by field ID
- `eta: string`
Estimated completion time as ISO 8601 timestamp, null if not set
- `features: object { commentsEnabled }`
- `commentsEnabled: boolean`
Whether comments are allowed on this post
- `inReview: boolean`
Whether the post is pending moderation review
- `integrations: object { clickup, devops, github, 4 more }`
Third-party integration links associated with this post
- `clickup: array of object { id, title, url }`
- `id: string`
ClickUp task ID
- `title: string`
ClickUp task title
- `url: string`
URL to the ClickUp task
- `devops: array of object { id, projectId, projectName, 2 more }`
- `id: number`
Azure DevOps work item ID
- `projectId: string`
Azure DevOps project ID
- `projectName: string`
Azure DevOps project name
- `title: string`
Work item title
- `url: string`
URL to the work item
- `github: array of object { id, number, repositoryFullName, 3 more }`
- `id: string`
GitHub issue ID
- `number: string`
GitHub issue number
- `repositoryFullName: string`
Full repository name (owner/repo)
- `repositoryName: string`
Repository name
- `title: string`
GitHub issue title
- `url: string`
URL to the GitHub issue
- `hubspot: array of object { dealAmount, dealClosed, objectId, type }`
- `dealAmount: number`
Deal amount (for DEAL type)
- `dealClosed: boolean`
Whether the deal is closed (for DEAL type)
- `objectId: number`
HubSpot object ID
- `type: "TICKET" or "DEAL" or "CONTACT"`
HubSpot object type
- `"TICKET"`
- `"DEAL"`
- `"CONTACT"`
- `jira: array of object { issueId, issueUrl }`
- `issueId: string`
Jira issue ID
- `issueUrl: string`
URL to the Jira issue
- `linear: array of object { issueId, issueUrl }`
- `issueId: string`
Linear issue ID
- `issueUrl: string`
URL to the Linear issue
- `salesforce: array of object { amount, isClosed, objectId, objectType }`
- `amount: number`
Opportunity amount (for Opportunity type)
- `isClosed: boolean`
Whether the opportunity is closed (for Opportunity type)
- `objectId: string`
Salesforce record ID
- `objectType: "Opportunity" or "Case"`
Salesforce object type
- `"Opportunity"`
- `"Case"`
- `isPinned: boolean`
Whether the post is pinned to the top
- `object: "post"`
Object type identifier
- `"post"`
- `opportunityAmount: number`
Total opportunity amount from linked HubSpot deals and Salesforce opportunities
- `postUrl: string`
Full URL to view the post
- `slug: string`
URL-friendly slug
- `status: PostStatus`
- `id: string`
Unique identifier
- `color: string`
Color for UI display
- `isDefault: boolean`
Whether this is the default status for new posts
- `name: string`
Display name
- `object: "post_status"`
Object type identifier
- `"post_status"`
- `type: "reviewing" or "unstarted" or "active" or 2 more`
The workflow stage this status represents
- `"reviewing"`
- `"unstarted"`
- `"active"`
- `"completed"`
- `"canceled"`
- `tags: array of object { id, color, name }`
Tags attached to this post
- `id: string`
Tag unique identifier
- `color: string`
Tag color hex code
- `name: string`
Tag name
- `title: string`
Post title
- `updatedAt: string`
ISO 8601 timestamp when last modified
- `upvotes: number`
Total number of upvotes
### Example
```http
curl https://do.featurebase.app/v2/posts/$ID \
-X PATCH \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $FEATUREBASE_API_KEY" \
-d '{
"assigneeId": "507f1f77bcf86cd799439013",
"boardId": "507f1f77bcf86cd799439011",
"commentsEnabled": true,
"content": "Updated content with more details.
",
"createdAt": "2025-01-15T10:30:00.000Z",
"customFields": {
"507f1f77bcf86cd799439011": "high"
},
"eta": "2025-12-31T23:59:59.000Z",
"statusId": "507f1f77bcf86cd799439012",
"tags": [
"feature",
"ui"
],
"title": "Updated: Add dark mode support",
"upvotes": 10,
"visibility": "public"
}'
```
#### Response
```json
{
"id": "507f1f77bcf86cd799439011",
"access": {
"companyExternalIds": [
"string"
],
"userIds": [
"string"
]
},
"assigneeId": "507f1f77bcf86cd799439013",
"author": {
"id": "507f1f77bcf86cd799439011",
"email": "john@example.com",
"name": "John Doe",
"profilePicture": "https://cdn.example.com/avatars/john.png",
"type": "customer"
},
"boardId": "507f1f77bcf86cd799439011",
"commentCount": 5,
"content": "It would be great to have a dark mode option for the dashboard.
",
"createdAt": "2023-12-12T00:00:00.000Z",
"customFields": {
"cf_priority": "bar",
"cf_effort": "bar"
},
"eta": "2025-01-01T00:00:00.000Z",
"features": {
"commentsEnabled": true
},
"inReview": false,
"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": [
{
"dealAmount": 5000,
"dealClosed": false,
"objectId": 123456789,
"type": "TICKET"
}
],
"jira": [
{
"issueId": "10042",
"issueUrl": "https://myteam.atlassian.net/browse/PROJ-123"
}
],
"linear": [
{
"issueId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"issueUrl": "https://linear.app/team/issue/ENG-123"
}
],
"salesforce": [
{
"amount": 25000,
"isClosed": false,
"objectId": "006Dn00000Abcdef",
"objectType": "Opportunity"
}
]
},
"isPinned": false,
"object": "post",
"opportunityAmount": 30000,
"postUrl": "https://feedback.example.com/p/add-dark-mode-support",
"slug": "add-dark-mode-support",
"status": {
"id": "507f1f77bcf86cd799439011",
"color": "Blue",
"isDefault": false,
"name": "In Progress",
"object": "post_status",
"type": "active"
},
"tags": [
{
"id": "507f1f77bcf86cd799439011",
"color": "#FF5722",
"name": "bug"
}
],
"title": "Add dark mode support",
"updatedAt": "2023-12-13T00:00:00.000Z",
"upvotes": 42
}
```