Release Notes

November 27, 2023

Set and Retrieve Fee Type and Fee Value on a Work Item.

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
API endpoint - this makes it possible to set, retrieve and update Fee Settings on a Work Item.

  1. JSONCopied!
    POST WorkItem, PUT WorkItem
  2. JSONCopied!
    GET WorkItem

JSONCopied!
POST WorkItem and PUT WorkItem

Endpoint:

JSONCopied!
https://api.karbonhq.com/v3/WorkItems

When used with

JSONCopied!
POST
and
JSONCopied!
PUT
methods, this end point allows you to optionally specify a
JSONCopied!
FeeSettings
object where
JSONCopied!
FeeType
and
JSONCopied!
FeeValue
can be provided.

Valid values for

JSONCopied!
FeeType
are
JSONCopied!
TimeAndMaterials
,
JSONCopied!
NonBillable
or
JSONCopied!
FixedFee
.

If the

JSONCopied!
FeeType
is specified as
JSONCopied!
TimeAndMaterials
or
JSONCopied!
NonBillable
, then
JSONCopied!
FeeValue
must be
JSONCopied!
null
.

When

JSONCopied!
FeeType
is specified as
JSONCopied!
FixedFee
, a numerical value must be provided for
JSONCopied!
FeeValue
.

Example use case

You want to create a Work Item to be

JSONCopied!
FixedFee
and have a value of 1,210.50.

Include the following JSON object in the request payload:

JSONCopied!
"FeeSettings": { "FeeType": "FixedFee", "FeeValue": 1210.5000 }

Making a

JSONCopied!
POST
request to:
JSONCopied!
https://api.karbonhq.com/v3/WorkItems


JSONCopied!
GET WorkItem

Endpoint:

JSONCopied!
https://api.karbonhq.com/v3/WorkItems

When used with

JSONCopied!
GET
method, this end point will return a
JSONCopied!
FeeSettings
object, when
JSONCopied!
FeeSettings
have been defined on the Work Item - either through the API of the Karbon UI.

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
object:

JSONCopied!
"FeeSettings": { "FeeType": "TimeAndMaterials", "FeeValue": null }