users/me

This endpoint is deprecated. We will continue supporting it until September 1, 2022. We recommend migrating to the BIM 360 API endpoints, which are compatible with ACC projects.

Retrieves information about an end user, including the type of workflow roles assigned to the user, whether the user is permitted to create RFIs, which states the user can create the RFIs in, and the attributes that are required when creating the RFIs in the different states.

We strongly recommend calling this endpoint before creating RFIs, in order to verify the most up-to-date permissions and actions.

Users who have been assigned either creator (projectSC) or manager (projectGC) workflow roles can create RFIs. All users in the project are automatically assigned the creator workflow role. To assign creator or manager workflow roles to project members, click Settings on the top right, and select Permissions. A list of users is displayed. Select the appropriate role from the Workflow role dropdown on the right. Note that in order to allocate workflow roles, you must have User Admin status.

Note that only users who are members of a project can potentially create and edit RFIs for the project. To check which users are members of a project, call GET users (BIM 360 or ACC). If a user is not a project member, the endpoint will return an error. Note that although we support grouping users by project for BIM 360 projects, we currently only support grouping users by account for ACC projects.

If the createRfi object appears in the response in the permittedActions object, it indicates that the user can create RFIs.

Currently, you can only assign workflow roles (creator, manager, reviewer) in the UI.

The following table displays RFIs UI workflow role names and the corresponding RFIs API workflow role names:

For information about RFI workflow role permissions, see the RFIs help documentation (BIM 360 or ACC).

Currently, you can only select an RFI workflow type for an RFI in the UI. To assign an RFI workflow to an RFI, see the RFIs help documentation (BIM 360 or ACC)

The following table displays RFIs UI workflow type names and the corresponding RFIs API workflow type names:

Note that you can use either type of workflow in the US and in EMEA.

curl -v 'https://developer.api.autodesk.com/construction/rfis/v2/projects/21a3f98d-34a8-4d4c-a362-3cc9de44f8aa/users/me' \
  -H 'Authorization: Bearer AuIPTf4KYLTYGVnOHQ0cuolwCW2a'

{
  "user": {
    "id": "BZPWJWWWMLSV",
    "name": "Jon Doe",
    "role": "project_admin"
  },
  "permittedActions": {
    "createRfi": {
      "permittedStatuses": [
        {
          "status": "open",
          "requiredAttributes": [
            {
              "name": "assignedTo",
              "values": [
                {
                  "value": "PER8KQPK2JRT",
                  "type": "user"
                }
              ]
            }
          ]
        }
      ]
    }
  },
  "workflow": {
    "roles": [
      "projectSC"
    ],
    "type": "US"
  }
}