cupthread-android-sdk/dev.cupthread.feedback/FeedbackClient/submitFeatureRequest

submitFeatureRequest

suspend fun submitFeatureRequest(draft: FeatureRequestDraft, userToken: String): FeatureRequestSubmissionResult(source)

Submits a new feature request proposal to POST /api/v1/feature-requests.

Depending on the console's moderation settings, new requests may be immediately visible or placed into moderation review (indicated by FeatureRequestSubmissionResult.pending).

Return

FeatureRequestSubmissionResult with the assigned ID and moderation state.

Parameters

draft

The proposed title, description, and optional requester display name (FeatureRequestDraft).

userToken

Stable anonymous user token from UserTokenStore that owns the request.

Throws

FeedbackException.AuthenticationRequired

if anonymous requests are disallowed (HTTP 401).

FeedbackException.UnexpectedStatus

on HTTP rejection.

FeedbackException.InvalidResponse

on network or parsing failure.

Example:

val draft = FeatureRequestDraft(
    title = "Support Tablet Landscape Mode",
    description = "Split view layouts for larger tablets and foldables.",
    requesterName = "Taylor"
)
val result = client.submitFeatureRequest(draft, userToken = userToken)
if (result.pending) {
    println("Request submitted for moderator review: ${result.featureRequestId}")
} else {
    println("Request published to board: ${result.featureRequestId}")
}