Feedback ticket administration common objects

Fields follow the current frozen model’s JSON tags. Optional omission is distinguished from a null value. GitHub executor/workspace/effective roles, payload hashes, and leases are internal fields and are excluded from responses.

FeedbackTicket

Field

Type

Description

id

string

Object ID.

ticket_no

string / null

Feedback number; may be null.

account_id

string

Product principal ID that submitted the ticket.

uc_account_id

string / null

UC account facts saved at creation; may be null. This is not the current administrator’s account.

user_info

object / null, optional

Submitter information projected from the current identity directory for administrator reads. Optional; not persisted in the ticket.

title

string / null

Title; may be null on a ticket.

description

string / null

Problem description; may be null.

expected_behavior

string / null

Expected behavior; may be null.

actual_behavior

string / null

Actual behavior; may be null.

reproduction_steps

string / null

Reproduction steps; may be null.

suggested_priority

string / null

User-suggested priority; may be null and does not imply triage.

status

string

Ticket status: submitted, processing, or closed.

admin_reply

string / null

Administrator reply; may be null. An empty string differs from null.

created_at

string

Creation time in RFC 3339 format.

updated_at

string

Update time in RFC 3339 format.

messages

object (array of objects), optional

Optional conversation messages; not loaded in lists. An empty detail collection may be omitted because of omitempty.

github_issue

object / null, optional

Optional primary GitHub Issue request; lists, details, and updates can include this association.

reward_event

object / null, optional

Optional reward approval record; not currently loaded in lists. Details and updates return it when present.

FeedbackMessage

Field

Type

Description

sequence

integer

Conversation message sequence.

role

string

user or assistant.

content

string

Conversation text.

created_at

string

Creation time in RFC 3339 format.

FeedbackUserInfo

Field

Type

Description

name

string

Current directory display name.

accounts

object (array of objects)

Current directory account entries.

FeedbackAccount

Field

Type

Description

type

string

Directory account type, such as email.

value

string

Directory account value; control access and redact evidence appropriately.

FeedbackRewardEvent

Field

Type

Description

id

string

Object ID.

event_type

string

Approval event type: feedback.reward_approved.

source_type

string

Source type: feedback_ticket.

source_id

string

Associated ticket ID.

subject_uc_account_id

string

Approved submitter’s UC account.

approved_by

string

Administrator principal ID from the first approval.

occurred_at

string

First approval time in RFC 3339 format.

delivery_status

string

pending or granted. Approval success does not mean delivery has completed.

attempt_count

integer

Number of asynchronous processing attempts.

last_attempt_at

string / null

Last attempt time; null if no attempt has occurred.

last_error

string / null

Latest error message; may be null.

billing_transaction_id

string / null

Consumer accounting reference ID; may be null.

granted_at

string / null

Delivery time; may be null.

created_at

string

Creation time in RFC 3339 format.

updated_at

string

Update time in RFC 3339 format.

FeedbackRewardApprovalResult

Field

Type

Description

ticket

object

Ticket reread after approval.

reward_event

object

The ticket’s unique reward approval record, without amounts or campaign rules.

FeedbackTicketList

Field

Type

Description

github_issue_creation_available

boolean

true when a creation workspace is configured in the deployment; not a health check of the full execution chain or permission validation.

items

object (array of objects)

Tickets on the current page; may be empty.

total

integer

Total tickets matching the filters.

limit

integer

Maximum items on the current page.

offset

integer

Current offset.

FeedbackGitHubIssue

Field

Type

Description

ticket_id

string

Associated ticket ID.

kind

string

bug, feature, or auto; the creation strategy, not necessarily the final GitHub Type.

status

string

pending, creating, created, or failed; independent of the ticket status.

draft_title

string

Frozen request title.

draft_body

string

Frozen and normalized request body.

request_id

string

Identifier of this creation attempt; retries may generate a new value.

requested_by

string

Administrator principal requesting creation.

attempt_count

integer

Number of asynchronous processing attempts.

last_attempt_at

string / null

Last attempt time; null if no attempt has occurred.

issue_number

integer / null

Issue number from the creation acknowledgement; null until created.

issue_url

string / null

Issue URL from the creation acknowledgement; null until created.

created_by

string

Requester principal recorded on successful creation; may be an empty string until completion.

issue_created_at

string / null

Time the creation acknowledgement was received; null until completion.

last_error_code

string

Safe error code; may be an empty string when no error has occurred.

created_at

string

Creation time in RFC 3339 format.

updated_at

string

Update time in RFC 3339 format.

FeedbackGitHubIssueDraft

Field

Type

Description

kind

string

bug, feature, or auto; the creation strategy, not necessarily the final GitHub Type.

template

string

Current template identifier: moi-bug, moi-feature, or moi-auto.

title

string

Generated draft title, including the prefix for the current type.

body

string

Generated Markdown draft body for manual review; excludes the complete ticket conversation.

sensitive_findings

string (array of strings)

Detected categories. Currently known values are token, credential, temporary_url, personal_data, and business_data; this is not an exhaustive list of sensitive content.

Queries and projections

Lists sort by created_at and id, both descending. total is the filtered count, and offset is an ordinary offset; ongoing writes mean pagination is not a snapshot. search uses escaped LIKE containment matching on title, description, expected behavior, actual behavior, and reproduction steps, and also matches an equal account_id or UC/product principal sets resolved through the directory. It does not guarantee coverage of ticket_no, messages, administrator replies, or all account fields. Directory unavailability can fail an administration query.

Lists load current GitHub associations and project current submitter information, but do not load full conversations or reward events. Details load messages, GitHub and reward associations, and current directory information. Updates return the ticket with associations loaded, without current directory projection. Optional user_info reflects the current directory, not a creation-time snapshot.

Ticket status is separate from github_issue.status and reward_event.delivery_status. Closing a ticket does not automatically create an Issue or approve a reward. An approval event does not prove delivery. created_by, requested_by, and approved_by refer to distinct actors and do not all mean the current user.

If a historical account no longer exists in the directory, user_info may be omitted without failing the read. Directory request or dependency failures still return errors; these cases must not both be treated as an absent submitter. Current account projections can include email, phone, and github. Email is included only when verified by UC. No account entries produce an empty array; a missing name currently falls back to “-“.

Last updated on