tickets

List tickets

Row-filtered by role: users see their own tickets, developers and tenant admins their tenant's, admins all.

get/tickets

Request

  • Base URL: https://api.instruxi.dev/api/v1/enforcer
  • URL: https://api.instruxi.dev/api/v1/enforcer/tickets
  • Auth: one of:
    • API key in header Authorization
    • API key in header X-API-Key

Query parameters

statusstring

open | pending | resolved | closed

prioritystring

low | normal | high | urgent

assigneestring

assignee account id

unassignedboolean

true = assignee IS NULL (the real queue); cannot combine with assignee

requesterstring

requester account id

requester_group_idstring uuid

only tickets whose requester is a member of this group; 404 group_not_found if the group is not visible to you

sourcestring

exact source: api | support_contact | automated (program-filed, e.g. the PWA's Plaid auto-ticket) | email

qstring

'#1042' / '1042' = ticket number (exact); a UUID = ticket id (exact); anything else searches the subject

sortstring

updated_at_desc (default) | updated_at_asc (longest-waiting first) | created_at_desc | created_at_asc

limitinteger

page size

offsetinteger

page offset

tenant_idstring uuid

list this tenant instead of your own (default: the caller's own tenant, platform admins included). Another tenant requires the cross_tenant grant — 403 otherwise

all_tenantsboolean

list EVERY tenant (platform-wide admin view). Requires the cross_tenant grant — 403 otherwise. Mutually exclusive with tenant_id (400 conflicting_tenant_scope)

Response

OK

limitinteger
offsetinteger
successboolean
totalinteger

Example response

{
  "success": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.