Release Notes

May 31, 2022

We have made updates to Karbon's public API that impact 3 endpoints: WebhookSubscriptions, Notes, and Comments; and the Comment webhook.

High level summary

This document outlines the changes to Karbon's public API as a result of the Karbon release on May 31, 2022.

In summary, the API changes impact 3 endpoints and a webhook:

  1. JSONCopied!
    WebhookSubscriptions
    (existing endpoint)
  2. JSONCopied!
    Notes
    (enhanced the
    JSONCopied!
    POST
    method and added
    JSONCopied!
    GET
    method)
  3. JSONCopied!
    Comments
    (new endpoint with
    JSONCopied!
    GET
    method)
  4. Introduced Webhook for
    JSONCopied!
    Comment

WebhookSubscriptions

  • To subscribe to

    JSONCopied!
    Notes
    and
    JSONCopied!
    Comments
    webhooks, use
    JSONCopied!
    WebhookType
    as
    JSONCopied!
    Note
    instead of
    JSONCopied!
    ContentItem
    :

    JSONCopied!
    /v3/WebhookSubscriptions/Note

  • JSONCopied!
    GET
    method will require a
    JSONCopied!
    WebhookType
    (
    JSONCopied!
    Contact
    ,
    JSONCopied!
    Work
    or
    JSONCopied!
    Note
    ) to retrieve information. Providing no
    JSONCopied!
    WebhookType
    will throw a validation error

  • Likewise for

    JSONCopied!
    POST
    method, a proper
    JSONCopied!
    WebhookType
    will be required and blanks will not be accepted (prompting a validation error)

Notes

  • The existing

    JSONCopied!
    POST
    method in this endpoint has been enhanced to create
    JSONCopied!
    Notes
    on
    JSONCopied!
    Contacts
    ,
    JSONCopied!
    WorkItem
    or both together

  • JSONCopied!
    GET
    method has been introduced to retrieve a
    JSONCopied!
    Note
    along with its
    JSONCopied!
    Comments
    and
    JSONCopied!
    Timelines
    :

    JSONCopied!
    /v3/Notes/{NoteKey}

Comments

  • A new endpoint with

    JSONCopied!
    GET
    method has been introduced to retrieve individual
    JSONCopied!
    Comments
    :

    JSONCopied!
    /v3/Comments/{CommentKey}

Webhook for Comments

Webhook for

JSONCopied!
Comments
can be subscribed to using
JSONCopied!
WebhookType
as
JSONCopied!
Note
as mentioned above.

If you have already subscribed for

JSONCopied!
Note
webhook, then no separate subscription for
JSONCopied!
Comment
is required. If you are subscribing for
JSONCopied!
Comments
or
JSONCopied!
Notes
for the first time, then please use the following endpoint for it as mentioned earlier:

JSONCopied!
/v3/WebhookSubscriptions/Note