Class is a flexible dimension that can be defined in a company and used to track just about anything. You can rename the class dimension and add custom fields if needed, and then select a class and provide values for the fields in applicable transactions. You can use the data to create custom reports that provide important business insights.
Note that renaming the class dimension in the UI does not change the name of this object in the API. You still use class
in API requests.
Returns up to 100 object references from the collection with a key, ID, and link for each object. This operation is mostly for use in testing; use the query service to find objects that meet certain criteria and specify the properties that are returned.
OK
Bad Request
{- "ia::result": [
- {
- "key": "1",
- "id": "Class_1",
- "href": "/objects/company-config/class/1"
}, - {
- "key": "2",
- "id": "Class_2",
- "href": "/objects/company-config/class/2"
}
], - "ia::meta": {
- "totalCount": 2,
- "start": 1,
- "pageSize": 100,
- "next": null,
- "previous": null
}
}
Creates a new class. You can think of this as adding a new value to the dimension that you can use to tag transactions for reporting.
Class object to create
id required | string Unique ID for the class. Example: "1-Goods" | ||||
name required | string Name of the class. Example: "Goods" | ||||
description | string Description of the class. Example: "Goods available for donations" | ||||
status | string Default: "active" Status of the dimension object:
Example: "active" | ||||
object Parent class, for class hierarchies. | |||||
|
Created
Bad Request
{- "id": "SW",
- "name": "Software",
- "description": "All software titles",
- "status": "active"
}
{- "ia::result": {
- "key": "1",
- "id": "SW",
- "href": "/objects/company-config/class/1"
}, - "ia::meta": {
- "totalCount": 1
}
}
Returns detailed information for a specified class.
key required | string System-assigned key for the class. Example: 43 |
OK
Bad Request
{- "ia::result": {
- "key": "2",
- "id": "SS",
- "name": "Software & Services",
- "description": "Software & Services",
- "status": "active",
- "parent": {
- "key": "1",
- "id": "3",
- "name": "Heath Care",
- "href": "/objects/company-config/class/1"
}, - "audit": {
- "createdDateTime": "2024-06-28T18:11:36Z",
- "modifiedDateTime": "2024-06-28T18:11:36Z",
- "createdByUser": {
- "key": "1",
- "href": "/objects/company-config/user/1"
}, - "createdBy": "1",
- "modifiedByUser": {
- "key": "1",
- "href": "/objects/company-config/user/1"
}, - "modifiedBy": "1"
}, - "locationKey": null,
- "entity": {
- "key": null,
- "id": null,
- "name": null
}, - "href": "/objects/company-config/class/2"
}, - "ia::meta": {
- "totalCount": 1,
- "totalSuccess": 1,
- "totalError": 0
}
}
Updates an existing class by setting field values. Any fields not provided remain unchanged.
key required | string System-assigned key for the class. Example: 43 |
name | string Name of the class. Example: "Goods" | ||||
description | string Description of the class. Example: "Goods available for donations" | ||||
status | string Default: "active" Status of the dimension object:
Example: "active" | ||||
object Parent class, for class hierarchies. | |||||
|
OK
Bad Request
{- "name": "Root one"
}
{- "ia::result": {
- "key": "1",
- "id": "Class1",
- "href": "/objects/company-config/class/1"
}, - "ia::meta": {
- "totalCount": 1,
- "totalSuccess": 1,
- "totalError": 0
}
}
Deletes a class. You can delete a class if it is not being used or referenced. Deleted classes cannot be recovered.
key required | string System-assigned key for the class. Example: 43 |
No Content
Bad Request
{- "ia::result": {
- "ia::error": {
- "code": "invalidRequest",
- "message": "A POST request requires a payload",
- "errorId": "REST-1028",
- "additionalInfo": {
- "messageId": "IA.REQUEST_REQUIRES_A_PAYLOAD",
- "placeholders": {
- "OPERATION": "POST"
}, - "propertySet": { }
}, - "supportId": "Kxi78%7EZuyXBDEGVHD2UmO1phYXDQAAAAo"
}
}, - "ia::meta": {
- "totalCount": 1,
- "totalSuccess": 0,
- "totalError": 1
}
}