generated: '2026-08-02' method: generated source: openapi/roboflow-inference-openapi.json 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: 39 by_action_class: connected: 9 acting: 30 by_consequence: read: 9 write: 30 human_in_the_loop_required: 0 operations: - path: /metrics method: get operationId: metrics_metrics_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /info method: get operationId: root_info_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /logs method: get operationId: get_logs_logs_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /model/registry method: get operationId: registry_model_registry_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /infer/lmm method: post operationId: infer_lmm_infer_lmm_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: /infer/lmm/{model_id} method: post operationId: infer_lmm_with_model_id_infer_lmm__model_id__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: /initialise_webrtc_worker method: post operationId: initialise_webrtc_worker_initialise_webrtc_worker_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: /webrtc/session/heartbeat method: post operationId: webrtc_session_heartbeat_webrtc_session_heartbeat_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: /webrtc/session/heartbeat/end method: post operationId: webrtc_session_end_webrtc_session_heartbeat_end_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: /readiness method: get operationId: readiness_readiness_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /healthz method: get operationId: healthz_healthz_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /clip/embed_image method: post operationId: clip_embed_image_clip_embed_image_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: /clip/embed_text method: post operationId: clip_embed_text_clip_embed_text_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: /clip/compare method: post operationId: clip_compare_clip_compare_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: /perception_encoder/embed_image method: post operationId: pe_embed_image_perception_encoder_embed_image_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: /perception_encoder/embed_text method: post operationId: pe_embed_text_perception_encoder_embed_text_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: /perception_encoder/compare method: post operationId: pe_compare_perception_encoder_compare_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: /grounding_dino/infer method: post operationId: grounding_dino_infer_grounding_dino_infer_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: /yolo_world/infer method: post operationId: yolo_world_infer_yolo_world_infer_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: /doctr/ocr method: post operationId: doctr_retrieve_text_doctr_ocr_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: /easy_ocr/ocr method: post operationId: easy_ocr_retrieve_text_easy_ocr_ocr_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: /sam/embed_image method: post operationId: sam_embed_image_sam_embed_image_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: /sam/segment_image method: post operationId: sam_segment_image_sam_segment_image_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: /sam2/embed_image method: post operationId: sam2_embed_image_sam2_embed_image_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: /sam2/segment_image method: post operationId: sam2_segment_image_sam2_segment_image_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: /sam3/embed_image method: post operationId: sam3_embed_image_sam3_embed_image_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: /sam3/concept_segment method: post operationId: sam3_segment_image_sam3_concept_segment_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: /sam3/visual_segment method: post operationId: sam3_visual_segment_sam3_visual_segment_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: /sam3_3d/infer method: post operationId: sam3_3d_infer_sam3_3d_infer_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: /owlv2/infer method: post operationId: owlv2_infer_owlv2_infer_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: /gaze/gaze_detection method: post operationId: gaze_detection_deprecated_gaze_gaze_detection_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: /infer/depth-estimation method: post operationId: depth_estimation_infer_depth_estimation_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: /infer/depth-estimation/{model_id} method: post operationId: depth_estimation_with_model_id_infer_depth_estimation__model_id__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: /ocr/trocr method: post operationId: trocr_retrieve_text_ocr_trocr_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: /ocr/pp-ocr method: post operationId: pp_ocr_retrieve_text_ocr_pp_ocr_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: /{dataset_id}/{version_id} method: post operationId: legacy_infer_from_request__dataset_id___version_id__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: /{dataset_id}/{version_id} method: get operationId: legacy_infer_from_request__dataset_id___version_id__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /dashboard.html method: get operationId: dashboard_guard_dashboard_html_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /dashboard.html method: head operationId: dashboard_guard_dashboard_html_head x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none