Community — Wahlu API Docs

Manage community feature requests, bug reports, and improvements. All community endpoints are admin-only — the API key must belong to a user with the Admin or Super Admin role.

Requires community:read for read operations and community:write for write operations.

List community posts

GET/v1/community/posts

Returns a paginated list of community posts.

Query parameters

Parameter	Type	Description
`page`	integer	Page number. Defaults to 1.
`limit`	integer	Items per page. Defaults to 50, max 100.
`sort_by`	string	Field to sort by. Defaults to created_at.
`sort_dir`	string	Sort direction: asc or desc. Defaults to desc.

curl

curl https://api.wahlu.com/v1/community/posts \
  -H "Authorization: Bearer wahlu_live_your_api_key_here"

Response

{
  "success": true,
  "data": [
    {
      "id": "cp_abc123",
      "type": "feature_request",
      "title": "Bulk image upload",
      "description": "Allow uploading multiple images at once in the media library.",
      "status": "planned",
      "category": "integrations",
      "created_by": "user_abc",
      "vote_count": 42,
      "comment_count": 5,
      "admin_notes": null,
      "admin_thread": [],
      "rejected_reason": null,
      "admin_only": false,
      "created_at": "2026-02-01T10:00:00Z",
      "updated_at": "2026-02-10T14:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "has_more": false
  }
}

Response fields

Parameter	Type	Description
`id`	string	Unique community post identifier.
`type`	string	Post type (feature_request, bug_report, improvement).
`title`	string	Post title.
`description`	string	Post description.
`status`	string	Status (pending, approved, planned, in_progress, completed, rejected).
`category`	string	Category (automation, integrations, analytics, scheduling, design, ai, other).
`created_by`	string \| null	User ID of the creator.
`vote_count`	number	Number of votes.
`comment_count`	number	Number of comments.
`admin_notes`	string \| null	Internal admin notes.
`admin_thread`	object[]	Internal admin discussion thread.
`rejected_reason`	string \| null	Reason for rejection.
`admin_only`	boolean	Whether this post is only visible to admins.
`created_at`	string	ISO 8601 creation timestamp.
`updated_at`	string	ISO 8601 last-updated timestamp.

Get a community post

GET/v1/community/posts/:post_id

Returns a single community post with full details including admin notes and the internal admin thread.

Create a community post

POST/v1/community/posts

Creates a new community post.

Request body

Parameter	Type	Description
`title`*	string	Post title. Max 500 characters.
`type`*	string	One of: feature_request, bug_report, improvement.
`description`	string	Post description. Max 10,000 characters.
`category`	string	One of: automation, integrations, analytics, scheduling, design, ai, other. Max 100 characters.
`status`	string	One of: pending, approved, planned, in_progress, completed, rejected. Defaults to pending.
`admin_only`	boolean	Whether this post is only visible to admins. Defaults to false.

curl

curl -X POST https://api.wahlu.com/v1/community/posts \
  -H "Authorization: Bearer wahlu_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Bulk image upload",
    "type": "feature_request",
    "description": "Allow uploading multiple images at once in the media library.",
    "category": "design"
  }'

Update a community post

PATCH/v1/community/posts/:post_id

Updates a community post. Only provided fields are changed.

Request body

Parameter	Type	Description
`status`	string	Updated status: pending, approved, planned, in_progress, completed, rejected.
`title`	string	Updated title. Max 500 characters.
`description`	string	Updated description. Max 10,000 characters.
`type`	string	Updated type.
`category`	string	Updated category. Max 100 characters.
`admin_notes`	string	Internal admin notes. Max 10,000 characters.
`rejected_reason`	string	Reason for rejection. Max 2,000 characters.
`admin_only`	boolean	Whether this post is only visible to admins.

curl

curl -X PATCH https://api.wahlu.com/v1/community/posts/cp_abc123 \
  -H "Authorization: Bearer wahlu_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "in_progress",
    "admin_notes": "Started work on this in sprint 12."
  }'

Delete a community post

DELETE/v1/community/posts/:post_id

Permanently deletes a community post and all associated data. This action cannot be undone.

Add admin note

POST/v1/community/posts/:post_id/notes

Adds a note to the post's internal admin thread. These notes are only visible to admins.

Request body

Parameter	Type	Description
`content`*	string	The note content. Max 10,000 characters.

List comments

GET/v1/community/posts/:post_id/comments

Returns all comments on a community post.

Comment response fields

Parameter	Type	Description
`id`	string	Unique comment identifier.
`post_id`	string	Parent community post ID.
`user_name`	string \| null	Display name of the commenter.
`content`	string	Comment text.
`is_admin`	boolean	Whether this is an admin comment.
`created_at`	string	ISO 8601 creation timestamp.

Add a comment

POST/v1/community/posts/:post_id/comments

Adds an admin comment to a community post. Comments added via the API are automatically marked as admin comments.

Request body

Parameter	Type	Description
`content`*	string	The comment content. Max 10,000 characters.
`user_name`	string	Display name for the comment. Max 200 characters. Defaults to 'Admin'.

Delete a comment

DELETE/v1/community/posts/:post_id/comments/:comment_id

Deletes a comment from a community post.