Feature Requests

These endpoints are the end-user side of the Feedback module — what the SDK calls from inside your app. Staff actions (status changes, replies) live on the console API.

Authentication

Header	Required	Description
`X-Bundle-ID`	Yes	App bundle identifier — scopes results to one app
`X-Team-ID`	Yes	Apple Developer Team ID
`Authorization`	Yes	`Bearer <attestation JWT>` — or an API key for server-side/simulator callers. Identity headers alone return 401. See Authentication

API-key callers additionally need the feedback:read scope for reads and feedback:write for writes. Attestation JWTs are not scope-checked.

List feature requests

GET /api/v1/feedback/features

Query parameters

Parameter	Type	Default	Description
`page`	`int`	1	Page number
`per`	`int`	20	Results per page (max 100)
`sort`	`string`	`newest`	`newest`, `oldest`, or `most_voted`. Unknown values fall back to `newest`
`status`	`string`	—	Filter by status. Unknown values are ignored
`voter_id`	`string`	—	Populates `hasVoted` for this voter

Response

{
  "items": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "Dark Mode Support",
      "description": "Please add dark mode...",
      "status": "open",
      "voteCount": 42,
      "hasVoted": true,
      "commentCount": 5,
      "createdAt": "2026-03-01T12:00:00Z",
      "updatedAt": "2026-03-10T08:00:00Z"
    }
  ],
  "metadata": {
    "page": 1,
    "per": 20,
    "total": 42
  }
}

hasVoted is false unless you pass voter_id.

Status values

Status	Meaning
`pending`	Newly submitted, not yet triaged. This is the status every new request starts in
`open`	Accepted and open for votes
`planned`	On the roadmap
`in_progress`	Being built
`shipped`	Released
`declined`	Won’t be built
`duplicate`	Merged into another request

Create feature request

POST /api/v1/feedback/features

Body

{
  "title": "Dark Mode Support",
  "description": "Please add a dark mode option to reduce eye strain at night.",
  "submitterId": "user_123",
  "deviceHash": "optional-device-hash"
}

Field	Type	Required	Description
`title`	`string`	Yes	Non-empty after trimming, max 200 characters
`description`	`string`	Yes	Non-empty after trimming, max 5,000 characters
`submitterId`	`string`	Yes	User or device identifier
`deviceHash`	`string`	No	Device hash for deduplication
`pushToken`	`string`	No	Hex APNs token — subscribes this device to the request’s thread channel so it’s notified of admin replies. See Push
`pushEnvironment`	`string`	No	`sandbox` or `production`

Response

The created feature request, with status: "pending" and hasVoted: false. Validation failures return 422 with a fields array naming title or description. See API Conventions.

Get feature request

GET /api/v1/feedback/features/:featureId

Query parameters

Parameter	Type	Description
`voter_id`	`string`	Populates `hasVoted` for this voter

Response

A single feature request object. 404 if it doesn’t exist in your organization — or, when identity headers are present, in that app.

A personal API key (gpat_) must send X-Bundle-ID and X-Team-ID on list and get; without them the request returns 400. Organization keys may omit them to read across every app.

Overview

Attestation

Platform

Feedback

Feature Flags

Custom Claims

Analytics

Webhooks

Organization

Push

Entitlements

Visual Regression Testing

Auth

Authentication

List feature requests

Query parameters

Response

Status values

Create feature request

Body

Response

Get feature request

Query parameters

Response

​Authentication

​List feature requests

​Query parameters

​Response

​Status values

​Create feature request

​Body

​Response

​Get feature request

​Query parameters

​Response

Authentication

List feature requests

Query parameters

Response

Status values

Create feature request

Body

Response

Get feature request

Query parameters

Response