Request

Response

    POST

    timeseries/models/{modelID}/webhooks/generic

    Generic endpoint for posting stream data. It expects either a single JSON object or an array of objects. every such objects is treated as an individual event. unless specified via url parameter idpath, the ID of the stream associated with the event is expected to be found in the ID field at the root level of the event. E.g forms a valid payload:

    [
        {
            "id": "AQAAAB9jtMqU8UQYm_QTmtmTYmAAAAAA",
            "temp": 42.1
        },
        {
            "id": "AQAAAOe3EZ58DEBbh5mZyFfbkRoAAAAA",
            "hum": 98
        }
    ]
    
    Show More

    But also just:

    {
        "id": "AQAAAOe3EZ58DEBbh5mZyFfbkRoAAAAA",
        "hum": 98
    }
    

    Or with ?idpath=labels.adsk_id:

    {
        "labels" : {
            "adsk_id": "AQAAAOe3EZ58DEBbh5mZyFfbkRoAAAAA"
        },
        "hum": 98
    }
    

    The payload can also include timestamp - either as UNIX timestamp or RFC3339 formatted string.

    {
        "id": "AQAAAOe3EZ58DEBbh5mZyFfbkRoAAAAA",
        "hum": 98,
        "timestamp": 1711608163
    }
    

    Or:

    {
        "id": "AQAAAOe3EZ58DEBbh5mZyFfbkRoAAAAA",
        "hum": 98,
        "timestamp": "2025-05-26T10:02:35.368Z"
    }
    

    Text values are also supported:

    {
        "id": "AQAAAOe3EZ58DEBbh5mZyFfbkRoAAAAA",
        "status": "on"
    }
    

    Resource Information

    Method and URI
    POST
    https://developer.api.autodesk.com/tandem/v1/timeseries/models/{modelID}/webhooks/generic
    Authentication Context
    user context optional
    Required OAuth Scopes
    data:write
    Data Format
    JSON

    Request

    Headers

    Authorization*
    string
    Must be Bearer <token>, where <token> is obtained via either a two-legged or three-legged OAuth flow.
    Region
    string
    Specifies the region where your request should be routed. Possible values: US, EMEA. For more details, see Regions.
    Content-Type*
    string
    Must be application/json
    * Required

    Request

    URI Parameters

    modelID
    string
    Model ID

    Request

    Body Structure

    Stream data

    []
    array: object
    Optional array of objects with stream data. Can be also a single object - see examples above.

    Response

    HTTP Status Code Summary

    200
    OK
    Empty response body. The request was successfully processed.
    400
    Bad Request
    The service was unable to process the request. The syntax of the request may be malformed or the request may be missing a required header. Do not resend the request without fixing the issue. The response body may indicate what is wrong with the request.
    403
    Forbidden
    The request was successfully validated but it did not have the required permissions.

    Response

    Body Structure (200)

    Response for 200 has no body.

    Example 1

    This example demonstrates how to send data for one stream.

    Request

    curl -v 'https://developer.api.autodesk.com/tandem/v1/timeseries/models/urn:adsk.dtm:APCMKgIDSyOFpZ763lew7Q/webhooks/generic' \
      -X 'POST' \
      -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsIm....' \
      -H 'Content-Type: application/json' \
      -d '{
            "id": "AQAAAPeahQ-rkEcwiMvDS9re0QQAAAAA",
            "temperature": 20.2
          }'
    
    Show More

    Example 2

    This example demonstrates how to send data for multiple streams.

    Request

    curl -v 'https://developer.api.autodesk.com/tandem/v1/timeseries/models/urn:adsk.dtm:APCMKgIDSyOFpZ763lew7Q/webhooks/generic' \
    -X 'POST' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsIm....' \
    -H 'Content-Type: application/json' \
    -d '[
        {
          "id": "AQAAAPeahQ-rkEcwiMvDS9re0QQAAAAA",
          "temperature": 20.2
        },
        {
          "id": "AQAAAICIyq2_bkchtSbK3sPFeHcAAAAA",
          "temperature": 19.8
        }
        ]'
    
    Show More