Internal Notes

Add internal note

Create an internal note in a conversation by providing the conversation id.

SecurityApiKeyAuth
Request
path Parameters
conversationId
required
integer <int64>
Request Body schema: application/json
required

The internal note to create for a conversation

agentId
string <uuid>
createdAt
string <date-time>
message
required
string
Responses
200

The created internal note

400

Invalid value for: path parameter conversationId, Invalid value extracted from request context, Invalid value for: body, Agent was not found, Invalid date format

404

An entity in this request could not be found

500

Internal failure during request processing

post/v1/conversations/{conversationId}/notes
Request samples
application/json
{
  • "message": "A sample note",
  • "agentId": "a53b25da-f676-4c52-acac-58c9280aa23d",
  • "createdAt": "2021-12-01T12:46:36.581Z[GMT]"
}
Response samples
application/json
{
  • "data": {
    • "id": "eb31acbb-13f9-4ce7-abd3-44dd86266741",
    • "authorId": "5e8a300e-787e-47cd-af53-fc1ccc37933d",
    • "createdAt": "2021-12-01T12:46:36.581Z[GMT]",
    • "csid": 9456,
    • "message": "A sample note"
    }
}

Add internal notes

Create internal notes in a conversation by providing the conversation id.

SecurityApiKeyAuth
Request
path Parameters
conversationId
required
integer <int64>
Request Body schema: application/json
required

The list of internal notes to create for a conversation

Array of objects (CreateInternalNoteInput)
Responses
200

The created internal notes

400

Invalid value for: path parameter conversationId, Invalid value extracted from request context, Invalid value for: body

404

An entity in this request could not be found

500

Internal failure during request processing

post/v1/conversations/{conversationId}/notes/bulk
Request samples
application/json
{
  • "data": [
    • {
      • "message": "A sample note",
      • "agentId": "a53b25da-f676-4c52-acac-58c9280aa23d",
      • "createdAt": "2021-12-01T12:46:36.581Z[GMT]"
      },
    • {
      • "message": "Another sample note"
      }
    ]
}
Response samples
application/json
{
  • "data": [
    • {
      • "data": {
        • "id": "eb31acbb-13f9-4ce7-abd3-44dd86266741",
        • "authorId": "5e8a300e-787e-47cd-af53-fc1ccc37933d",
        • "createdAt": "2021-12-01T12:46:36.581Z[GMT]",
        • "csid": 9456,
        • "message": "A sample note"
        },
      • "_type": "BulkActionSuccess"
      },
    • {
      • "error": {
        • "message": "An agent with id:... cannot be found in org."
        },
      • "_type": "BulkActionFailure"
      }
    ]
}

List internal notes

Get all internal notes for a particular conversation by providing the conversation id.

SecurityApiKeyAuth
Request
path Parameters
conversationId
required
integer <int64>
Responses
200

List of internal notes for a conversation sorted from oldest to newest

400

Invalid value for: path parameter conversationId, Invalid value extracted from request context

404

An entity in this request could not be found

500

Internal failure during request processing

get/v1/conversations/{conversationId}/notes
Request samples
Response samples
application/json
{
  • "data": [
    • {
      • "id": "3346b99c-8128-4276-ac40-5f30c959e5e7",
      • "authorId": "c68f42a5-1453-497a-940f-ff36ed4f1631",
      • "createdAt": "2021-01-20T09:00:00Z",
      • "csid": 7392,
      • "message": "A note to remember"
      },
    • {
      • "id": "22b8e6b6-4576-4dc0-ab05-60f81e8b0708",
      • "authorId": "124d54bb-92d6-41c9-a675-788d6a8c821e",
      • "createdAt": "2021-01-22T12:00:00Z",
      • "csid": 7392,
      • "message": "A note to forget"
      }
    ]
}