generated: '2026-07-15'
method: generated
source: openapi/teachable-admin-openapi.yml, openapi/teachable-oauth-openapi.yml
description: Recommended x-agentic-access execution contracts, classified heuristically from
  the OpenAPI. A governance starting point for exposing this API to AI agents — review and bind
  audience per deployment. See research/curity/agentic-governance/.
summary:
  operations: 28
  by_action_class:
    connected: 22
    acting: 6
  by_consequence:
    read: 22
    write: 6
  human_in_the_loop_required: 0
operations:
- path: /courses
  method: get
  operationId: listCourses
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /courses/{course_id}
  method: get
  operationId: getCourse
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /courses/{course_id}/enrollments
  method: get
  operationId: listCourseEnrollments
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /courses/{course_id}/progress
  method: get
  operationId: getCourseProgress
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /courses/{course_id}/lectures/{lecture_id}
  method: get
  operationId: getLecture
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /courses/{course_id}/lectures/{lecture_id}/mark_complete
  method: post
  operationId: markLectureComplete
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /courses/{course_id}/lectures/{lecture_id}/videos/{video_id}
  method: get
  operationId: getVideo
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /courses/{course_id}/lectures/{lecture_id}/quizzes
  method: get
  operationId: listQuizzes
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /courses/{course_id}/lectures/{lecture_id}/quizzes/{quiz_id}
  method: get
  operationId: getQuiz
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /courses/{course_id}/lectures/{lecture_id}/quizzes/{quiz_id}/responses
  method: get
  operationId: getQuizResponses
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /enroll
  method: post
  operationId: enrollUser
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /unenroll
  method: post
  operationId: unenrollUser
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /users
  method: get
  operationId: listUsers
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /users
  method: post
  operationId: createUser
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /users/{user_id}
  method: get
  operationId: getUser
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /users/{user_id}
  method: patch
  operationId: updateUser
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /pricing_plans
  method: get
  operationId: listPricingPlans
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /pricing_plans/{pricing_plan_id}
  method: get
  operationId: getPricingPlan
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /transactions
  method: get
  operationId: listTransactions
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /webhooks
  method: get
  operationId: listWebhooks
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /webhooks/{webhook_id}/events
  method: get
  operationId: listWebhookEvents
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /current_user/me
  method: get
  operationId: getCurrentUser
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - email:read
    - name:read
    token:
      max-ttl: 3600
    audit: none
- path: /current_user/courses
  method: get
  operationId: listCurrentUserCourses
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - courses:read
    token:
      max-ttl: 3600
    audit: none
- path: /current_user/courses/{course_id}
  method: get
  operationId: getCurrentUserCourse
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - courses:read
    token:
      max-ttl: 3600
    audit: none
- path: /current_user/courses/{course_id}/progress
  method: get
  operationId: getCurrentUserCourseProgress
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - courses:read
    token:
      max-ttl: 3600
    audit: none
- path: /current_user/courses/{course_id}/lectures/{lecture_id}
  method: get
  operationId: getCurrentUserLecture
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - courses:read
    token:
      max-ttl: 3600
    audit: none
- path: /current_user/courses/{course_id}/lectures/{lecture_id}/mark_complete
  method: post
  operationId: markCurrentUserLectureComplete
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - courses:read
    - courses:update
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /current_user/courses/{course_id}/lectures/{lecture_id}/videos/{video_id}
  method: get
  operationId: getCurrentUserVideo
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - courses:read
    token:
      max-ttl: 3600
    audit: none