Support Tickets API The Support Tickets API allows users to create and manage support tickets with role context, categories, and file attachments.
Get All Support Tickets curl -X GET https://api.kinconecta.com/api/support-tickets \ -H "Content-Type: application/json"
Response Unique identifier for the support ticket
User role context when ticket was created
Full name of the person submitting the ticket
Ticket category for classification
Detailed message describing the issue
Timestamp when ticket was created
Timestamp when ticket was last updated
List of file attachments associated with the ticket
[ { "id" : 1 , "roleContext" : "tourist" , "fullName" : "Maria Garcia" , "email" : "[email protected] " , "subject" : "Unable to complete booking" , "category" : "Booking Issues" , "message" : "I'm trying to book a tour for tomorrow but the payment keeps failing..." , "status" : "open" , "createdAt" : "2026-03-10T10:30:00Z" , "updatedAt" : "2026-03-10T10:30:00Z" , "attachments" : [] }, { "id" : 2 , "roleContext" : "guide" , "fullName" : "Carlos Rodriguez" , "email" : "[email protected] " , "subject" : "Profile photo upload issue" , "category" : "Account Problems" , "message" : "Cannot upload my profile photo. Getting an error message." , "status" : "in_progress" , "createdAt" : "2026-03-09T14:20:00Z" , "updatedAt" : "2026-03-10T09:15:00Z" , "attachments" : [ { "id" : 1 , "fileName" : "screenshot.png" , "fileUrl" : "https://storage.kinconecta.com/tickets/1/screenshot.png" } ] } ]
Get Support Ticket by ID curl -X GET https://api.kinconecta.com/api/support-tickets/{id} \ -H "Content-Type: application/json"
Path Parameters Response Returns a single support ticket object with all details and attachments.
{ "id" : 1 , "roleContext" : "tourist" , "fullName" : "Maria Garcia" , "email" : "[email protected] " , "subject" : "Unable to complete booking" , "category" : "Booking Issues" , "message" : "I'm trying to book a tour for tomorrow but the payment keeps failing. I've tried multiple credit cards." , "status" : "open" , "createdAt" : "2026-03-10T10:30:00Z" , "updatedAt" : "2026-03-10T10:30:00Z" , "attachments" : [] }
Create Support Ticket curl -X POST https://api.kinconecta.com/api/support-tickets \ -H "Content-Type: application/json" \ -d '{ "roleContext": "tourist", "fullName": "Ana Martinez", "email": "[email protected] ", "subject": "Question about tour cancellation", "category": "General Inquiry", "message": "What is your cancellation policy for tours booked less than 24 hours in advance?", "status": "open", "createdAt": "2026-03-10T11:00:00Z", "updatedAt": "2026-03-10T11:00:00Z" }'
Request Body User role when creating the ticket (e.g., “tourist”, “guide”)
Full name of the person submitting the ticket
Contact email address for ticket updates
Brief subject line describing the issue
Category for ticket classification (e.g., “Technical Issue”, “Billing”, “General Inquiry”)
Detailed description of the issue or question
Initial ticket status (typically “open”)
Timestamp when ticket is created (ISO 8601 format)
Timestamp when ticket is last updated (ISO 8601 format)
Optional array of file attachments
Response Returns the created support ticket object with assigned ID.
{ "id" : 3 , "roleContext" : "tourist" , "fullName" : "Ana Martinez" , "email" : "[email protected] " , "subject" : "Question about tour cancellation" , "category" : "General Inquiry" , "message" : "What is your cancellation policy for tours booked less than 24 hours in advance?" , "status" : "open" , "createdAt" : "2026-03-10T11:00:00Z" , "updatedAt" : "2026-03-10T11:00:00Z" , "attachments" : [] }
Support Ticket Workflow Support tickets follow a standard workflow:
Created - Ticket is submitted by userOpen - Ticket is pending reviewIn Progress - Support team is working on the issueResolved - Issue has been addressedClosed - Ticket is closed after resolution confirmation Attachment Management Support tickets can include file attachments (screenshots, documents, etc.) through the attachments relationship. The SupportTicketsAttachment model is linked via a one-to-many relationship, allowing multiple files per ticket.
When creating tickets with attachments, you may need to use multipart/form-data encoding and upload files separately, then associate them with the ticket ID.