February 8, 2024

The February 8, 2024 Karbon API release includes two changes:

1. API access can be configured to allow access to Hidden and Private contacts.
2. The
   JSONCopyCopied!

   DeadlineDate
   property has been added to the
   JSONCopyCopied!

   WorkItems
   API endpoint - this makes it possible to set, retrieve and update a deadline date on a Work Item.

API access to Hidden and Private contacts

Each Karbon API application can now be configured to enable access to Hidden and/or Private contacts. Enabling either or both of these settings will return contacts and associated data (such as

) in Karbon API responses, where previously a 404 would be returned.

NOTE: This configuration change must be requested via Karbon Support and be approved by an administrator in the connected Karbon account. You can make this request by reaching out to support directly, or via the issue form.

Where a single API application is connected to multiple Karbon accounts, each Karbon account has its own unique settings, i.e. Karbon Account A can have access to Hidden Contacts, whilst Karbon Account B has neither access to Hidden nor Private Contacts.

Deadline Date

NOTE: Whilst this API change is available to all API users, as at the time of writing the changes to the Karbon Application are only available to firms enrolled in the Deadlines BETA, this means that Deadline Dates you set using the API may not be visible in Karbon. You can read more about the Deadlines BETA in our January 2024 release notes.

1. JSONCopyCopied!

   POST WorkItem
   ,
   JSONCopyCopied!

   PUT WorkItem
2. JSONCopyCopied!

   PATCH WorkItem
3. JSONCopyCopied!

   GET
   a list of
   JSONCopyCopied!

   WorkItems
   , sorting and filtering the list
4. JSONCopyCopied!

   GET
   a single Work Item

---

JSONCopyCopied!

POST WorkItem and PUT WorkItem

Endpoint:

When used with

and methods, this end point now allows you to optionally specify a property.

Valid values for

are or an ISO8061 datestamp or timestamp, e.g. or .

Example use case

You want to create a Work Item with a

of February 1, 2024.

Include the following JSON object in the request payload:

Making a

request to:

---

JSONCopyCopied!

PATCH WorkItem

Endpoint:

When used with

methods, this end point now allows you to update only the property, avoiding the need to update the whole Work Item record.

As per the

and requests, valid values for are or an ISO8061 date stamp or time stamp, e.g. or .

Example use case

You want to create a Work Item with a

of February 2, 2024.

Use the following JSON as the complete request payload:

Making a

request to:

---

JSONCopyCopied!

GET WorkItems

Endpoint:

When used with

method, this end point will return a property for each Work Item returned.

Example use case

You want to retrieve a list of

with a on or after March 1, 2024. The list should be sorted with by ascending (dates are ordered from March 1, 2024 into the future)

This will return a JSON response with a list of work items as the payload, including the

property for each Work Item returned.

---

Endpoint:

When used with

method, this end point will return a property for the supplied . This will be if no is set.

Example use case

You want to retrieve a Work Item and its

Endpoint:

This will return a JSON response with a work item as the payload, including the

property with the date represented as an ISO8601 timestamp: