Kaleyra · Agentic Access

Kaleyra Agentic Access

x-agentic-access generated

Kaleyra exposes 7 API operations that an AI agent could call, of which 5 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: 2 read and 5 write.

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.

CPaaSMessagingSMSWhatsAppVoiceOTPIndia
Operations: 7 Acting: 5 Human-in-the-loop: 0 Method: generated

By consequence

read 2 write 5

Source

Agentic Access

Raw ↑
generated: '2026-07-17'
method: generated
source: openapi/kaleyra-openapi.yml
description: Recommended x-agentic-access execution contracts, classified heuristically from
  the modeled OpenAPI. A governance starting point for exposing this API to AI agents - review and bind
  audience per deployment. Kaleyra sends real-world messages, calls, and OTPs, so acting operations
  carry outbound-communication risk (spend + recipient contact) and default to human-in-the-loop on
  abnormal/high-value triggers. See research/curity/agentic-governance/.
summary:
  operations: 7
  by_action_class:
    acting: 5
    connected: 2
  by_consequence:
    write: 5
    read: 2
  human_in_the_loop_required: 0
operations:
- path: /v2/{sid}/messages
  method: post
  operationId: sendMessage
  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
      - outbound-communication
    audit: required
- path: /v2/{sid}/messages
  method: get
  operationId: listMessages
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v2/{sid}/messages/{message_id}
  method: get
  operationId: getMessageStatus
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/{sid}/verify
  method: post
  operationId: generateOtp
  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
      - outbound-communication
    audit: required
- path: /v1/{sid}/verify/validate
  method: get
  operationId: validateOtp
  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/{sid}/voice/click-to-call
  method: post
  operationId: clickToCall
  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
      - outbound-communication
    audit: required
- path: /v2/rooms
  method: post
  operationId: createVideoRoom
  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