{ "opencollection": "1.0.0", "info": { "name": "Construction.Account.Admin Account Management User Projects API", "version": "1.0" }, "request": { "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "items": [ { "info": { "name": "User Projects", "type": "folder" }, "items": [ { "info": { "name": "Get user projects", "type": "http" }, "http": { "method": "GET", "url": "https://developer.api.autodesk.com/construction/admin/v1/accounts/:accountId/users/:userId/projects", "headers": [ { "name": "Region", "value": "" }, { "name": "User-Id", "value": "" } ], "params": [ { "name": "accountId", "value": "", "type": "path", "description": "The ID of the ACC account that contains the project being created or the projects being retrieved. This corresponds to the hub ID in the Data Management API. To convert a hub ID into an account ID, remove the “b.\" prefix. For example, a hub ID of b.c8b0c73d-3ae9 translates to an account ID of c8b0c73d-3ae9." }, { "name": "userId", "value": "", "type": "path", "description": "The ID of the user. You can use either the ACC ID (id) or the Autodesk ID (autodeskId)." }, { "name": "filter[id]", "value": "", "type": "query", "description": "A list of project IDs to filter by." }, { "name": "fields", "value": "", "type": "query", "description": "A comma-separated list of user project fields to include in the response. If not specified, all available fields are included by default. Possible values: accessLevels, accountId, addressLine1, addressLine2, city, constructionType, country, createdAt, classification, deliveryMethod, endDate, imageUrl, jobNumber, latitude, longitude, name, platform, postalCode, projectValue, sheetCount, startDate, stateOrProvince, status, thumbnailImageUrl, timezone, type, updatedAt, contractType and currentPhase." }, { "name": "filter[classification]", "value": "", "type": "query", "description": "Filters projects by classification. Possible values: production – Standard production projects. template – Project templates that can be cloned to create production projects. component – Placeholder projects that contain standardized components (e.g., forms) for use across projects. Only one component project is permitted per account. Known as a library in the ACC unified products UI. sample – The single sample project automatically created upon ACC trial setup. Only one sample project is permitted per account. Max length: 255" }, { "name": "filter[name]", "value": "", "type": "query", "description": "Filters projects by name. Supports partial matches when used with filterTextMatch. For example filter[name]=ABCco&filterTextMatch=startsWith returns projects whose names start with “ABCco”. Max length: 255" }, { "name": "filter[platform]", "value": "", "type": "query", "description": "Filters by platform. Possible values: acc (Autodesk Construction Cloud) and bim360 (BIM 360). Max length: 255" }, { "name": "filter[status]", "value": "", "type": "query", "description": "Filters projects by status. Possible values: active, pending, archived, suspended." }, { "name": "filter[type]", "value": "", "type": "query", "description": "Filters by project type. To exclude a type, prefix it with - (e.g., -Bridge excludes bridge projects). Possible values: Airport, Assisted Living / Nursing Home, Bridge, Canal / Waterway, Convention Center, Court House, Data Center, Dams / Flood Control / Reservoirs, Demonstration Project, Dormitory, Education Facility, Government Building, Harbor / River Development, Hospital, Hotel / Motel, Library, Manufacturing / Factory, Medical Laboratory, Medical Office, Military Facility, Mining Facility, Multi-Family Housing, Museum, Oil & Gas,``Plant``, Office, OutPatient Surgery Center, Parking Structure / Garage, Performing Arts, Power Plant, Prison / Correctional Facility, Rail, Recreation Building, Religious Building, Research Facility / Laboratory, Restaurant, Retail, Seaport, Single-Family Housing, Solar Farm, Stadium/Arena, Streets / Roads / Highways, Template Project, Theme Park, Training Project, Transportation Building, Tunnel, Utilities, Warehouse (non-manufacturing), Waste Water / Sewers, Water Supply, Wind Farm." }, { "name": "filter[jobNumber]", "value": "", "type": "query", "description": "Filters by a user-defined project identifier. Supports partial matches when used with filterTextMatch. For example, filter[jobNumber]=HP-0002&filterTextMatch=equals returns projects where the job number is exactly “HP-0002”. Max length: 255" }, { "name": "filter[updatedAt]", "value": "", "type": "query", "description": "Filters projects updated within a specific date range in ISO 8601 format. For example: Date range: 2023-03-02T00:00:00.000Z..2023-03-03T23:59:59 .999Z Specific start date: 2023-03-02T00:00:00.000Z.. Specific end date: ..2023-03-02T23:59:59.999Z For more details, see JSON API Filtering. Max length: 100" }, { "name": "filter[accessLevels]", "value": "", "type": "query", "description": "Filters projects by user access level. Possible values: projectAdmin, projectMember. Max length: 255" }, { "name": "filterTextMatch", "value": "", "type": "query", "description": "Defines how text-based filters should match results. Possible values: contains (default) – Returns results where the text appears anywhere in the field. startsWith – Matches only if the field starts with the given value. endsWith – Matches only if the field ends with the given value. equals – Matches only if the field is an exact match." }, { "name": "sort", "value": "", "type": "query", "description": "A list of fields to sort the returned user projects by. Multiple sort fields are applied in sequence order — each sort field produces groupings of projects with the same values of that field; the next sort field applies within the groupings produced by the previous sort field. Each property can be followed by a direction modifier of either asc (ascending) or desc (descending). The default is asc. Possible values: name (the default), startDate, endDate, type, status, jobNumber, constructionType, deliveryMethod, contractType, currentPhase, createdAt, updatedAt and platform." }, { "name": "limit", "value": "", "type": "query", "description": "The maximum number of records per request. Default: 20. Minimum: 1, Maximum: 200. If a value greater than 200 is provided, only 200 records are returned." }, { "name": "offset", "value": "", "type": "query", "description": "The record number to start returning results from, used for pagination. For example, if limit=20 and offset=20, the request retrieves the second page of results." } ] }, "docs": "Returns a list of projects for a specified user within an Autodesk Construction Cloud (ACC) or BIM 360 account. Only projects the user participates in will be returned. The calling user must be an account administrator." } ] } ], "bundled": true }