Canvas

Canvas Ai Conversations API

The Ai Conversations API from Canvas — 6 operation(s) for ai conversations.

Documentation GitHub OpenAPI

Operations 9

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v1/courses/{course_id}/ai_experiences/{ai_experience_id}/conversations/{id} View a student's AI conversation · Show conversation #

Ask an LLM

“As a teacher, can I read a specific student's conversation with an AI experience?”

“How do I open one AI conversation by its id?”

Tell an agent

Show AI conversation {id} in experience {ai_experience_id} of course {course_id}.

Open conversation {id} for AI experience {ai_experience_id} in course {course_id}.

DELETE /v1/courses/{course_id}/ai_experiences/{ai_experience_id}/conversations/{id} End an AI conversation session · Delete AI conversation #

Ask an LLM

“How do I end the current AI conversation session?”

“Can I close out a conversation with an AI experience?”

Tell an agent destructive · confirm first

End AI conversation {id} in experience {ai_experience_id}, course {course_id}.

Delete conversation {id} from AI experience {ai_experience_id} in course {course_id}.

GET /v1/courses/{course_id}/ai_experiences/{ai_experience_id}/conversations Get my active AI conversation · Get active conversation #

Ask an LLM

“Do I already have an ongoing conversation with this AI experience?”

“Which AI conversation is currently active for me?”

Tell an agent

Get my active conversation for AI experience {ai_experience_id} in course {course_id}.

Resume my current chat with AI experience {ai_experience_id} in course {course_id}.

POST /v1/courses/{course_id}/ai_experiences/{ai_experience_id}/conversations Start a new AI conversation · Create AI conversation #

Ask an LLM

“How do I start a fresh conversation with a course's AI experience?”

“Can I initialize a new chat session with an AI experience?”

Tell an agent

Start a new conversation with AI experience {ai_experience_id} in course {course_id}.

Open a fresh AI chat for experience {ai_experience_id} in course {course_id}.

POST /v1/courses/{course_id}/ai_experiences/{ai_experience_id}/conversations/{id}/messages Send a message to an AI conversation · Post message to conversation #

Ask an LLM

“How do I send a message and get the AI's reply in a conversation?”

“Can I continue an existing AI conversation with a new prompt?”

Tell an agent

Send {message} to conversation {id} in AI experience {ai_experience_id}, course {course_id}.

Ask the AI {message} in conversation {id} (experience {ai_experience_id}, course {course_id}).

GET /v1/courses/{course_id}/ai_experiences/{ai_experience_id}/conversations/{id}/evaluation Read a conversation's stored evaluation · Get conversation evaluation #

Ask an LLM

“Can I see the latest saved evaluation of an AI conversation without rerunning it?”

“Why would a conversation's evaluation come back empty?”

Tell an agent

Get the stored evaluation for conversation {id} in AI experience {ai_experience_id}, course {course_id}.

Show the last evaluation of conversation {id} (experience {ai_experience_id}, course {course_id}).

POST /v1/courses/{course_id}/ai_experiences/{ai_experience_id}/conversations/{id}/evaluation Generate or reset a conversation's evaluation · Generate conversation evaluation #

Ask an LLM

“How do I have the LLM re-evaluate a student's AI conversation?”

“Is generating a conversation evaluation rate-limited, and does it replace the old one?”

Tell an agent

Generate a new evaluation for conversation {id} in AI experience {ai_experience_id}, course {course_id}.

Rerun the evaluation of conversation {id} (experience {ai_experience_id}, course {course_id}).

POST /v1/courses/{course_id}/ai_experiences/{ai_experience_id}/conversations/{id}/messages/{message_id}/feedback Like or dislike an AI reply · Create feedback on a conversation message #

Ask an LLM

“Can I give a thumbs up or down on an AI-generated message?”

“How do I leave written feedback with my vote on an AI reply?”

Tell an agent

Vote {vote} on message {message_id} in conversation {id}, experience {ai_experience_id}, course {course_id}.

Rate AI message {message_id} as {vote} with note {feedback_message} (conversation {id}, experience {ai_experience_id}, course {course_id}).

DELETE /v1/courses/{course_id}/ai_experiences/{ai_experience_id}/conversations/{id}/messages/{message_id}/feedback/{feedback_id} Remove my vote on an AI reply · Delete feedback on a conversation message #

Ask an LLM

“How do I take back a like or dislike I gave an AI message?”

“Can I toggle off feedback on an AI reply?”

Tell an agent destructive · confirm first

Remove feedback {feedback_id} from message {message_id} in conversation {id}, experience {ai_experience_id}, course {course_id}.

Undo vote {feedback_id} on AI message {message_id} (conversation {id}, experience {ai_experience_id}, course {course_id}).

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/canvas:canvas-ai-conversations-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Canvas LMS REST Ai Conversations API
  version: v1
  summary: The complete Canvas LMS REST API, converted from the Swagger 1.2 documents Instructure publishes under https://canvas.instructure.com/doc/api/.
  description: The Canvas LMS REST API covers courses, assignments, quizzes, grades, users, enrollments, accounts, files, modules, rubrics, submissions, SIS imports, LTI, analytics and account administration.
  contact:
    name: Instructure Canvas
    url: https://canvas.instructure.com/doc/api/
  license:
    name: AGPL-3.0
    url: https://github.com/instructure/canvas-lms/blob/master/LICENSE
servers:
- url: https://canvas.instructure.com/api
  description: Instructure-hosted Canvas (canvas.instructure.com)
- url: https://{canvas_host}/api
  description: Any Canvas instance; Canvas is multi-tenant and self-hostable, so the host is the institution's Canvas domain.
  variables:
    canvas_host:
      default: canvas.instructure.com
      description: Your institution's Canvas hostname, e.g. school.instructure.com
security:
- bearerAuth: []
- oauth2: []
tags:
- name: Ai Conversations
  x-resource: ai_conversations
  externalDocs:
    url: https://canvas.instructure.com/doc/api/ai_conversations.html
paths:
  /v1/courses/{course_id}/ai_experiences/{ai_experience_id}/conversations/{id}:
    get:
      tags:
      - Ai Conversations
      operationId: show_conversation
      summary: Show conversation
      description: Get a specific conversation by ID (for teachers viewing student conversations)
      parameters:
      - name: course_id
        in: path
        schema:
          type: string
        required: true
        description: ID
      - name: ai_experience_id
        in: path
        schema:
          type: string
        required: true
        description: ID
      - name: id
        in: path
        schema:
          type: string
        required: true
        description: ID
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: string
                x-canvas-declared-type: '{Object} Hash with conversation details including messages'
      externalDocs:
        url: https://canvas.instructure.com/doc/api/ai_conversations.html
    delete:
      tags:
      - Ai Conversations
      operationId: delete_ai_conversation
      summary: Delete AI conversation
      description: End the current conversation session
      parameters:
      - name: course_id
        in: path
        schema:
          type: string
        required: true
        description: ID
      - name: ai_experience_id
        in: path
        schema:
          type: string
        required: true
        description: ID
      - name: id
        in: path
        schema:
          type: string
        required: true
        description: ID
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: string
                x-canvas-declared-type: '{Object} Success message'
      externalDocs:
        url: https://canvas.instructure.com/doc/api/ai_conversations.html
  /v1/courses/{course_id}/ai_experiences/{ai_experience_id}/conversations:
    get:
      tags:
      - Ai Conversations
      operationId: get_active_conversation
      summary: Get active conversation
      description: Get the active conversation for the current user and AI experience
      parameters:
      - name: course_id
        in: path
        schema:
          type: string
        required: true
        description: ID
      - name: ai_experience_id
        in: path
        schema:
          type: string
        required: true
        description: ID
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: string
                x-canvas-declared-type: '{Object} Hash with id and messages array, or empty object if no active conversation'
      externalDocs:
        url: https://canvas.instructure.com/doc/api/ai_conversations.html
    post:
      tags:
      - Ai Conversations
      operationId: create_ai_conversation
      summary: Create AI conversation
      description: Initialize a new conversation with the AI experience
      parameters:
      - name: course_id
        in: path
        schema:
          type: string
        required: true
        description: ID
      - name: ai_experience_id
        in: path
        schema:
          type: string
        required: true
        description: ID
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: string
                x-canvas-declared-type: '{Object} Hash with conversation_id and initial messages array'
      externalDocs:
        url: https://canvas.instructure.com/doc/api/ai_conversations.html
  /v1/courses/{course_id}/ai_experiences/{ai_experience_id}/conversations/{id}/messages:
    post:
      tags:
      - Ai Conversations
      operationId: post_message_to_conversation
      summary: Post message to conversation
      description: Send a message to an existing conversation and get the AI response
      parameters:
      - name: course_id
        in: path
        schema:
          type: string
        required: true
        description: ID
      - name: ai_experience_id
        in: path
        schema:
          type: string
        required: true
        description: ID
      - name: id
        in: path
        schema:
          type: string
        required: true
        description: ID
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                message:
                  type: string
                  description: The user's message to send to the AI
              required:
              - message
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                message:
                  type: string
                  description: The user's message to send to the AI
              required:
              - message
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: string
                x-canvas-declared-type: '{Object} Hash with id and updated messages array'
      externalDocs:
        url: https://canvas.instructure.com/doc/api/ai_conversations.html
  /v1/courses/{course_id}/ai_experiences/{ai_experience_id}/conversations/{id}/evaluation:
    get:
      tags:
      - Ai Conversations
      operationId: get_conversation_evaluation
      summary: Get conversation evaluation
      description: 'Fetch the latest stored evaluation for a conversation from the

        llm-conversation service. Reads only — does not run the LLM and is not

        rate-limited. `evaluation` is null when none has been generated yet (llma

        returns 200 + null, never 404, so this is distinguishable from an outage).

        `stale` is true when the AI experience was edited after the stored

        evaluation was generated.'
      parameters:
      - name: course_id
        in: path
        schema:
          type: string
        required: true
        description: ID
      - name: ai_experience_id
        in: path
        schema:
          type: string
        required: true
        description: ID
      - name: id
        in: path
        schema:
          type: string
        required: true
        description: ID
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: string
                x-canvas-declared-type: '{Object} Hash with { id, evaluation, stale }'
      externalDocs:
        url: https://canvas.instructure.com/doc/api/ai_conversations.html
    post:
      tags:
      - Ai Conversations
      operationId: generate_conversation_evaluation
      summary: Generate conversation evaluation
      description: 'Run the LLM to (re)generate an evaluation for a conversation and persist it

        in the llm-conversation service. Rate-limited. Also the Reset path — a fresh

        run replaces any prior stored evaluation.'
      parameters:
      - name: course_id
        in: path
        schema:
          type: string
        required: true
        description: ID
      - name: ai_experience_id
        in: path
        schema:
          type: string
        required: true
        description: ID
      - name: id
        in: path
        schema:
          type: string
        required: true
        description: ID
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: string
                x-canvas-declared-type: '{Object} Hash with { id, evaluation }'
      externalDocs:
        url: https://canvas.instructure.com/doc/api/ai_conversations.html
  /v1/courses/{course_id}/ai_experiences/{ai_experience_id}/conversations/{id}/messages/{message_id}/feedback:
    post:
      tags:
      - Ai Conversations
      operationId: create_feedback_on_conversation_message
      summary: Create feedback on a conversation message
      description: 'Submit a like or dislike vote on an AI-generated message.


        Ownership: load_conversation gates this action — only the conversation owner

        or a course manager reaches here. Sub-resource (message_id within the

        conversation) scoping is delegated to llma.'
      parameters:
      - name: course_id
        in: path
        schema:
          type: string
        required: true
        description: ID
      - name: ai_experience_id
        in: path
        schema:
          type: string
        required: true
        description: ID
      - name: id
        in: path
        schema:
          type: string
        required: true
        description: ID
      - name: message_id
        in: path
        schema:
          type: string
        required: true
        description: llm-conversation message UUID
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                vote:
                  type: string
                  description: '"liked" or "disliked"'
                feedback_message:
                  type: string
                  description: optional text for dislike
              required:
              - vote
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                vote:
                  type: string
                  description: '"liked" or "disliked"'
                feedback_message:
                  type: string
                  description: optional text for dislike
              required:
              - vote
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: string
                x-canvas-declared-type: '{Object} Hash with feedback record'
      externalDocs:
        url: https://canvas.instructure.com/doc/api/ai_conversations.html
  /v1/courses/{course_id}/ai_experiences/{ai_experience_id}/conversations/{id}/messages/{message_id}/feedback/{feedback_id}:
    delete:
      tags:
      - Ai Conversations
      operationId: delete_feedback_on_conversation_message
      summary: Delete feedback on a conversation message
      description: 'Remove a previously submitted vote (toggling off like/dislike).


        Ownership: load_conversation gates this action — only the conversation owner

        or a course manager reaches here. Sub-resource (message_id, feedback_id within

        the conversation) scoping is delegated to llma.'
      parameters:
      - name: course_id
        in: path
        schema:
          type: string
        required: true
        description: ID
      - name: ai_experience_id
        in: path
        schema:
          type: string
        required: true
        description: ID
      - name: id
        in: path
        schema:
          type: string
        required: true
        description: ID
      - name: message_id
        in: path
        schema:
          type: string
        required: true
        description: ID
      - name: feedback_id
        in: path
        schema:
          type: string
        required: true
        description: ID
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: string
                x-canvas-declared-type: '{Object} Success response'
      externalDocs:
        url: https://canvas.instructure.com/doc/api/ai_conversations.html
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Canvas OAuth2 access token sent as "Authorization: Bearer <token>". See https://canvas.instructure.com/doc/api/file.oauth.html'
    oauth2:
      type: oauth2
      description: Canvas OAuth2. See https://canvas.instructure.com/doc/api/file.oauth.html and https://canvas.instructure.com/doc/api/file.oauth_endpoints.html
      flows:
        authorizationCode:
          authorizationUrl: https://canvas.instructure.com/login/oauth2/auth
          tokenUrl: https://canvas.instructure.com/login/oauth2/token
          refreshUrl: https://canvas.instructure.com/login/oauth2/token
          scopes: {}
externalDocs:
  description: Canvas LMS REST API Documentation
  url: https://canvas.instructure.com/doc/api/
x-generated-from: https://canvas.instructure.com/doc/api/api-docs.json
x-provenance:
  method: derived
  derived_by: API Evangelist enrichment pipeline (Swagger 1.2 -> OpenAPI 3.1 conversion)
  source: openapi/_original/swagger-1.2/*.json (144 verbatim first-party Swagger 1.2 documents)
  source_url: https://canvas.instructure.com/doc/api/api-docs.json
  fetched: '2026-09-05'
  http_status: 200

Canvas Ai Conversations API

Operations 9

Documentation

Specifications

SDKs

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification