Support

Support tickets for the signed-in account. The same thread staff sees in the console, so a reply posted here reaches a person and their answer comes back on the ticket. Session-scoped (/v1/me/*).

Authentifizierung erforderlichExplorer+

client.support.create()

Open a ticket.

create(params: CreateTicketParams): Promise<APIResponse<SupportTicket>>

POST/v1/me/support

Explorer+

stringHeadererforderlich
Ihr API-Schlüssel. Authorization: Bearer <key> wird ebenfalls akzeptiert.

application/json

stringerforderlich
One-line summary of the issue.
stringerforderlich
Prose summary of the record, where one has been written.
string
What the ticket is about. Not a firearm or attachment category.
string
Triage priority you are asking for. Staff may change it.

application/json

SupportTicket
The response payload
string
Opaque ticket id.
string
One-line summary of the issue.
string
Prose summary of the record, where one has been written.
TicketStatus
Lifecycle of a support ticket. waiting means we are waiting on the customer.
TicketPriority
Support ticket priority.
string | null
What the ticket is about: billing, technical, data_quality, feature_request, other.
integer
How many replies the thread holds.
string
When the ticket was opened, ISO 8601.
string
When the ticket last changed, ISO 8601.
string | null
When it was closed, or null while it is open.

400VALIDATION_ERRORValidation error
401UNAUTHORIZEDAPI key required
403FORBIDDENValid key, not permitted
413PAYLOAD_TOO_LARGERequest body too large
429RATE_LIMITEDRate limit exceeded
500INTERNAL_ERRORUnexpected server error

Alle Anfragelimits

Mindeststufe: Explorer+
Monatskontingent: 200/mo
Anfragerate: 10/min
Tageslimit: 50

Die Werte gelten für die Mindeststufe dieses Endpunkts. Höhere Stufen erhöhen alle Limits.

1import { GunSpec } from '@buun_group/gunspec-sdk';2 3const client = new GunSpec();4 5const { data } = await client.support.create({6  subject: 'Cannot generate an API key',7  description: 'The button does nothing when I click it.',8});9console.log(data);

1{2  "success": true,3  "data": {4    "id": "d3f1c2a0-...",5    "subject": "Cannot generate an API key",6    "description": "string",7    "status": "open",8    "priority": "low",9    "category": "technical",10    "reply_count": 2,11    "created_at": "2026-08-23T02:00:00.000Z",12    "updated_at": "string",13    "closed_at": null14  }15}

Authentifizierung erforderlichExplorer+

client.support.list()

The account's tickets, newest first.

list(params?: ListTicketsParams): Promise<PaginatedResponse<SupportTicket>>

GET/v1/me/support

Explorer+

stringHeadererforderlich
Ihr API-Schlüssel. Authorization: Bearer <key> wird ebenfalls akzeptiert.

integerstandard1
Page number, from 1 to 10,000
Bereich
1 – 10000
Beispiel
integerstandard20
Items per page (max 100)
Bereich
1 – 100
Beispiel
string
Filter by ticket status
Akzeptiert
stringstandardcreated_at
Sort field
Akzeptiert
Beispiel
stringstandarddesc
Sort order
Akzeptiert
Beispiel

application/json

SupportTicket[]
One page of results
string
Opaque ticket id.
string
One-line summary of the issue.
string
Prose summary of the record, where one has been written.
TicketStatus
Lifecycle of a support ticket. waiting means we are waiting on the customer.
TicketPriority
Support ticket priority.
string | null
What the ticket is about: billing, technical, data_quality, feature_request, other.
integer
How many replies the thread holds.
string
When the ticket was opened, ISO 8601.
string
When the ticket last changed, ISO 8601.
string | null
When it was closed, or null while it is open.
number
Current page number
number
Items per page
number
Total matching records (Builder and above)

400VALIDATION_ERRORValidation error
401UNAUTHORIZEDAPI key required
403FORBIDDENValid key, not permitted
429RATE_LIMITEDRate limit exceeded
500INTERNAL_ERRORUnexpected server error

Alle Anfragelimits

Mindeststufe: Explorer+
Monatskontingent: 200/mo
Anfragerate: 10/min
Tageslimit: 50

Die Werte gelten für die Mindeststufe dieses Endpunkts. Höhere Stufen erhöhen alle Limits.

1import { GunSpec } from '@buun_group/gunspec-sdk';2 3const client = new GunSpec();4 5const { data } = await client.support.list();6console.log(data);

1{2  "success": true,3  "data": [4    {5      "id": "d3f1c2a0-...",6      "subject": "Cannot generate an API key",7      "description": "string",8      "status": "open",9      "priority": "low",10      "category": "technical",11      "reply_count": 2,12      "created_at": "2026-08-23T02:00:00.000Z",13      "updated_at": "string",14      "closed_at": null15    }16  ],17  "pagination": {18    "page": 1,19    "limit": 20,20    "per_page": 20,21    "total": 42,22    "totalPages": 323  }24}

Authentifizierung erforderlichExplorer+

client.support.get()

One ticket with its whole conversation.

get(ticketId: string): Promise<APIResponse<SupportTicketDetail>>

GET/v1/me/support/{ticketId}

Explorer+

stringHeadererforderlich
Ihr API-Schlüssel. Authorization: Bearer <key> wird ebenfalls akzeptiert.

stringerforderlich
Support ticket id
Beispiel

application/json

SupportTicket
The response payload
string
Opaque ticket id.
string
One-line summary of the issue.
string
Prose summary of the record, where one has been written.
TicketStatus
Lifecycle of a support ticket. waiting means we are waiting on the customer.
TicketPriority
Support ticket priority.
string | null
What the ticket is about: billing, technical, data_quality, feature_request, other.
integer
How many replies the thread holds.
string
When the ticket was opened, ISO 8601.
string
When the ticket last changed, ISO 8601.
string | null
When it was closed, or null while it is open.
object[]
Every reply on the ticket in the order it was written, staff-internal notes excluded.
integer
Numeric id of the reply.
string
Id of the ticket.
string
Who wrote it: the customer or a staff member.
string
The reply body.
string
When the reply was recorded, ISO 8601 UTC.
object[]
Files attached to the ticket or to one of its replies.
integer
Numeric id of the attachment.
string
Id of the ticket the file belongs to.
integer | null
The reply the file was attached to, or null when it was attached to the ticket itself.
string
Who uploaded it.
string
The name the file was uploaded with.
string
Storage key; download through the ticket attachment endpoint, never by constructing a URL from this.
integer
Bytes.
string
Media type as detected at upload.
string
When the file was attached, ISO 8601 UTC.

400VALIDATION_ERRORValidation error
401UNAUTHORIZEDAPI key required
403FORBIDDENValid key, not permitted
404NOT_FOUNDResource not found
429RATE_LIMITEDRate limit exceeded
500INTERNAL_ERRORUnexpected server error

Alle Anfragelimits

Mindeststufe: Explorer+
Monatskontingent: 200/mo
Anfragerate: 10/min
Tageslimit: 50

Die Werte gelten für die Mindeststufe dieses Endpunkts. Höhere Stufen erhöhen alle Limits.

1import { GunSpec } from '@buun_group/gunspec-sdk';2 3const client = new GunSpec();4 5const { data } = await client.support.get('d3f1c2a0-...');6console.log(data);

1{2  "success": true,3  "data": {4    "id": "d3f1c2a0-...",5    "subject": "Cannot generate an API key",6    "description": "string",7    "status": "open",8    "priority": "low",9    "category": "technical",10    "reply_count": 2,11    "created_at": "2026-08-23T02:00:00.000Z",12    "updated_at": "string",13    "closed_at": null,14    "replies": [15      {16        "id": 12,17        "ticket_id": "d3f1c2a0-...",18        "user_id": "u_...",19        "message": "Still happening on the latest build.",20        "created_at": "2026-08-23T02:00:00.000Z"21      }22    ],23    "attachments": [24      {25        "id": 3,26        "ticket_id": "d3f1c2a0-...",27        "reply_id": null,28        "user_id": "u_...",29        "file_name": "screenshot.png",30        "file_key": "tickets/d3f1c2a0/3.png",31        "file_size": 48213,32        "mime_type": "image/png",33        "created_at": "2026-08-23T02:00:00.000Z"34      }35    ]36  }37}

Authentifizierung erforderlichExplorer+

client.support.reply()

Add a message to an open ticket.

reply(ticketId: string, params: CreateReplyParams): Promise<APIResponse<SupportTicketReply>>

POST/v1/me/support/{ticketId}/replies

Explorer+

stringHeadererforderlich
Ihr API-Schlüssel. Authorization: Bearer <key> wird ebenfalls akzeptiert.

stringerforderlich
Support ticket id
Beispiel

application/json

stringerforderlich
The reply body. Plain text.

application/json

object
The response payload.
integer
Numeric id of the reply.
string
Id of the ticket the reply was added to.
string
The reply body, as sent.
string
When the reply was recorded, ISO 8601 UTC.

400VALIDATION_ERRORValidation error
401UNAUTHORIZEDAPI key required
403FORBIDDENValid key, not permitted
404NOT_FOUNDResource not found
413PAYLOAD_TOO_LARGERequest body too large
429RATE_LIMITEDRate limit exceeded
500INTERNAL_ERRORUnexpected server error

Alle Anfragelimits

Mindeststufe: Explorer+
Monatskontingent: 200/mo
Anfragerate: 10/min
Tageslimit: 50

Die Werte gelten für die Mindeststufe dieses Endpunkts. Höhere Stufen erhöhen alle Limits.

1import { GunSpec } from '@buun_group/gunspec-sdk';2 3const client = new GunSpec();4 5const { data } = await client.support.reply('d3f1c2a0-...', {6  message: 'Still happening on the latest build.',7});8console.log(data);

1{2  "success": true,3  "data": {4    "id": 12,5    "ticket_id": "d3f1c2a0-...",6    "message": "Still happening on the latest build.",7    "created_at": "2026-08-23T02:00:00.000Z"8  }9}

Support

AutorisierungExplorer+

Anfrage-Bodyapplication/json

Antwort201application/json

Fehler

AnfragelimitsAlle Anfragelimits

AutorisierungExplorer+

Abfrageparameter

Antwort200application/json

Fehler

AnfragelimitsAlle Anfragelimits

AutorisierungExplorer+

Pfadparameter

Antwort200application/json

Fehler

AnfragelimitsAlle Anfragelimits

AutorisierungExplorer+

Pfadparameter

Anfrage-Bodyapplication/json

Antwort201application/json

Fehler

AnfragelimitsAlle Anfragelimits

Explorer+

application/json

application/json

Alle Anfragelimits

Explorer+

application/json

Alle Anfragelimits

Explorer+

application/json

Alle Anfragelimits

Explorer+

application/json

application/json

Alle Anfragelimits