Projects
POST
projects
Create a new BIM 360 project in a specific BIM 360 account.
Note that this endpoint is ONLY compatible with BIM 360 projects. It is not compatible with Autodesk Construction Cloud (ACC) projects. For more information about compatibility between between BIM 360 and ACC, see the Compatibility section.
Resource Information
Method and URI(US) | POST https://developer.api.autodesk.com/hq/v1/accounts/:account_id/projects |
Method and URI(Legacy) | POST https://developer.api.autodesk.com/hq/v1/regions/eu/accounts/:account_id/projects |
Authentication Context | app only |
Required OAuth Scopes | account:write |
Data Formats | JSON |
Request
Headers
Authorization yes | Must be Bearer <token> , where <token> is obtained via a two-legged OAuth flow. |
Content-Type yes | Must be application/json . |
Region no | Specifies the region where the service is located. Possible values: US , EMEA . For the full list of supported regions, see the Regions page. |
Request
URI Parameters
account_id string: UUID | The account ID of the project. This corresponds to hub ID in the Data Management API. To convert a hub ID into an account ID you need to remove the “b." prefix. For example, a hub ID of b.c8b0c73d-3ae9 translates to an account ID of c8b0c73d-3ae9. |
Request
Body Structure
The POST body is a flat JSON object with the following attributes:
name* string | The name of the project (1-255 characters).
Reserved characters:
\ , / , ? , [ , ] , > , * , : , < , " , | , , . |
service_types enum: string | The service name in which the project will be created.
If nothing specified, the project will be created for all the enabled services in the account.
Separate multiple values with comma.
Refer to the preconfigured
service_type list inthe Parameters guide.
|
start_date* date | The starting date of a project; must be earlier than
end_date Format:
YYYY-MM-DD |
end_date* date | The ending date of a project; must be later than
start_date Format:
YYYY-MM-DD |
project_type* string | The type of project; accepts preconfigured and customized project types
Max length: 255
Refer to the preconfigured
project_type list inthe Parameters guide.
|
value* float | Monetary value of the project |
currency* enum: string | |
job_number string | Project job number to connect a BIM 360 project to project or job in a financial or ERP system.
Max length: 100
|
address_line_1 string | Project address line 1
Max length: 255
|
address_line_2 string | Project address line 2
Max length: 255
|
city string | City in which project is located
Max length: 255
|
state_or_province enum: string | State or province in which project is located
Max length: 255
Note that the
state_or_province value depends on the selected country value; see the valid values in the state_or_province list in
the Parameters guide. |
postal_code string | Postal code for where the project is located.
Max length: 255
|
country enum: string | |
business_unit_id string: UUID | The business unit ID of this project |
timezone string | |
language enum: string | Language of the project; applicable to the BIM 360 Field
service only
Possible values:
en : Englishde : GermanNote that if
template_project_id is specified, this
language attribute must match that of
template_project_id . |
construction_type enum: string | |
contract_type enum: string | |
template_project_id string: UUID | ID of an existing BIM 360 project to use as a template
for this new project. To verify the project ID, see
Note that the BIM 360 Field service needs to have been
activated for the existing project.
Omitting this attribute will result in an empty project, but
specifying a valid ID will copy project settings to the newly
created project. Project settings include issue templates,
task templates, and checklist templates, but exclude data
such as documents, issues, and checklists.
Note that the
project_type of the specified project does
not have to be Template Project , though this is a
typical use case. |
include_locations boolean | Whether to copy location settings from
template_project_id Default value:
false |
include_companies boolean | Whether to copy the companies list from
template_project_id Default value:
false |
* Required
Response
HTTP Status Code Summary
201 Created | A new resource has been successfully created. |
400 Bad Request | The request could not be understood by the server due to malformed syntax. |
403 Forbidden | Unauthorized |
404 Not Found | The resource cannot be found. |
409 Conflict | The request could not be completed due to a conflict with the current state of the resource. |
422 Unprocessable Entity | The request was unable to be followed due to restrictions. |
500 Internal Server Error | An unexpected error occurred on the server. |
Response
Body Structure (201)
A successful response is the created project, a flat JSON object with the following attributes:
id string: UUID | Project ID |
account_id string: UUID | Account ID |
name string | Name of the project
Max length: 255
|
start_date date | The starting date of a project; must be earlier than
end_date Format:
YYYY-MM-DD |
end_date date | The ending date of a project; must be later than
start_date Format:
YYYY-MM-DD |
project_type string | The type of project; accepts preconfigured and customized project types
Max length: 255
Refer to the preconfigured
project_type list inthe Parameters guide.
|
value float | Monetary value of the project |
currency enum: string | |
status enum: string | The status of project.
Possible values:
active : project is active with at least one project admin addedpending : project has been created but pending becuase no project admin addedinactive : project is suspendedarchived : project is archived and displayed only in the archived list |
job_number string | Project job number to connect a BIM 360 project to project or job in a financial or ERP system.
Max length: 100
|
address_line_1 string | Project address line 1
Max length: 255
|
address_line_2 string | Project address line 2
Max length: 255
|
city string | City in which project is located
Max length: 255
|
state_or_province enum: string | State or province in which project is located
Max length: 255
Note that the
state_or_province value depends on the selected country value; see the valid values in the state_or_province list in
the Parameters guide. |
postal_code string | Postal code for the project location
Max length: 255
|
country enum: string | |
business_unit_id string: UUID | The business unit ID of this project
|
timezone string | |
language enum: string | Language of the project; applicable to the BIM 360 Field service only
Possible values:
en : Englishde : German |
construction_type enum: string | |
contract_type enum: string | |
last_sign_in datetime: ISO 8601 | Timestamp of the last sign in,
YYYY-MM-DDThh:mm:ss.sssZ format |
copy_project_job_id string | The unique identifier for a job, which is generated when copying project settings and templates from a template project to the new project. This option is available only for BIM 360 Field.
Call the GET jobs/:job_id endpoint to get the status of the job. The status of the GET jobs/:job_id will indicate whether all the template data has been completely transferred to the new project.
|
Example
Successful Project Creation Using Existing Project as Template (201)
Request
curl -v 'https://developer.api.autodesk.com/hq/v1/accounts/e3d5ef8d-5c37-4b9d-925d-1e6d24753ace/projects' \
-X 'POST' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer 9ezBnx9Rd5D1xG4KMt6b72T4w0MG' \
-d '{
"name": "construction_project",
"service_types": "field",
"start_date": "2015-05-02",
"end_date": "2016-04-03",
"project_type": "office",
"value": 3000,
"currency": "USD",
"job_number": "0219-01",
"address_line_1": "The Fifth Avenue",
"address_line_2": "#301",
"city": "New York",
"state_or_province": "New York",
"postal_code": "10011",
"country": "United States",
"business_unit_id": "c17e6837-96cd-4839-868e-051a2ad65d28",
"timezone": "America/New_York",
"language": "en",
"construction_type": "Renovation",
"contract_type": "Design-Bid",
"template_project_id": "fda4ab9e-ab82-4ba9-8d6c-ae7dbd7cee31",
"include_companies": "true",
"include_locations": "false"
}'
Show More
Response
{
"id": "80793a28-f9b1-4888-9533-5f00cddcd6fb",
"account_id": "e3d5ef8d-5c37-4b9d-925d-1e6d24753ace",
"name": "construction_project",
"start_date": "2015-05-01",
"end_date": "2016-05-03",
"project_type": "office",
"value": 3000.0,
"currency": "USD",
"status": "pending",
"job_number": "0219-01",
"address_line_1": "The Fifth Avenue",
"address_line_2": "#301",
"city": "New York",
"state_or_province": "New York",
"postal_code": "10011",
"country": "United States",
"business_unit_id": "c17e6837-96cd-4839-868e-051a2ad65d28",
"timezone": "America/New_York",
"language": "en",
"construction_type": "Renovation",
"contract_type": "Design-Bid",
"last_sign_in": null,
"copy_project_job_id": "aca11a7abd1747cdab996548d0e6fe25",
"created_at": "2016-04-05T07:26:20.858Z",
"updated_at": "2016-04-05T07:31:26.290Z"
}
Show More