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 Format | JSON |
Request
Headers
Authorization* string | Must be Bearer <token> , where <token> is obtained via either a two-legged or three-legged OAuth flow. |
* 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