List all boards

GET/v2/boards

Returns all boards (post categories) for the authenticated organization.

Boards are containers for posts/feedback. Each board can have different:

Access controls (public, private, segment-restricted)
Feature toggles (comments, posting enabled)
Custom fields

This endpoint returns all boards without pagination. Organizations typically have a small number of boards.

Header ParametersExpand Collapse

"Featurebase-Version": optional "2026-01-01.nova" or "2025-12-12.clover"

One of the following:

"2026-01-01.nova"

"2025-12-12.clover"

ReturnsExpand Collapse

id: string

Unique identifier

access: object { adminOnly, allowedRoles, deniedRoles, segments }

adminOnly: boolean

If true, only admins can see this board

allowedRoles: array of string

Role IDs allowed access (empty = all)

deniedRoles: array of string

Role IDs explicitly denied access

segments: array of string

Segment IDs that can access (empty = all)

createdAt: string

ISO 8601 timestamp when created

customFields: array of string

Custom field IDs attached to this board

features: object { commentsEnabled, createdDatesVisible, postingEnabled }

commentsEnabled: boolean

Whether users can comment on posts

createdDatesVisible: boolean

Whether creation dates are visible on posts

postingEnabled: boolean

Whether users can create new posts

icon: object { type, value } or object { type, value } or object { type, value }

The board’s icon. Can be one of three types:

emoji: A single emoji character (e.g., 💡, 🚀, ⭐)
icon: A predefined icon from the built-in library (e.g., lightbulb, bug, star)
url: A custom image URL (HTTPS required)

Can be null if no icon is set.

One of the following:

EmojiIcon object { type, value }

An emoji character as the board icon

type: "emoji"

Emoji icon type

value: string

A single emoji character

PredefinedIcon object { type, value }

A predefined icon from the built-in icon library

type: "icon"

Predefined icon type

value: string

Icon name from the predefined icon set (e.g., lightbulb, bug, star, rocket, flag, heart, check, question, megaphone, gift)

URLIcon object { type, value }

A custom icon loaded from an external URL

type: "url"

External URL icon type

value: string

HTTPS URL to a custom icon image (PNG, SVG, or WebP recommended)

formaturi

localization: object { description, formPlaceholder, heroDescription, 3 more }

description: map[string]

Localized description

formPlaceholder: map[string]

Placeholder text in the post creation form

heroDescription: map[string]

Hero description/subtitle

heroTitle: map[string]

Hero title shown on the board page

name: map[string]

Localized board name (language code → text)

submitButtonText: map[string]

Submit button text

name: string

Display name in organization’s default locale

object: "board"

Object type identifier

postDefaults: object { visibility }

visibility: "public" or "authorOnly" or "companyOnly"

Default visibility for new posts

One of the following:

"public"

"authorOnly"

"companyOnly"

List all boards

curl https://do.featurebase.app/v2/boards \
    -H "Authorization: Bearer $FEATUREBASE_API_KEY"

[
  {
    "id": "507f1f77bcf86cd799439011",
    "access": {
      "adminOnly": false,
      "allowedRoles": [
        "string"
      ],
      "deniedRoles": [
        "role_blocked"
      ],
      "segments": [
        "string"
      ]
    },
    "createdAt": "2023-12-12T00:00:00.000Z",
    "customFields": [
      "cf_priority",
      "cf_category"
    ],
    "features": {
      "commentsEnabled": true,
      "createdDatesVisible": true,
      "postingEnabled": true
    },
    "icon": {
      "type": "emoji",
      "value": "💡"
    },
    "localization": {
      "description": {
        "en": "Submit and vote on feature ideas"
      },
      "formPlaceholder": {
        "en": "Describe your feature idea..."
      },
      "heroDescription": {
        "foo": "string"
      },
      "heroTitle": {
        "en": "Share your ideas"
      },
      "name": {
        "en": "Feature Requests",
        "es": "Solicitudes de funciones"
      },
      "submitButtonText": {
        "en": "Submit Feedback"
      }
    },
    "name": "Feature Requests",
    "object": "board",
    "postDefaults": {
      "visibility": "public"
    }
  }
]

Returns Examples

[
  {
    "id": "507f1f77bcf86cd799439011",
    "access": {
      "adminOnly": false,
      "allowedRoles": [
        "string"
      ],
      "deniedRoles": [
        "role_blocked"
      ],
      "segments": [
        "string"
      ]
    },
    "createdAt": "2023-12-12T00:00:00.000Z",
    "customFields": [
      "cf_priority",
      "cf_category"
    ],
    "features": {
      "commentsEnabled": true,
      "createdDatesVisible": true,
      "postingEnabled": true
    },
    "icon": {
      "type": "emoji",
      "value": "💡"
    },
    "localization": {
      "description": {
        "en": "Submit and vote on feature ideas"
      },
      "formPlaceholder": {
        "en": "Describe your feature idea..."
      },
      "heroDescription": {
        "foo": "string"
      },
      "heroTitle": {
        "en": "Share your ideas"
      },
      "name": {
        "en": "Feature Requests",
        "es": "Solicitudes de funciones"
      },
      "submitButtonText": {
        "en": "Submit Feedback"
      }
    },
    "name": "Feature Requests",
    "object": "board",
    "postDefaults": {
      "visibility": "public"
    }
  }
]