ToolExecutionRequest

Request model for tool execution (Contract v1.0 compliant).

  • capability_key
    Type: string · Capability Key
    max length:  
    255
    required

    The capability being requested (e.g., 'vendor.create')

  • org_id
    Type: string · Org Id
    max length:  
    255
    required

    Organization ID for multi-tenancy

  • turn_id
    Type: string · Turn Id
    max length:  
    255
    required

    Turn ID for idempotency (prevents duplicate executions) - REQUIRED

  • user_id
    Type: string · User Id
    max length:  
    255
    required

    Claimed user ID for credential lookup and audit

  • args
    Type: object · Args

    Arguments for the tool execution

    • propertyName
      Type: anything
  • session_id
    Type: string · Session Id
    max length:  
    64    nullable

    Session ID for event correlation (passed via X-Session-ID header or body)

  • use_delegation
    Type: boolean · Use Delegation

    For agent credentials: prefer delegated access over system credentials