Position skills

A position-skill object contains the name and description of a position and skill level that can be assigned to employees for project planning.

List position skills

get/objects/projects/position-skill

Returns up to 100 position-skills from the collection with a key, ID, and link for each one. This operation is mostly for use in testing; use the query service to find position-skills that meet certain criteria and specify the properties that are returned.

Permissions and other requirements
SubscriptionProjects
ConfigurationProject & Resource Management is enabled.
User typeBusiness user with admin privileges, Project manager
PermissionsTime - List Positions and skills
SecurityOAuth2
Responses
200

OK

400

Bad Request

Request samples 
Response samples 
application/json
{
  • "ia::result": [
    • {
      • "key": "1",
      • "id": "Quantum Mechanic",
      • "href": "/objects/projects/position-skill/1"
      },
    • {
      • "key": "2",
      • "id": "Brick Layer",
      • "href": "/objects/projects/position-skill/2"
      }
    ],
  • "ia::meta": {
    • "totalCount": 2,
    • "start": 1,
    • "pageSize": 100,
    • "next": null,
    • "previous": null
    }
}
Create a position skill
post/objects/projects/position-skill
Creates a new position skill.



Permissions and other requirements



SubscriptionProjects


ConfigurationProject & Resource Management is enabled.


User typeBusiness user with admin privileges, Project manager


PermissionsTime - Add Positions and skills







SecurityOAuth2 
Request 
Request Body schema: application/json
required
id
required
string
Name of the position skill. The name appears when you assign the position or skill to an employee, as well as when you search for project resources based on qualifications. For this reason, be sure to use a name that distinguishes it from other positions and skills.


 
 Example:  "Quantum Mechanic"
description
string
Description of the position or skill. The description appears on the Positions and Skills list next to the name.


 
 Example:  "Scientist who works with very tiny wrenches."
status
string
 Default:  "active"
Object status. Active objects are fully functional. Inactive objects are essentially hidden and cannot be used or referenced.


 Enum: "active" "inactive"  
 Example:  "active"
Responses 
201
Created


400
Bad Request


Request samples 
application/json
{
  • "id": "Quantum Mechanic",
  • "description": "Scientist who works with very tiny wrenches."
}
Response samples 
application/json
{
  • "ia::result": {
    • "key": "23",
    • "id": "Quantum Mechanic",
    • "href": "/objects/projects/position-skill/23"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}
Get a position skill
get/objects/projects/position-skill/{key}
Returns detailed information for a specified position skill.



Permissions and other requirements



SubscriptionProjects


ConfigurationProject & Resource Management is enabled.


User typeBusiness user with admin privileges, Project manager


PermissionsTime - List, View Positions and skills







SecurityOAuth2 
Request 
path Parameters
key
required
string
System-assigned unique key for a position skill.


 
 Example:  23
Responses 
200
OK


400
Bad Request


Request samples 
Response samples 
application/json
{
  • "ia::result": {
    • "key": "1",
    • "id": "Quantum Mechanic",
    • "description": "Scientist who works with very tiny wrenches",
    • "status": "active",
    • "audit": {
      • "createdDateTime": "2025-04-12T00:02:45Z",
      • "modifiedDateTime": "2025-04-12T00:02:45Z",
      • "createdByUser": {
        },
      • "createdBy": "158",
      • "modifiedByUser": {
        },
      • "modifiedBy": "158"
      },
    • "entity": {
      • "key": null,
      • "id": null,
      • "name": null
      },
    • "href": "/objects/projects/position-skill/1"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}
Update a position skill
patch/objects/projects/position-skill/{key}
Updates an existing position skill by setting field values. Any fields not provided remain unchanged.



Permissions and other requirements



SubscriptionProjects


ConfigurationProject & Resource Management is enabled.


User typeBusiness user with admin privileges, Project manager


PermissionsTime - Edit Positions and skills







SecurityOAuth2 
Request 
path Parameters
key
required
string
System-assigned unique key for a position skill.


 
 Example:  23
Request Body schema: application/json
description
string
Description of the position or skill. The description appears on the Positions and Skills list next to the name.


 
 Example:  "Scientist who works with very tiny wrenches."
status
string
 Default:  "active"
Object status. Active objects are fully functional. Inactive objects are essentially hidden and cannot be used or referenced.


 Enum: "active" "inactive"  
 Example:  "active"
Responses 
200
OK


400
Bad Request


Request samples 
application/json
{
  • "description": "One who places bricks. Precisely."
}
Response samples 
application/json
{
  • "ia::result": {
    • "key": "22",
    • "id": "Brick Layer",
    • "href": "/objects/projects/position-skill/22"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}
Delete a position skill
delete/objects/projects/position-skill/{key}
Deletes a position skill. You can only delete unassigned position skills. If you no longer use a permission or skill, change its status to inactive.



Permissions and other requirements



SubscriptionProjects


ConfigurationProject & Resource Management is enabled.


User typeBusiness user with admin privileges, Project manager


PermissionsTime - Delete Positions and skills







SecurityOAuth2 
Request 
path Parameters
key
required
string
System-assigned unique key for a position skill.


 
 Example:  23
Responses 
204
No Content


400
Bad Request


Request samples 
Response samples 
application/json
{
  • "ia::result": {
    • "ia::error": {
      • "code": "invalidRequest",
      • "message": "A POST request requires a payload",
      • "errorId": "REST-1028",
      • "additionalInfo": {
        },
      • "supportId": "Kxi78%7EZuyXBDEGVHD2UmO1phYXDQAAAAo"
      }
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 0,
    • "totalError": 1
    }
}
Query position skills
post/services/core/query
Use the query service to find position skills that meet certain criteria and to specify the properties that are returned.


SecurityOAuth2 
Responses 
200
OK


400
Bad Request


Request samples 
Response samples 
application/json
{
  • "ia::result": {
    • "ia::error": {
      • "code": "invalidRequest",
      • "message": "A POST request requires a payload",
      • "errorId": "REST-1028",
      • "additionalInfo": {
        },
      • "supportId": "Kxi78%7EZuyXBDEGVHD2UmO1phYXDQAAAAo"
      }
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 0,
    • "totalError": 1
    }
}