Consolidated handoff audit feed

GET

/tickets/audit

const url = 'https://example.com/api/tickets/audit?ticketLimit=200&scanLimit=30&includeGithub=true&includeScans=true';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://example.com/api/tickets/audit?ticketLimit=200&scanLimit=30&includeGithub=true&includeScans=true' \
  --header 'Authorization: Bearer <token>'

Returns handoff tickets, optional GitHub issue status/details, and optional scan events in a single response.

Authorizations

bearerApiKey
cookieAuth

Parameters

Query Parameters

projectId

string format: uuid

ticketLimit

integer

default: 200 >= 1 <= 500

scanLimit

integer

default: 30 >= 1 <= 100

includeGithub

boolean

default: true

includeScans

boolean

default: true

Responses

200

Consolidated audit payload

application/json

object

meta

required

object

generated_at

required

string format: date-time

project_id

required

string | null format: uuid

ticket_count

required

integer

scan_event_count

required

integer

github_issue_count

required

integer

tickets

required

Array

object

required

string format: uuid

project_id

required

string format: uuid

billing_account_id

string format: uuid

milestone_id

string | null format: uuid

source

string

number

required

integer

title

required

string

description

Full ticket body; omitted from list rows when slim=1

string

request_type

required

string

Allowed values: bug clarification_needed decision_needed feature_request

status

required

string

Allowed values: open closed

stage

required

string

Allowed values: backlog up_next in_progress validation live

priority

required

string

Allowed values: low medium high

blocking

required

boolean

created_at

required

string format: date-time

updated_at

string | null format: date-time

merge_sha

string | null

deployed_at

string | null format: date-time

deploy_failed_at

string | null format: date-time

resolution_type

string | null

reported_by_user_id

string | null format: uuid

suggested_resolution

string | null

implementation_notes

Requester-provided implementation guidance for the assignee

string | null

resolution_note

string | null

resolved_at

string | null format: date-time

evidence

object | null

category

Alias of request_type

string

severity

Alias of priority

string

suggested_backend_change

Alias of suggested_resolution

string | null

roles

Assigned ticket roles

Array<object>

Row from handoff_request_roles embedded on ticket list/detail responses.

object

required

string format: uuid

handoff_request_id

required

string format: uuid

role

required

string

Allowed values: frontend backend test design devops qa other

status

required

string

Allowed values: pending in_progress done skipped

assignee_user_id

string | null format: uuid

assignee_note

string | null

blocking_reason

string | null

work_started_note

string | null

agent_origin

string | null

started_at

string | null format: date-time

completed_at

string | null format: date-time

created_at

required

string format: date-time

updated_at

required

string format: date-time

summary

Present on list responses

string

ticket_ref

Present on list responses (HO-{number}-{project-slug})

string

project_name

string

backend_repo

string | null

frontend_repo

string | null

can_triage

boolean

github_issue_number

integer | null

github_issue_url

string | null format: uri

github_statuses

required

object

key

additional properties

string

github_details

required

object

key

additional properties

object

state

required

string

title

required

string

url

required

string format: uri

updated_at

required

string format: date-time

comments

required

integer

assignees

required

Array<string>

scan_events

required

Array<object>

object

required

string format: uuid

project_id

required

string format: uuid

trigger_source

required

string

trigger_detail

string | null

backend_repo

string | null

lovable_repo

string | null

status

required

string

Allowed values: success error

duration_ms

integer | null

error_message

string | null

summary

object | null

scanned_at

required

string format: date-time

400

Invalid request

application/json

object

error

required

Human-readable error message

string

code

Stable machine-readable error code for client branching

string

fieldErrors

First validation message per field path

object

key

additional properties

string

issues

Structured validation issues (Zod)

Array<object>

object

path

required

string

message

required

string

retryAfter

Seconds until rate limit resets (429 responses)

number

401

Not authenticated

application/json

object

error

required

Human-readable error message

string

code

Stable machine-readable error code for client branching

string

fieldErrors

First validation message per field path

object

key

additional properties

string

issues

Structured validation issues (Zod)

Array<object>

object

path

required

string

message

required

string

retryAfter

Seconds until rate limit resets (429 responses)

number

reconnect

True if re-linking GitHub may fix the issue

boolean