Append Drawings
POST
/v1/analysis/{analysisId}/drawings
What this endpoint does
404 Analysis not found. Community API-key callers must send sender.Quick start
Authentication and permission
sendMessage. Keep the key server-side.Complete examples
{ "status": "fail", "statusCode": 404, "message": "Analysis not found" }.Success and readback
Errors and recovery
| Status | When | Recovery |
|---|---|---|
404 Analysis not found | Unknown id | Create or list first. |
401 | Missing or invalid token | Add a key with sendMessage. |
Retry safety
WARNING
Gotchas
drawings: [] on a missing id still 404s because the analysis does not exist.levels and metadata; append does not replace create.Next steps
Request
Path Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://adss-integration.returning.ai/apis/v1/analysis/507f1f77bcf86cd799439022/drawings' \
--header 'Content-Type: application/json' \
--data '{
"drawings": [
{
"type": "FIB_RETRACEMENT",
"clientObjectId": "fib_swing",
"points": [
{
"time": "2025-01-08T00:00:00Z",
"price": 1.085
},
{
"time": "2025-01-09T12:00:00Z",
"price": 1.095
}
],
"levels": [
0,
0.236,
0.382,
0.5,
0.618,
0.786,
1
],
"style": {
"color": "#FFA500",
"lineWidth": 1
}
}
]
}'Response Response Example
200 - Success Example
{
"status": "success",
"message": "Drawings appended successfully",
"data": {
"analysisId": "507f1f77bcf86cd799439022",
"appendedDrawings": 1,
"totalDrawings": 4,
"objectIdMap": {
"fib_swing": "60d5ec49f1b2c8b1f8e4c8a5"
}
}
}Modified at 2026-08-19 13:46:45