objects
Url
/V2.0/services/data/objects
HTTP Method
GET
Description
Read an entity 
Parameters
Name Type Description
fields string[] The list of fields to read
id* entityId (string)
Result
Name Type Description
entity entity
In case of failure an error object will be returned
* indicates required fields
Samples
The following example retrieves a single task by id with its Name, StartDate, Duration and Manager name fields

GET /V2.0/services/data/objects/Task/e22ca960-73bb-4cf6-b6e8-b638ed0ab1fd?fields=Name,StartDate,Duration,Manager.Name

Response:
{
  "id": "/Task/e22ca960-73bb-4cf6-b6e8-b638ed0ab1fd",
  "Name": "New Task",
  "StartDate": "2014-11-03T08:00:00.0000000",
  "Duration": {
    "unit": "Weeks",
    "value": 3.0
  },
  "Manager": {
    "id": "/User/9bcd7df3-4f6b-4272-944c-219b65b7862a",
    "Name": "Sam"
  }
}            



Url
/V2.0/services/data/objects
HTTP Method
POST
Description
Update an entity 
Parameters
Name Type Description
entity entity
Result
Name Type Description
In case of failure an error object will be returned
* indicates required fields
Samples
The following example updates the Manager field of a task:

POST /V2.0/services/data/objects/Task/e22ca960-73bb-4cf6-b6e8-b638ed0ab1fd

{
    "Manager": "/User/9bcd7df3-4f6b-4272-944c-219b65b7862a",
    "C_MyMultiSelectPickList": ["Value1","Value2"]
}            



Url
/V2.0/services/data/objects
HTTP Method
PUT
Description
Create an entity 
Parameters
Name Type Description
entity entity
Result
Name Type Description
id entityId (string)
In case of failure an error object will be returned
* indicates required fields
Samples
The following example creates a new task under an existing task:

PUT /V2.0/services/data/objects/Task

{
    "Parent": "/Task/e22ca960-73bb-4cf6-b6e8-b638ed0ab1fd",
    "Name": "Sub Task",
    "StartDate": "2014-12-01",
    "Duration": {
        "value": 3,
        "unit": "Days"
    }
}
Response:
{
  "id": "/Task/dc84ee38-12cc-492e-b70d-d7fd660f4ae7"
}        
When creating an entity, a unique ID is generated and returned as part of the object creation process. If needed, you can also set a specific ID to the entity being created as long as you can guarantee this ID is unique.
The following example shows how to create an entity with a preset ID:

PUT /V2.0/services/data/objects/Task/1234567890

{
    "Parent": "/Task/e22ca960-73bb-4cf6-b6e8-b638ed0ab1fd",
    "Name": "Sub Task",
    "StartDate": "2014-12-01",
    "Duration": {
        "value": 3,
        "unit": "Days"
    }
}
Response:
{
  "id": "/Task/1234567890"
}        



Url
/V2.0/services/data/objects
HTTP Method
DELETE
Description
Delete an entity 
Parameters
Name Type Description
id* entityId (string)
Result
Name Type Description
In case of failure an error object will be returned
* indicates required fields
Samples
Delete an entity:

DELETE /V2.0/services/data/objects/Task/1234567890