v3

latestSwagger 2.02026-08-067506752.0 MB
message

Return a particular message by key

get/v1/org/{orgId}/message/me/{messageKey}

Path parameters

orgIdstring required

Org identifier (either id or slug)

messageKeystring required

Message key

Response

successful operation

idstring required

globally unique id

orgIdstring required

parent organization id

type'CHAT' | 'EMAIL' | 'WEB' required

type of message

notificationType'SUCCESS' | 'WARN' | 'ERROR' | 'COMMENT' | 'TASK_COMPLETED' | 'TASK_ASSIGNED' | 'REMINDER' | 'ANNOUNCEMENT' | 'PROCESS_ERROR' | 'PROCESS_DONE' | 'SHARE' required

type of notification (SUCCESS, ERR, ANNOUNCEMENT etc.)

userIdstring required

user who receives the message

contentobject

message content

titlestring

message title

messageUrlstring

link to message content (if applicable)

keystring

key of message if applicable (e.g. product-tour, import-complete-{id})

readAtstring

read timestamp

seenAtstring

seen timestamp

createIdstring

created by user id

createBehalfIdstring

created on behalf of user id

createAtstring required

created timestamp

Example response

{
  "id": "588f7ee98f138b19220041a7",
  "orgId": "588f7ee98f138b19220041a7",
  "userId": "588f7ee98f138b19220041a7",
  "readAt": "2017-01-24T13:57:52Z",
  "seenAt": "2017-01-24T13:57:52Z",
  "createId": "588f7ee98f138b19220041a7",
  "createBehalfId": "588f7ee98f138b19220041a7",
  "createAttribution": {
    "principalUserId": "588f7ee98f138b19220041a7",
    "agentUserIds": [
      "588f7ee98f138b19220041a7"
    ],
    "eventId": "588f7ee98f138b19220041a7",
    "aiChatId": "588f7ee98f138b19220041a7"
  }
}