dt.mutation
| Event: | dt.mutation |
| Service: | adsk.tandem (Tandem) |
| Scope: | modelUrn |
| Trigger: | When a model element is changed. |
Create a Webhook
Request
curl -X 'POST'\
-v 'https://developer.api.autodesk.com/webhooks/v1/systems/adsk.tandem/events/dt.mutation/hooks'\
-H 'Content-Type: application/json'\
-H 'Authorization: Bearer eyjhbGCIOIjIuzI1NiISimtpZCI6...'\
-d '{
"callbackUrl": "http://bf067e05.ngrok.io/callback",
"scope": {
"modelUrn": "urn:adsk.dtm:4n9u5YaVTpCgjigN5ER7KQ"
}
}'
Show More
Callback Payload
Headers
| x-adsk-delivery-id string | Payload delivery ID |
| x-adsk-signature string | Hash-signature of the payload using secret token as the key.
It is prefixed with
sha1hash=. Your callback endpoint canverify the signature to validate the integrity of the payload.
|
Body Structure
Expand all
| version string | The version of the callback payload. This is always 1.0. |
| resourceUrn string | The URN of the resource that triggered the event. |
| hook object | The object that contains the details about the webhook. |
| system string | The system that triggered the event. This is always adsk.tandem. |
| event string | The type of event that occurred. This is always dt.mutation. |
| hookId string | The unique ID of the webhook. A hook ID is automatically assigned when the webhook is registered. |
| callbackUrl string | The URL to which a POST request is sent when event occurs. |
| createdBy string | The ID of the user or application that registered the webhook. |
| createdDate string | The date and time when the webhook was registered. |
| creatorType string | This indicates whether the webhook was created by a user or an application. |
| hookAttribute object | A user-defined JSON object that holds custom information about the webhook. The hookAttribute object is specified when the webhook is registered. |
| scope object | This object identifies the extent of where the event is monitored. For example, if the scope is modelUrn, a notification is fired when an element of the given model is changed. |
| modelUrn string | The URN of the model that triggered the event. |
| urn string | The URN of the webhook. |
| status string | This indicates if the webhook is active or not. Possible values: active and inactive. |
| __self__ string | The location of the webhook relative to /webhooks/v1/. |
| payload object | The object that contains details of the event that occurred. |
| timestamp string | The time when element is modified. |
| keys array | Array of changed element ids. |
| details object | Additional details of the event. |
| attributes array | Array of changed attributes. The items of the array are fully qualified parameter IDs (i.e. n:!n in the example below refers to name override). |
Example Body
{
"version": "1.0",
"resourceUrn": "urn:adsk.dtm:WtMe53OeTWuvLaCP4bvZkw",
"hook": {
"hookId": "134d1e8d-65c6-4595-b5b9-51122424033a",
"tenant": "urn:adsk.dtm:4n9u5YaVTpCgjigN5ER7KQ",
"callbackUrl": "http://bf067e05.ngrok.io/callback",
"createdBy": "7HqqekpIbAfWIKu9G1Yxx9SOCX9rtn6p",
"event": "dt.mutation",
"createdDate": "2025-02-13T03:11:50.294+0000",
"system": "adsk.tandem",
"creatorType": "Application",
"status": "active",
"scope": {
"modelUrn": "urn:adsk.dtm:4n9u5YaVTpCgjigN5ER7KQ"
},
"urn": "urn:adsk.webhooks:events.hook:134d1e8d-65c6-4595-b5b9-51122424033a",
"__self__": "/systems/adsk.tandem/events/dt.mutation/hooks/134d1e8d-65c6-4595-b5b9-51122424033a"
},
"payload": {
"timestamp": "2025-03-14T16:33:14.47Z",
"keys": [
"AQAAAGM1YzU0YzNmLTJhODctNDEAAAAA"
],
"details": {
"attributes": [
"n:!n",
]
}
}
}
Show More