generated: '2026-08-13'
method: generated
source: openapi/jasper-api-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: 50
  by_action_class:
    acting: 30
    connected: 20
  by_consequence:
    write: 30
    read: 20
  human_in_the_loop_required: 0
operations:
- path: /v1/attachments
  method: post
  operationId: createAttachment
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/tasks
  method: get
  operationId: listTasks
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user:read
    token:
      max-ttl: 3600
    audit: none
- path: /v1/tasks/{id}
  method: get
  operationId: getTaskById
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user:read
    token:
      max-ttl: 3600
    audit: none
- path: /v1/tasks/{id}/run
  method: post
  operationId: runTask
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/tasks/{id}/run/stream
  method: post
  operationId: runTaskStream
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/command
  method: post
  operationId: command
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/knowledge
  method: post
  operationId: uploadKnowledgeDocument
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/knowledge
  method: get
  operationId: getKnowledgeDocuments
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /v1/knowledge/{knowledgeId}
  method: get
  operationId: getKnowledgeDocument
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /v1/knowledge/{knowledgeId}
  method: patch
  operationId: updateKnowledgeDocument
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/knowledge/{knowledgeId}
  method: delete
  operationId: deleteKnowledgeDocument
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/knowledge/search
  method: post
  operationId: searchKnowledge
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/tones
  method: post
  operationId: createTone
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/tones
  method: get
  operationId: getAllTones
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /v1/tones/{toneId}
  method: get
  operationId: getTone
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /v1/tones/{toneId}
  method: patch
  operationId: updateTone
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/tones/{toneId}
  method: delete
  operationId: deleteTone
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/styles
  method: get
  operationId: getStyle
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /v1/styles/{styleId}
  method: get
  operationId: getStyleById
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /v1/documents
  method: get
  operationId: getAllDocuments
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /v1/documents
  method: post
  operationId: createDocument
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/documents/{documentId}
  method: get
  operationId: getDocumentById
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /v1/documents/{documentId}
  method: patch
  operationId: updateDocument
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/documents/{documentId}
  method: delete
  operationId: deleteDocumentById
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/users
  method: get
  operationId: getAllUsers
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /v1/users/{userId}
  method: get
  operationId: getUser
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /v1/image/remove-background
  method: post
  operationId: removeBackground
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/image/replace-background
  method: post
  operationId: replaceBackground
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/image/cleanup
  method: post
  operationId: cleanup
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/image/remove-text
  method: post
  operationId: removeText
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/image/upscale
  method: post
  operationId: upscale
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/image/uncrop
  method: post
  operationId: uncrop
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/image/packshot-compositing
  method: post
  operationId: packshotCompositing
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/image/decompose
  method: post
  operationId: decompose
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/image/alt-text
  method: post
  operationId: altText
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/image/analysis
  method: post
  operationId: analyse
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /beta/image-template
  method: post
  operationId: createImageTemplate
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /beta/image-template/{template_id}
  method: get
  operationId: getImageTemplate
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /beta/image-template/render
  method: post
  operationId: renderImageTemplate
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/projects
  method: post
  operationId: createProject
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/projects
  method: get
  operationId: getProjects
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /v1/projects/{id}
  method: get
  operationId: getProjectById
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /v1/projects/{id}
  method: delete
  operationId: deleteProject
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/projects/{id}
  method: patch
  operationId: updateProject
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/templates
  method: get
  operationId: getAllTemplates
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /v1/templates/{templateId}
  method: get
  operationId: getTemplate
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /v1/templates/{templateId}/run
  method: post
  operationId: completeTemplate
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/usage
  method: get
  operationId: usage
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /v1/audiences/{audienceId}
  method: get
  operationId: getAudienceById
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /v1/audiences
  method: get
  operationId: getAllAudiences
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none