Returning.AI
  1. Analysis API
Returning.AI
  • Returning.AI
    • APIs
      • Authentication
      • System API
        • Auth
          • Secure Auth
          • register
          • verify email
          • login
        • Server
          • create new server
          • get my servers
          • update server
          • channel list of server
        • Channel
          • get channels list
          • create new channel
          • update channel
          • delete channel
        • Role
          • role list of server
          • create new role
          • update role
          • delete role
          • get role list of user on a server
          • add role to a user on a server
          • remove role from a user on a server
        • Badge
          • get badges list
          • create new badge
          • update badge
          • delete badge
          • award badge to user
          • remove badge from user
      • Application API
        • Community Users
          • Get community users
          • Get user
        • User Fields
          • Get All User Fields
          • Get Specific User Field
          • Create Custom User Field
          • Update Custom User Field
          • Delete Custom User Field
        • User Field Histories
          • Get all user field histories in a community
          • Get user field histories for a specific field
          • Get user field histories for a specific user
          • Get user field histories of specific user field and user
          • Create user field history for specific user
      • Integration API
        • Users
          • Get Users with Filters
          • Create New User
          • Get User Data
          • Manage User Account
          • Get User Gamification History
          • Get User Gamification Stats
          • Bulk Import
          • Bulk Update
          • Get All Bulk Update
          • Check Bulk Update Status
          • Check Bulk Update Details
        • Messages
          • Get Messages
          • Send Message
          • Reply Message
          • React Message
        • Channels
          • Get Channels List
        • Xp Settings
          • Get Tier Info
        • Gamifications
          • Get User Gamification Logs
        • Analysis API
          • Create Analysis
            POST
          • Get Analysis
            GET
          • Update Analysis
            PATCH
          • Delete Analysis
            DELETE
          • List Analyses
            GET
          • Append Drawings
            POST
        • Redemption Transactions
          • Update redemption transaction status
        • Streak Logs
          • Get Streak Logs
    • Channels
      • Iframe
    • Events
      • Outgoing webhooks
        • Encryption
        • User Joins Server
        • User Visits server
        • New Message Posted Anywhere
        • New Message Posted To channel
        • Purchased Store Item
      • Incoming webhooks
        • API Keys & Encryption
        • Send message into channels
        • Update Custom User Fields
        • Update In-game currency
    • Widgets
      • Authenticated Widgets
      • Public widgets
    • Features
  • Schemas
    • Analysis
      • UpdateAnalysisRequest
      • AppendDrawingsRequest
      • CreateAnalysisResponse
      • GetAnalysisResponse
      • UpdateAnalysisResponse
      • AppendDrawingsResponse
      • AnalysisMetadata
      • Expiry
      • Levels
      • LevelEntry
      • Drawing
      • HorizontalLineDrawing
      • LineDrawing
      • RectangleDrawing
      • ParallelDrawing
      • FibonacciRetracementDrawing
      • Coordinate
      • DrawingStyle
      • AnalysisDetail
      • AnalysisSummary
      • CreateAnalysisRequest
      • ListAnalysesResponse
    • Sample Schemas
      • Pet
      • Category
      • Tag
    • Schemas
      • ValidationError
      • NotFoundError
      • InternalServerError
      • NotImplementedError
      • CreateUserFieldHistoryResponse
      • CreateUserFieldHistorySuccessResponse
      • UserFieldHistoryItem
      • GetUserFieldHistoriesResponse
      • UserFieldHistoriesValidationError
      • UserFieldHistoriesMetaWithValidation
      • UserFieldHistoriesMetaWithPagination
      • GetUserFieldHistoriesSuccessResponse
      • CreateUserFieldResponse
      • CreateUserFieldSuccessResponse
      • DeleteUserFieldResponse
      • DeleteUserFieldSuccessResponse
      • UserFieldCreator
      • GetUserFieldResponse
      • GetUserFieldSuccessResponse
      • ValidationErrorItem
      • GetUserFieldsMetaResponse
      • CreatorInfo
      • UserFieldResponse
      • GetUserFieldsSuccessResponse
      • UpdateUserFieldResponse
      • UpdateUserFieldPayload
      • UpdateUserFieldSuccessResponse
      • MetaResponse
      • GetUserResponse
      • GetUserSuccessResponse
    • Outgoing webhooks
      • Purchased store item
      • New message posted to channel
      • User visits server
      • User join server
      • ErrorResponse
  1. Analysis API

Append Drawings

Testing
POST
/apis/v1/analysis/{analysisId}/drawings
Append additional drawings to an existing analysis without replacing existing drawings.

Limitations#

Total drawings (existing + new) cannot exceed 20
All clientObjectIds must be unique across all drawings
New drawings must not reference objectIds that don't exist

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params

Body Params application/jsonRequired

Example
{
    "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
            }
        }
    ]
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://integration.returning.ai/apis/v1/analysis/507f1f77bcf86cd799439022/drawings' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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
            }
        }
    ]
}'

Responses

🟢200
application/json
Drawings appended successfully
Body

Example
{
    "status": "success",
    "message": "Drawings appended successfully",
    "data": {
        "analysisId": "507f1f77bcf86cd799439022",
        "appendedDrawings": 1,
        "totalDrawings": 4,
        "objectIdMap": {
            "fib_swing": "60d5ec49f1b2c8b1f8e4c8a5"
        }
    }
}
🟠404
🟠400BadRequest
🟠401Unauthorized
🔴500InternalServerError
Modified at 2026-01-09 13:35:47
Previous
List Analyses
Next
Update redemption transaction status