Feedback

The feedback service lets your users submit feature requests, vote on ideas, and open support tickets — all from within your app. Access it via grantiva.feedback. FeedbackService is an actor, so every call needs await — including the non-throwing cache helpers.

Feedback endpoints authenticate with the attestation JWT. Call validateAttestation() once before using them (in the Simulator, initialize the SDK with an API key — see Simulator Setup).

Feature requests

List feature requests

let requests = try await grantiva.feedback.getFeatureRequests(
    status: .open,       // Optional: filter by status
    sort: "votes",       // "votes", "newest", "oldest"
    page: 1,
    perPage: 20
)

Only the default query — no status filter, sort: "votes", page: 1, perPage: 20 — is cached, for 2 minutes. Any other combination always hits the network. Force a refresh of the cached query:

await grantiva.feedback.refreshFeatureRequests()
let fresh = try await grantiva.feedback.getFeatureRequests()

Get a single feature request

let feature = try await grantiva.feedback.getFeatureRequest(id: featureId)

Submit a feature request

let request = try await grantiva.feedback.submitFeatureRequest(
    title: "Dark Mode Support",
    description: "Please add a dark mode option to reduce eye strain at night."
)

Field	Constraints
`title`	3–200 characters
`description`	10–5,000 characters

Vote

Each user/device can vote once per feature request.

// Cast a vote
try await grantiva.feedback.vote(for: featureId)

// Remove a vote
try await grantiva.feedback.removeVote(for: featureId)

Comments

// List comments
let comments = try await grantiva.feedback.getComments(for: featureId)

// Add a comment
try await grantiva.feedback.addComment(to: featureId, body: "Great idea!")

FeatureRequest model

feature.id           // UUID
feature.title        // String
feature.description  // String
feature.status       // FeatureRequestStatus
feature.voteCount    // Int
feature.hasVoted     // Bool — whether the current user or device voted
feature.commentCount // Int
feature.createdAt    // Date
feature.updatedAt    // Date

FeatureRequest is Identifiable, so it drops straight into a SwiftUI List or ForEach.

FeatureRequestStatus

A String-backed enum: .pending, .open, .planned, .inProgress (raw value in_progress), .shipped, .declined, .duplicate.

Vote and FeatureComment

vote.id               // UUID
vote.featureRequestId // UUID
vote.createdAt        // Date

comment.id               // UUID
comment.featureRequestId // UUID
comment.authorType       // CommentAuthorType — .user or .admin
comment.body             // String
comment.createdAt        // Date

Support tickets

Submit a ticket

let ticket = try await grantiva.feedback.submitTicket(
    subject: "App crashes on launch",
    body: "After updating to v2.1, the app crashes immediately on iPhone 15...",
    email: "user@example.com"  // Optional — for reply notifications
)

Field	Constraints
`subject`	3–200 characters
`body`	10–5,000 characters

List user’s tickets

let tickets = try await grantiva.feedback.getUsersTickets()

If grantiva.identify() has been called, returns tickets for that user across all devices. Otherwise returns device-only tickets.

Get ticket with messages

let (ticket, messages) = try await grantiva.feedback.getTicket(id: ticketId)

for message in messages {
    print("\(message.authorType): \(message.body)")
    // authorType is .user or .admin
}

Reply to a ticket

try await grantiva.feedback.reply(to: ticketId, body: "Thanks for looking into this!")

SupportTicket model

ticket.id           // UUID
ticket.subject      // String
ticket.status       // TicketStatus — .open, .awaitingReply, .resolved, .closed
ticket.priority     // TicketPriority — .low, .normal, .high, .urgent
ticket.messageCount // Int
ticket.createdAt    // Date
ticket.updatedAt    // Date

TicketMessage model

message.id         // UUID
message.ticketId   // UUID
message.authorType // CommentAuthorType — .user or .admin
message.body       // String
message.createdAt  // Date

Both SupportTicket and TicketMessage are Identifiable.

Cache control

Feature requests and tickets are cached separately.

// Invalidate the cached default feature-request query
await grantiva.feedback.refreshFeatureRequests()

// Invalidate the cached ticket list
await grantiva.feedback.refreshTickets()

// Drop everything
await grantiva.feedback.clearCache()

Submitting, voting, commenting, and replying invalidate the relevant cache for you. grantiva.identify(_:) and grantiva.clearIdentity() clear the whole cache.

Push notifications for replies

If you register the device’s APNs token with the SDK, it is attached to feature request submissions and comments. The backend then subscribes the device to that thread and pushes it when an admin replies.

func application(
    _ application: UIApplication,
    didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data
) {
    grantiva.setPushToken(deviceToken)
}

There is also a string overload if you have already hex-encoded the token, plus accessors for reading and clearing it:

grantiva.setPushToken("a1b2c3…", environment: .sandbox)
grantiva.pushToken          // String? — the registered hex token
grantiva.clearPushToken()   // stop subscribing new threads

Parameter	Type	Default	Description
`deviceToken` / `hexToken`	`Data` / `String`	—	The token Apple handed your app delegate
`environment`	`PushEnvironment`	`.detected`	`.sandbox` or `.production`

PushEnvironment.detected reads aps-environment out of the bundled provisioning profile, and falls back to the build configuration (DEBUG → .sandbox, release → .production) when no profile is present. Pass an explicit value if your build pipeline doesn’t fit those heuristics. Registering a token is a no-op unless your organization has a linked push app. See Push notifications.

Getting Started

SDKs

CLI

Concepts

Push

Dashboard

Feature requests

List feature requests

Get a single feature request

Submit a feature request

Vote

Comments

FeatureRequest model

FeatureRequestStatus

Vote and FeatureComment

Support tickets

Submit a ticket

List user’s tickets

Get ticket with messages

Reply to a ticket

SupportTicket model

TicketMessage model

Cache control

Push notifications for replies

​Feature requests

​List feature requests

​Get a single feature request

​Submit a feature request

​Vote

​Comments

​FeatureRequest model

​FeatureRequestStatus

​Vote and FeatureComment

​Support tickets

​Submit a ticket

​List user’s tickets

​Get ticket with messages

​Reply to a ticket

​SupportTicket model

​TicketMessage model

​Cache control

​Push notifications for replies

Feature requests

List feature requests

Get a single feature request

Submit a feature request

Vote

Comments

FeatureRequest model

FeatureRequestStatus

Vote and FeatureComment

Support tickets

Submit a ticket

List user’s tickets

Get ticket with messages

Reply to a ticket

SupportTicket model

TicketMessage model

Cache control

Push notifications for replies