GET
twins/{twinID}/users
Returns users from the given twin.
Resource Information
| Method and URI | GET https://developer.api.autodesk.com/tandem/v1/twins/{twinID}/users |
| Authentication Context | user context optional |
| Required OAuth Scopes | data:read data:write |
| 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). |
* Required
Request
URI Parameters
| twinID string | Twin URN |
Response
HTTP Status Code Summary
| 200 OK | OK |
| 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. |
| 404 Not Found | The requested resource was not found. Check the URI of your request before you resend this request. |
| 500 Internal Server Error | The service encountered an error that it was unable to handle. Wait for a few minutes and resend the request. If the error persists, contact us at aps.help@autodesk.com. |
Response
Body Structure (200)
Expand all
object | |
| accessLevel int | Level of access to the corresponding resource. |
| email string | email of the user (unless this pertains to a group) |
| group string | urn of the group that grants access (if any) |
| name string | name of the subject (either a user or group name) |
Example
This example demonstrates successfully getting the information about users that have access to a specific twin (aka “facility”).
Request
curl -v 'https://developer.api.autodesk.com/tandem/v1/twins/urn:adsk.dtt:d5eZt_XtRzqUHT93-vNZxw/users' \
-H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsIm....'
Response
{
"116966059401837": {
"name": "Fred Flintstone",
"group": "urn:adsk.dtg:ysqziKwTSCejQaUVfqj32Q",
"accessLevel": "Manage"
},
"200808200459915": {
"name": "Barney Rubble",
"accessLevel": "Manage"
},
"200903140902524": {
"name": "Wilma Flintstone",
"accessLevel": "Manage"
},
"3Q56PRM475W4": {
"name": "Betty Rubble",
"group": "urn:adsk.dtg:ysqziKwTSCejQaUVfqj32Q",
"accessLevel": "Manage"
},
"4U52ZSTSPNS2NES9": {
"name": "Pebbles",
"accessLevel": "Manage"
},
"7NL26GEXJUJL7RDG": {
"name": "Bam Bam",
"accessLevel": "Manage"
}
}
Show More