Update a post

Update supplied fields atomically. ARCHIVED is accepted directly without a release. Leaving ARCHIVED clears releaseId. At least one editable field is required; notify alone is insufficient. API notification default is false. API PATCH does not send Slack/Discord messages.

patch/posts/{postId}

Request

  • Base URL: https://app.voteship.app/api/v1
  • URL: https://app.voteship.app/api/v1/posts/{postId}
  • Auth: HTTP bearer

Path parameters

postIdstring required

Request body

titlestring
descriptionstring nullable
status'PENDING' | 'APPROVED' | 'IN_PROGRESS' | 'COMPLETE' | 'CLOSED' | 'ARCHIVED'
tagIdsstring[]
metadataobject nullable

Private context. Replaces the object; null clears it. Omitted from public responses; available to secret-key APIs and trusted admin webhooks.

notifyboolean

Email post subscribers only on an actual status change. Defaults false. Audit records and webhooks still fire; external consumers control their own notifications.

Response

Updated post

Example response

{
  "data": {
    "id": "V1StGXR8_Z5jdHi6B-myT",
    "title": "PDF export support",
    "voteCount": 42
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.