This document provides an overview of the November 27, 2023 Karbon API release.
In this release we have added Fee Type and Fee Value on the
JSONCopied!
WorkItems
- JSONCopied!
POST WorkItem, PUT WorkItem
- JSONCopied!
GET WorkItem
JSONCopied!
POST WorkItem and PUT WorkItem
Endpoint:
JSONCopied!
https://api.karbonhq.com/v3/WorkItems
When used with
JSONCopied!
POST
JSONCopied!
PUT
JSONCopied!
FeeSettings
JSONCopied!
FeeType
JSONCopied!
FeeValue
Valid values for
JSONCopied!
FeeType
JSONCopied!
TimeAndMaterials
JSONCopied!
NonBillable
JSONCopied!
FixedFee
If the
JSONCopied!
FeeType
JSONCopied!
TimeAndMaterials
JSONCopied!
NonBillable
JSONCopied!
FeeValue
JSONCopied!
null
When
JSONCopied!
FeeType
JSONCopied!
FixedFee
JSONCopied!
FeeValue
Example use case
You want to create a Work Item to be
JSONCopied!
FixedFee
Include the following JSON object in the request payload:
JSONCopied!"FeeSettings": {
"FeeType": "FixedFee",
"FeeValue": 1210.5000
}
Making a
JSONCopied!
POST
JSONCopied!
https://api.karbonhq.com/v3/WorkItems
JSONCopied!
GET WorkItem
Endpoint:
JSONCopied!
https://api.karbonhq.com/v3/WorkItems
When used with
JSONCopied!
GET
JSONCopied!
FeeSettings
JSONCopied!
FeeSettings
Example use case
You want to retrieve a Work Item and its Fee Settings which were previously defined in the UI in Karbon as Time and Materials. Endpoint:
JSONCopied!
https://api.karbonhq.com/v3/WorkItems/{WorkItemkey}
This will return a JSON response with a Work Item as the payload, including the
JSONCopied!
FeeSettings
JSONCopied!"FeeSettings": {
"FeeType": "TimeAndMaterials",
"FeeValue": null
}