Resource

Create Resource

POST

Create a new Resource within your Workspace.

A Resource represents a person, material, or tool that is used within your Projects. When you attach a Resources to more than one Task, the software will schedule the usage of your Resource so that it is not allocated to more than one Task at the same time. The users in your Workspace are also considered Resources. To invite a new User to your Workspace, create a new Resource for that user.

Request

This endpoint expects an object.
firstName
stringRequired
The first name of the person Resource. Applies to personnel Resources only.
lastName
stringOptional
The last name of the person Resource. Applies to personnel Resources only.
email
stringOptional
The email address of this Resource.
hourlyRate
doubleOptional
The basic hourly rate for this Resource.
phone
stringOptional
The phone number associated with this Resource.
city
stringOptional
The city where this Resource is located.
state
stringOptional
The state or region where this Resource is located. This value is not constrained to a list of known states or regions.
countryCode
stringOptional
A text field indicating the country in which this Resource is located. This value must be one of the following: US, NZ, AU.
notes
stringOptional
Free-form text notes about this Resource. You may use this field to store extra information about the Resource.
roleId
stringOptional
The Role Id associated with this Resource. Applies to personnel Resources only.
teamIds
list of stringsOptional
The list of ResourceTeams to which this Resource belongs.
skillIds
list of stringsOptional
The list of ResourceSkills possessed by this Resource.
country
stringOptional
Deprecated - this property is no longer being used. Please pass in Country data on the CountryCode property. A text field indicating the country in which this Resource is located. This value is not constrained to the list of known ISO 3166 country names or codes.
role
stringOptional
Deprecated - this property is no longer being used. Please pass in Role data on the RoleId property The Role privileges associated with this Resource. Applies to personnel Resources only.
teams
list of stringsOptional
Deprecated - this property is no longer being used. Please pass in Team data on the TeamIds property The list of ResourceTeams to which this Resource belongs.
skills
list of stringsOptional
Deprecated - this property is no longer being used. Please pass in Skill data on the SkillIds property The list of ResourceSkills possessed by this Resource.

Response

This endpoint returns an object
error
objectOptional
If the API call failed, this will contain information about the error that occurred.
success
booleanOptional
True if the API call succeeded; false otherwise.
hasError
booleanOptional
True if the API call failed.
statusCode
enumOptional
The HTTP code of the response.
data
objectOptional
A Resource represents a person, material, or tool that is used within your Projects. When you attach a Resources to more than one Task, the software will schedule the usage of your Resource so that it is not allocated to more than one Task at the same time. The users in your Workspace are also considered Resources. To invite a new User to your Workspace, create a new Resource for that user.
POST
1curl -X POST /api/data/resources \
2 -H "Authorization: Bearer <token>" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "firstName": "firstName"
6}'
200
Successful
1{
2 "error": {
3 "technicalError": "technicalError",
4 "additionalErrors": [
5 "additionalErrors"
6 ],
7 "message": "message"
8 },
9 "success": true,
10 "hasError": true,
11 "statusCode": "Continue",
12 "data": {
13 "id": "id",
14 "firstName": "firstName",
15 "lastName": "lastName",
16 "email": "email",
17 "hourlyRate": 1.1,
18 "phone": "phone",
19 "city": "city",
20 "state": "state",
21 "country": "country",
22 "notes": "notes",
23 "approver": {
24 "id": "id",
25 "name": "name"
26 },
27 "teams": [
28 {}
29 ],
30 "skills": [
31 {}
32 ],
33 "onlineDateTime": "2024-01-15T09:30:00Z",
34 "role": "role",
35 "isActive": true
36 }
37}