Tickets-API
Endpoints
All REST endpoints of the Tickets API.
Endpoints
All paths are relative to the base URL https://www.theredstonee.de/api/tickets/v1.
| Method | Path | Description |
|---|---|---|
POST | /create.php | Create a ticket (pk or sk). Fields: name, email, subject, message (required); category, fields, page_url (optional). Attachments via multipart attachments[]. |
GET | /list.php | List tickets (sk only). Query: status, limit (max 200), offset. |
GET | /ticket.php?id=tkt_xxx | Single ticket. With pk also email. |
POST | /reply.php | Append a reply. pk = customer, sk = support. Body: ticket_id, message (+ email for pk, author_name for sk). |
POST | /status.php | Change status (sk only). Body: ticket_id, status. |
POST | /priority.php | Set priority (sk only). Body: ticket_id, priority. |
POST | /assign.php | Assign (sk only). Body: ticket_id, assignee (empty = unassign). |
POST | /delete.php | Delete a ticket (sk only). Body: ticket_id. |
GET | /categories.php | Categories + custom fields (pk or sk). |
GET | /kb.php | Published knowledge base articles. ?id= for a single article. |
GET | /meta.php | Statuses, priorities, active modules, Turnstile site key. |
GET / POST | /settings.php | Read/set mail settings (sk only). |
POST | /close-request.php | Request closing. |
POST | /close-resolve.php | Answer a close request. Body: ticket_id, accept. |
POST | /upload.php | File upload (multipart). Max 5 MB. jpg, png, gif, webp, pdf, txt, log, json, csv, zip. |
GET | /file.php?ticket_id=X&file_id=Y | Load a file. |
GET | /me.php | Tenant info + stats (sk only). |
Example: create a ticket
curl -X POST -H "Authorization: Bearer sk_live_KEY" \
-F "name=Max" -F "email=max@example.com" \
-F "subject=Help" -F "message=My problem ..." \
"https://www.theredstonee.de/api/tickets/v1/create.php"
Management API (CRUD)
Full read/write access to all portal settings via one endpoint (sk only). Secrets are never returned.
# Read the complete configuration
curl -H "Authorization: Bearer sk_live_KEY" \
"https://www.theredstonee.de/api/tickets/v1/admin.php?r=all"
# Write a resource (list = replaces everything)
curl -X POST -H "Authorization: Bearer sk_live_KEY" -H "Content-Type: application/json" \
-d '{"tags":[{"name":"VIP","color":"#ff0000"}]}' \
"https://www.theredstonee.de/api/tickets/v1/admin.php?r=tags"
Resources: all, agents, macros, categories, kb, statuses, priorities, webhooks, blocklists, recurring, escalation, tags, rules, design, mail, business_hours, sla, autoclose, audit, webhook_log, imap, modules.
List resources are fully replaced on
POST — always send the complete list. agents and kb work by id (upsert/delete individually).