HEAD
twins/{twinID}
Commonly used to check that given token has an access to the given twin. The response will contain a header, indicating actual access level.
Resource Information
| Method and URI | HEAD https://developer.api.autodesk.com/tandem/v1/twins/{twinID} |
| Authentication Context | user context optional |
| Required OAuth Scopes | data:read |
| Data Format | JSON |
Request
Headers
| Authorization* string | Must be Bearer <token>, where <token> is a two-legged access token obtained via a Client Credentials Grant flow, or a three-legged access token obtained via Authorization Code flow, Authorization Code flow with PKCE, or Secure Service Account flow (for headless scenarios). |
| Region string | Specifies the region where your request should be routed. Possible values: US, EMEA. For more details, see Regions. |
* Required
Request
URI Parameters
| twinID string | Twin URN |
Response
HTTP Status Code Summary
| 200 OK | |
| 403 Forbidden | The request was successfully validated but it did not have the required permissions. |
Response
Header (200)
| x-dt-access-level string | Indicates actual access level to the facility (None, Read, ReadWrite, Manage, Owner). |
Response
Body Structure (200)
Response for 200 has no body.