Conversation

class canvasapi.conversation.Conversation(requester, attributes)
Parameters:
  • requester (canvasapi.requester.Requester) – The requester to pass HTTP requests through.

  • attributes (dict) – The JSON object to build this object with.

add_message(body, **kwargs)

Add a message to a conversation.

Calls:

POST /api/v1/conversations/:id/add_message

Parameters:

body (str) – The body of the conversation.

Returns:

A conversation with only the most recent message.

Return type:

canvasapi.account.Conversation

add_recipients(recipients, **kwargs)

Add a recipient to a conversation.

Calls:

POST /api/v1/conversations/:id/add_recipients

Parameters:

recipients (list of str) – A list of string format recipient ids. These may be user ids or course/group ids prefixed with ‘course_’ or ‘group_’ respectively, e.g. recipients[‘1’, ‘2’, ‘course_3’]

Return type:

canvasapi.account.Conversation

delete(**kwargs)

Delete a conversation.

Calls:

DELETE /api/v1/conversations/:id

Return type:

bool

delete_messages(remove, **kwargs)

Delete messages from this conversation.

Note that this only affects this user’s view of the conversation. If all messages are deleted, the conversation will be as well.

Calls:

POST /api/v1/conversations/:id/remove_messages

Parameters:

remove (list of str) – List of message ids to be removed.

Return type:

dict

edit(**kwargs)

Update a conversation.

Calls:

PUT /api/v1/conversations/:id

Return type:

bool