Imentiv AI · Agentic Access

Imentiv AI Agentic Access

x-agentic-access generated

Imentiv AI exposes 61 API operations that an AI agent could call, of which 34 are state-changing ‘acting’ operations. This is a recommended x-agentic-access execution contract — the scope, audience, consequence tier, short-lived token constraints, and escalation each action should carry before it is handed to an autonomous agent.

By consequence: 27 read, 33 write, and 1 physical.

Contracts are classified heuristically from the provider’s OpenAPI and refresh on every APIs.io network build; audience is bound per deployment. The model follows Curity’s Access Intelligence (apidays Munich 2026). Browse every provider’s agent contracts at agentic-access.apis.io.

Artificial IntelligenceEmotion DetectionMachine LearningVideo Analysis
Operations: 61 Acting: 34 Human-in-the-loop: 0 Method: generated

By consequence

read 27 write 33 physical 1

Highest-consequence actions

The physical and safety-critical operations an agent could invoke — the ones that most warrant scoped tokens, tight TTLs, and escalation. Full per-operation contracts are in the source below.

MethodPathConsequenceHuman-in-loop
POST /v2/{media_type}/{media_id}/ai-insights physical conditional

Source

Agentic Access

Raw ↑ 
generated: '2026-07-15'
method: generated
source: openapi/imentiv-ai-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: 61
  by_action_class:
    acting: 34
    connected: 27
  by_consequence:
    write: 33
    read: 27
    physical: 1
  human_in_the_loop_required: 0
operations:
- path: /v2/videos
  method: post
  operationId: upload_video_v2_videos_post
  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: /v1/videos
  method: get
  operationId: list_videos_v1_videos_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/videos/{video_id}
  method: get
  operationId: get_video_emotion_insights_v1_videos__video_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/videos/{video_id}
  method: delete
  operationId: delete_video_v1_videos__video_id__delete
  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: /v1/videos/{video_id}
  method: put
  operationId: reprocess_video_v1_videos__video_id__put
  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: /v2/videos/{video_id}/multimodal-analytics
  method: get
  operationId: get_video_multimodal_insights_v2_videos__video_id__multimodal_analytics_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v2/videos/{video_id}/emotions/average
  method: get
  operationId: get_average_emotions_v2_videos__video_id__emotions_average_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v2/videos/{video_id}/annotated_video
  method: get
  operationId: get_annotated_video_v2_videos__video_id__annotated_video_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/videos/{video_id}/valence_arousal
  method: get
  operationId: get_valence_arousal_v1_videos__video_id__valence_arousal_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/videos/{video_id}/frames
  method: get
  operationId: get_multiple_frame_v1_videos__video_id__frames_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/videos/{video_id}/frames/{frame_id}
  method: get
  operationId: get_single_frame_v1_videos__video_id__frames__frame_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/videos/{video_id}/frames/{frame_id}/dominant_emotion
  method: get
  operationId: retrieve_domination_emotion_for_a_specific_frame_v1_videos__video_id__frames__frame_id__dominant_emotion_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/videos/{video_id}/frames/{frame_id}/valence_arousal
  method: get
  operationId: retrieve_emotion_intensity_v1_videos__video_id__frames__frame_id__valence_arousal_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/videos/{video_id}/frames/{frame_id}/faces/{face_id}/emotions
  method: put
  operationId: update_emotion_per_frame_v1_videos__video_id__frames__frame_id__faces__face_id__emotions_put
  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: /v1/videos/{video_id}/frames/{frame_id}/faces/{face_id}/note
  method: put
  operationId: edit_face_note_v1_videos__video_id__frames__frame_id__faces__face_id__note_put
  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: /v1/videos/{video_id}/frames/faces
  method: put
  operationId: update_multiple_faces_v1_videos__video_id__frames_faces_put
  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: /v1/videos/{video_id}/faces
  method: put
  operationId: merge_face_v1_videos__video_id__faces_put
  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: /v1/videos/{video_id}/faces
  method: delete
  operationId: delete_faces_v1_videos__video_id__faces_delete
  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: /v1/videos/{video_id}/faces/names
  method: put
  operationId: update_faces_names_v1_videos__video_id__faces_names_put
  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: /v1/videos/highlights
  method: post
  operationId: process_highlight_v1_videos_highlights_post
  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: /v1/videos/{video_id}/highlights
  method: get
  operationId: fetch_highlight_video_v1_videos__video_id__highlights_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/videos/{video_id}/highlights
  method: put
  operationId: update_highlight_video_v1_videos__video_id__highlights_put
  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: /v1/videos/{video_id}/highlight_video
  method: get
  operationId: download_highlight_video_v1_videos__video_id__highlight_video_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/videos/{video_id}/metadata
  method: put
  operationId: edit_title_or_description_by_id_v1_videos__video_id__metadata_put
  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: /v1/videos/{video_id}/report
  method: post
  operationId: generate_video_emotion_analysis_report_v1_videos__video_id__report_post
  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: /v1/videos/{video_id}/report
  method: get
  operationId: download_video_emotion_analysis_report_v1_videos__video_id__report_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v2/audios
  method: post
  operationId: upload_audio_v2_audios_post
  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: /v1/audios
  method: get
  operationId: list_audios_v1_audios_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/audios/{audio_id}
  method: get
  operationId: get_audio_emotion_insights_v1_audios__audio_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/audios/{audio_id}
  method: put
  operationId: reprocess_audio_v1_audios__audio_id__put
  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: /v1/audios/{audio_id}
  method: delete
  operationId: delete_an_audio_v1_audios__audio_id__delete
  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: /v2/audios/{audio_id}/multimodal-analytics
  method: get
  operationId: get_audio_multimodal_insights_v2_audios__audio_id__multimodal_analytics_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/audios/{audio_id}/{segment_index}
  method: delete
  operationId: delete_audio_segment_v1_audios__audio_id___segment_index__delete
  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: /v1/audios/{audio_id}/transcript
  method: put
  operationId: update_audio_transcripts_segments_v1_audios__audio_id__transcript_put
  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: /v1/audios/{audio_id}/speakers/names
  method: put
  operationId: update_speaker_names_v1_audios__audio_id__speakers_names_put
  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: /v1/audios/{audio_id}/metadata
  method: put
  operationId: edit_title_or_description_v1_audios__audio_id__metadata_put
  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: /v1/audios/{audio_id}/report
  method: get
  operationId: download_audio_emotion_report_v1_audios__audio_id__report_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v2/texts
  method: post
  operationId: upload_text_v2_texts_post
  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: /v1/texts
  method: get
  operationId: list_texts_v1_texts_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/texts/{text_id}
  method: get
  operationId: get_text_emotion_insights_v1_texts__text_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/texts/{text_id}
  method: delete
  operationId: delete_text_v1_texts__text_id__delete
  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: /v1/texts/{text_id}
  method: put
  operationId: reprocess_text_v1_texts__text_id__put
  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: /v2/images
  method: post
  operationId: upload_image_v2_images_post
  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: /v1/images
  method: get
  operationId: list_images_v1_images_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/images/{image_id}
  method: get
  operationId: get_image_emotion_analysis_v1_images__image_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/images/{image_id}
  method: delete
  operationId: delete_image_v1_images__image_id__delete
  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: /v1/images/{image_id}
  method: put
  operationId: reprocess_image_v1_images__image_id__put
  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: /v1/images/{image_id}/annotated_image
  method: get
  operationId: send_image_v1_images__image_id__annotated_image_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/images/{image_id}/faces/{face_id}/note
  method: put
  operationId: add_note_to_specific_face_v1_images__image_id__faces__face_id__note_put
  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: /v1/images/{image_id}/metadata
  method: put
  operationId: edit_image_metadata_v1_images__image_id__metadata_put
  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: /v1/images/{image_id}/report
  method: get
  operationId: download_image_emotion_report_v1_images__image_id__report_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v2/reports/pdf/{media_id}
  method: get
  operationId: generate_pdf_report_v2_reports_pdf__media_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/texts/{text_id}/emotions
  method: put
  operationId: edit_text_v1_texts__text_id__emotions_put
  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: /v1/texts/{text_id}/report
  method: get
  operationId: download_text_emotion_report_v1_texts__text_id__report_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/audios/{audio_id}/transcript/replace
  method: put
  operationId: replace_audio_transcript_v1_audios__audio_id__transcript_replace_put
  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: /v2/{media_type}/{media_id}/ai-insights
  method: post
  operationId: chat_ai_insights_v2__media_type___media_id__ai_insights_post
  x-agentic-access:
    action-class: acting
    consequence: physical
    subject: required
    audience: null
    token:
      max-ttl: 300
      exchange: true
      purpose-required: true
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v2/{media_type}/{media_id}/ai-insights
  method: get
  operationId: get_ai_insights_history_v2__media_type___media_id__ai_insights_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v2/videos/{video_id}/speaker-face-match
  method: put
  operationId: update_speaker_face_match_v2_videos__video_id__speaker_face_match_put
  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: /v2/videos/{video_id}/speaker-face-match
  method: post
  operationId: trigger_speaker_face_match_v2_videos__video_id__speaker_face_match_post
  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: /v2/videos/{video_id}/personality/analyze
  method: post
  operationId: trigger_personality_analysis_v2_videos__video_id__personality_analyze_post
  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: /v2/videos/{video_id}/faces/{face_id}/personality-analysis
  method: get
  operationId: get_personality_analysis_v2_videos__video_id__faces__face_id__personality_analysis_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none