Request

Response

    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