Create a support ticket
File an incident (something is broken) or a feature request. Urgent-priority tickets are escalated to the Hyperprop team immediately — reserve them for severe issues such as blocked trading or wrong balances.
Attachments must be uploaded first via the uploads endpoint; pass the returned paths here.
An organization can hold 100 unresolved tickets (409 TICKET_OPEN_LIMIT after that)
and open 50 tickets in 24 hours (429 TICKET_DAILY_LIMIT). Reply on an
existing ticket instead of opening a new one for the same issue.
Example
curl -X POST "https://api.hyperprop.com/platform/v1/organization/support/tickets" \
-H "X-API-Key: hp_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"type": "incident",
"title": "Fills missing on ES orders",
"description": "Orders filled on the exchange but no fills showed in the terminal.",
"accountIds": ["1e7c9f02-e980-4410-b81f-39599bb6fa47"],
"occurredAt": "2026-08-27T13:45:00Z",
"priority": "high"
}'
Authentication: send your organization API key in the X-API-Key header.
Access: full-access API keys only (a read-only key gets 403 READ_ONLY_KEY). Dashboard members need manage access to Support tickets.
curl --request POST \
--url https://api.hyperprop.com/platform/v1/organization/support/tickets \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"type": "incident",
"title": "Fills missing on ES orders since this morning",
"description": "Orders 123/456 filled on the exchange but no fills showed in the terminal…",
"accountIds": [
"<string>"
],
"occurredAt": "<string>",
"priority": "normal",
"attachments": [
{
"path": "55555555-5555-4555-8555-555555555555/1f2e.../screenshot.webp",
"name": "screenshot.webp",
"size": 482133,
"contentType": "image/webp"
}
]
}
'import requests
url = "https://api.hyperprop.com/platform/v1/organization/support/tickets"
payload = {
"type": "incident",
"title": "Fills missing on ES orders since this morning",
"description": "Orders 123/456 filled on the exchange but no fills showed in the terminal…",
"accountIds": ["<string>"],
"occurredAt": "<string>",
"priority": "normal",
"attachments": [
{
"path": "55555555-5555-4555-8555-555555555555/1f2e.../screenshot.webp",
"name": "screenshot.webp",
"size": 482133,
"contentType": "image/webp"
}
]
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
type: 'incident',
title: 'Fills missing on ES orders since this morning',
description: 'Orders 123/456 filled on the exchange but no fills showed in the terminal…',
accountIds: ['<string>'],
occurredAt: '<string>',
priority: 'normal',
attachments: [
{
path: '55555555-5555-4555-8555-555555555555/1f2e.../screenshot.webp',
name: 'screenshot.webp',
size: 482133,
contentType: 'image/webp'
}
]
})
};
fetch('https://api.hyperprop.com/platform/v1/organization/support/tickets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.hyperprop.com/platform/v1/organization/support/tickets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'type' => 'incident',
'title' => 'Fills missing on ES orders since this morning',
'description' => 'Orders 123/456 filled on the exchange but no fills showed in the terminal…',
'accountIds' => [
'<string>'
],
'occurredAt' => '<string>',
'priority' => 'normal',
'attachments' => [
[
'path' => '55555555-5555-4555-8555-555555555555/1f2e.../screenshot.webp',
'name' => 'screenshot.webp',
'size' => 482133,
'contentType' => 'image/webp'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.hyperprop.com/platform/v1/organization/support/tickets"
payload := strings.NewReader("{\n \"type\": \"incident\",\n \"title\": \"Fills missing on ES orders since this morning\",\n \"description\": \"Orders 123/456 filled on the exchange but no fills showed in the terminal…\",\n \"accountIds\": [\n \"<string>\"\n ],\n \"occurredAt\": \"<string>\",\n \"priority\": \"normal\",\n \"attachments\": [\n {\n \"path\": \"55555555-5555-4555-8555-555555555555/1f2e.../screenshot.webp\",\n \"name\": \"screenshot.webp\",\n \"size\": 482133,\n \"contentType\": \"image/webp\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.hyperprop.com/platform/v1/organization/support/tickets")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"type\": \"incident\",\n \"title\": \"Fills missing on ES orders since this morning\",\n \"description\": \"Orders 123/456 filled on the exchange but no fills showed in the terminal…\",\n \"accountIds\": [\n \"<string>\"\n ],\n \"occurredAt\": \"<string>\",\n \"priority\": \"normal\",\n \"attachments\": [\n {\n \"path\": \"55555555-5555-4555-8555-555555555555/1f2e.../screenshot.webp\",\n \"name\": \"screenshot.webp\",\n \"size\": 482133,\n \"contentType\": \"image/webp\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hyperprop.com/platform/v1/organization/support/tickets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"type\": \"incident\",\n \"title\": \"Fills missing on ES orders since this morning\",\n \"description\": \"Orders 123/456 filled on the exchange but no fills showed in the terminal…\",\n \"accountIds\": [\n \"<string>\"\n ],\n \"occurredAt\": \"<string>\",\n \"priority\": \"normal\",\n \"attachments\": [\n {\n \"path\": \"55555555-5555-4555-8555-555555555555/1f2e.../screenshot.webp\",\n \"name\": \"screenshot.webp\",\n \"size\": 482133,\n \"contentType\": \"image/webp\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"ticket": {
"id": "e4b1a2c3-d4e5-4f60-8192-a3b4c5d6e7f8",
"ticketNumber": 42,
"organizationId": "55555555-5555-4555-8555-555555555555",
"createdByUserId": "0b1c2d3e-4f50-6172-8394-a5b6c7d8e9f0",
"createdByEmail": "ops@example.com",
"createdByName": "Your Firm LLC",
"type": "incident",
"title": "Fills missing on ES orders since this morning",
"description": "Orders 123/456 filled on the exchange but no fills showed…",
"descriptionTruncated": false,
"accountIds": [
"1e7c9f02-e980-4410-b81f-39599bb6fa47"
],
"occurredAt": "2026-08-27T13:45:00.000Z",
"priority": "high",
"status": "open",
"attachments": [
{
"path": "55555555-5555-4555-8555-555555555555/1f2e.../screenshot.webp",
"name": "screenshot.webp",
"size": 482133,
"contentType": "image/webp",
"signedUrl": "<string>"
}
],
"comments": [
{
"id": "7d5c2f4e-9a1b-4c3d-8e2f-6a5b4c3d2e1f",
"authorType": "hyperprop",
"authorId": "<string>",
"authorName": "ops@example.com",
"body": "We shipped a fix — can you confirm it looks right now?",
"attachments": [
{
"path": "55555555-5555-4555-8555-555555555555/1f2e.../screenshot.webp",
"name": "screenshot.webp",
"size": 482133,
"contentType": "image/webp",
"signedUrl": "<string>"
}
],
"createdAt": "2026-08-27T16:21:00.000Z"
}
],
"commentCount": 2,
"createdAt": "<string>",
"updatedAt": "<string>"
}
}
}{
"statusCode": 401,
"error": "Unauthorized",
"message": "Invalid or expired token",
"code": "UNAUTHORIZED"
}{
"success": false,
"statusCode": 403,
"error": "Forbidden",
"message": "Your role does not have view access to \"Traders & accounts\"",
"code": "INSUFFICIENT_PERMISSIONS"
}{
"statusCode": 409,
"error": "Conflict",
"message": "Your organization has 100 unresolved tickets. Reply on an existing ticket, or wait until one is resolved.",
"code": "TICKET_OPEN_LIMIT"
}{
"statusCode": 429,
"error": "Too Many Requests",
"message": "Too many requests to this endpoint. Try again in 12 second(s).",
"code": "RATE_LIMITED"
}{
"statusCode": 500,
"error": "Internal Server Error",
"message": "Failed to load tickets",
"code": "SUPPORT_ERROR"
}{
"statusCode": 500,
"error": "Internal Server Error",
"message": "Failed to load tickets",
"code": "SUPPORT_ERROR"
}Authorizations
Organization API key (hp_live_...), sent in the X-API-Key header. Create, rotate and restrict keys in the dashboard or with the API keys endpoints; an organization can have two active keys, so you can rotate without downtime. A full-access key can call every endpoint in this reference. A read-only key can call GET endpoints (and create a trading stream token); any other request returns 403 READ_ONLY_KEY. A key with an IP allowlist returns 403 IP_NOT_ALLOWED from any other address. Each endpoint lists which keys can call it under Access.
Headers
Optional. A value that identifies this operation on your side, at most 255 characters. A retry with the same key, method, path and body within 24 hours returns the original response (with Idempotency-Replayed: true) instead of repeating the change. The same key with a different body returns 409 IDEMPOTENCY_KEY_REUSED; a retry while the first request is still running returns 409 IDEMPOTENCY_KEY_IN_PROGRESS. A response that contains a credential (such as a new API key or signing secret) is not saved: the change is still not repeated, and a retry returns 409 IDEMPOTENCY_KEY_COMPLETED with the original status in originalStatus. Server errors (5xx) are not saved, so a retry runs again. If the key cannot be recorded, the request is not run and returns 503 IDEMPOTENCY_UNAVAILABLE; retry with the same key.
255Body
curl --request POST \
--url https://api.hyperprop.com/platform/v1/organization/support/tickets \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"type": "incident",
"title": "Fills missing on ES orders since this morning",
"description": "Orders 123/456 filled on the exchange but no fills showed in the terminal…",
"accountIds": [
"<string>"
],
"occurredAt": "<string>",
"priority": "normal",
"attachments": [
{
"path": "55555555-5555-4555-8555-555555555555/1f2e.../screenshot.webp",
"name": "screenshot.webp",
"size": 482133,
"contentType": "image/webp"
}
]
}
'import requests
url = "https://api.hyperprop.com/platform/v1/organization/support/tickets"
payload = {
"type": "incident",
"title": "Fills missing on ES orders since this morning",
"description": "Orders 123/456 filled on the exchange but no fills showed in the terminal…",
"accountIds": ["<string>"],
"occurredAt": "<string>",
"priority": "normal",
"attachments": [
{
"path": "55555555-5555-4555-8555-555555555555/1f2e.../screenshot.webp",
"name": "screenshot.webp",
"size": 482133,
"contentType": "image/webp"
}
]
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
type: 'incident',
title: 'Fills missing on ES orders since this morning',
description: 'Orders 123/456 filled on the exchange but no fills showed in the terminal…',
accountIds: ['<string>'],
occurredAt: '<string>',
priority: 'normal',
attachments: [
{
path: '55555555-5555-4555-8555-555555555555/1f2e.../screenshot.webp',
name: 'screenshot.webp',
size: 482133,
contentType: 'image/webp'
}
]
})
};
fetch('https://api.hyperprop.com/platform/v1/organization/support/tickets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.hyperprop.com/platform/v1/organization/support/tickets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'type' => 'incident',
'title' => 'Fills missing on ES orders since this morning',
'description' => 'Orders 123/456 filled on the exchange but no fills showed in the terminal…',
'accountIds' => [
'<string>'
],
'occurredAt' => '<string>',
'priority' => 'normal',
'attachments' => [
[
'path' => '55555555-5555-4555-8555-555555555555/1f2e.../screenshot.webp',
'name' => 'screenshot.webp',
'size' => 482133,
'contentType' => 'image/webp'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.hyperprop.com/platform/v1/organization/support/tickets"
payload := strings.NewReader("{\n \"type\": \"incident\",\n \"title\": \"Fills missing on ES orders since this morning\",\n \"description\": \"Orders 123/456 filled on the exchange but no fills showed in the terminal…\",\n \"accountIds\": [\n \"<string>\"\n ],\n \"occurredAt\": \"<string>\",\n \"priority\": \"normal\",\n \"attachments\": [\n {\n \"path\": \"55555555-5555-4555-8555-555555555555/1f2e.../screenshot.webp\",\n \"name\": \"screenshot.webp\",\n \"size\": 482133,\n \"contentType\": \"image/webp\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.hyperprop.com/platform/v1/organization/support/tickets")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"type\": \"incident\",\n \"title\": \"Fills missing on ES orders since this morning\",\n \"description\": \"Orders 123/456 filled on the exchange but no fills showed in the terminal…\",\n \"accountIds\": [\n \"<string>\"\n ],\n \"occurredAt\": \"<string>\",\n \"priority\": \"normal\",\n \"attachments\": [\n {\n \"path\": \"55555555-5555-4555-8555-555555555555/1f2e.../screenshot.webp\",\n \"name\": \"screenshot.webp\",\n \"size\": 482133,\n \"contentType\": \"image/webp\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hyperprop.com/platform/v1/organization/support/tickets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"type\": \"incident\",\n \"title\": \"Fills missing on ES orders since this morning\",\n \"description\": \"Orders 123/456 filled on the exchange but no fills showed in the terminal…\",\n \"accountIds\": [\n \"<string>\"\n ],\n \"occurredAt\": \"<string>\",\n \"priority\": \"normal\",\n \"attachments\": [\n {\n \"path\": \"55555555-5555-4555-8555-555555555555/1f2e.../screenshot.webp\",\n \"name\": \"screenshot.webp\",\n \"size\": 482133,\n \"contentType\": \"image/webp\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"ticket": {
"id": "e4b1a2c3-d4e5-4f60-8192-a3b4c5d6e7f8",
"ticketNumber": 42,
"organizationId": "55555555-5555-4555-8555-555555555555",
"createdByUserId": "0b1c2d3e-4f50-6172-8394-a5b6c7d8e9f0",
"createdByEmail": "ops@example.com",
"createdByName": "Your Firm LLC",
"type": "incident",
"title": "Fills missing on ES orders since this morning",
"description": "Orders 123/456 filled on the exchange but no fills showed…",
"descriptionTruncated": false,
"accountIds": [
"1e7c9f02-e980-4410-b81f-39599bb6fa47"
],
"occurredAt": "2026-08-27T13:45:00.000Z",
"priority": "high",
"status": "open",
"attachments": [
{
"path": "55555555-5555-4555-8555-555555555555/1f2e.../screenshot.webp",
"name": "screenshot.webp",
"size": 482133,
"contentType": "image/webp",
"signedUrl": "<string>"
}
],
"comments": [
{
"id": "7d5c2f4e-9a1b-4c3d-8e2f-6a5b4c3d2e1f",
"authorType": "hyperprop",
"authorId": "<string>",
"authorName": "ops@example.com",
"body": "We shipped a fix — can you confirm it looks right now?",
"attachments": [
{
"path": "55555555-5555-4555-8555-555555555555/1f2e.../screenshot.webp",
"name": "screenshot.webp",
"size": 482133,
"contentType": "image/webp",
"signedUrl": "<string>"
}
],
"createdAt": "2026-08-27T16:21:00.000Z"
}
],
"commentCount": 2,
"createdAt": "<string>",
"updatedAt": "<string>"
}
}
}{
"statusCode": 401,
"error": "Unauthorized",
"message": "Invalid or expired token",
"code": "UNAUTHORIZED"
}{
"success": false,
"statusCode": 403,
"error": "Forbidden",
"message": "Your role does not have view access to \"Traders & accounts\"",
"code": "INSUFFICIENT_PERMISSIONS"
}{
"statusCode": 409,
"error": "Conflict",
"message": "Your organization has 100 unresolved tickets. Reply on an existing ticket, or wait until one is resolved.",
"code": "TICKET_OPEN_LIMIT"
}{
"statusCode": 429,
"error": "Too Many Requests",
"message": "Too many requests to this endpoint. Try again in 12 second(s).",
"code": "RATE_LIMITED"
}{
"statusCode": 500,
"error": "Internal Server Error",
"message": "Failed to load tickets",
"code": "SUPPORT_ERROR"
}{
"statusCode": 500,
"error": "Internal Server Error",
"message": "Failed to load tickets",
"code": "SUPPORT_ERROR"
}