{
  "schema": "varexis-public-evidence-record/0.3",
  "generated_at_utc": "2026-10-14T01:00:52.414Z",
  "record_id": "VXI-EXT-PROCUREMENT-TWILIO-RESTRICTED-01-v1",
  "record_kind": "external_reference",
  "title": "Twilio: Restricted keys still need an action review",
  "system": "Twilio Restricted API keys",
  "evidence_family": "vendor_evidence_review",
  "index_status": "PUBLIC_SAFE_SOURCE_REVIEW",
  "evidence_state": "PRIMARY_DOCUMENTATION_REVIEW_ONLY",
  "canonical_question": "Does a restricted Twilio API key make an agent communication task read-only?",
  "near_questions": [
    "Does a restricted Twilio key mean read-only access?",
    "Can a restricted key still create calls?",
    "What endpoint actions does the key actually permit?",
    "Does a permission label establish a spending limit?",
    "Can restricted keys create client-side SDK Access Tokens?",
    "What should procurement request without exposing a key secret?",
    "Does authorising analysis permit contacting customers?",
    "Could a denied call reflect missing permission rather than an invalid credential?",
    "How should an agent compare granted actions with its task?",
    "What evidence supports least-privilege communication access?",
    "Can I save a reviewed API action boundary?",
    "When should Twilio key permissions be rechecked?"
  ],
  "supported_claims": [
    {
      "claim": "Twilio Restricted API keys select permissions that map to endpoint actions. A restricted key can still permit creating calls or other state-changing operations. The feature also has SDK-token limitations. Review the actual permission mapping and task authority instead of treating the word restricted as a read-only guarantee.",
      "reliance": "DOCUMENTED_CAPABILITY_ONLY"
    }
  ],
  "not_demonstrated_claims": [
    "Verified buyer configuration or effective access rights",
    "Independent execution, completeness or security testing",
    "Vendor certification, legal compliance or guaranteed suitability"
  ],
  "public_summary": "Twilio Restricted API keys select permissions that map to endpoint actions. A restricted key can still permit creating calls or other state-changing operations. The feature also has SDK-token limitations. Review the actual permission mapping and task authority instead of treating the word restricted as a read-only guarantee.",
  "related_record_ids": [
    "VXI-EXT-PROCUREMENT-ANTHROPIC-RETENTION-01-v1",
    "VXI-EXT-PROCUREMENT-BEDROCK-LOGGING-01-v1",
    "VXI-EXT-PROCUREMENT-DROPBOX-RESIDENCY-01-v1",
    "VXI-EXT-PROCUREMENT-BOX-LINK-AUDIENCE-01-v1"
  ],
  "source_review": {
    "source_type": "official_external_documentation",
    "source_title": "Twilio restricted API key endpoint permissions and SDK limits",
    "source_url": "https://www.twilio.com/docs/iam/api-keys/restricted-api-keys",
    "checked_on": "2026-10-14",
    "candidate_record_id": "VXI-EXT-PROCUREMENT-TWILIO-RESTRICTED-01-v1",
    "candidate_record_sha256": "eb7fba391ce144749255657275507a56f35ce1c96db97ec8f506b8b3ad55cbfc",
    "method": "Primary documentation reviewed for the published bounded statement.",
    "deployment_tested_by_varexis": false,
    "revalidation": "The delivered snapshot preserves the review date shown. Recheck current primary documentation and deployment context before relying on present applicability; payment does not trigger fresh research."
  },
  "answer_policy": {
    "classification": "DOCUMENTED_WITH_DEPLOYMENT_BOUNDARY",
    "bounded_answer": "Twilio Restricted API keys select permissions that map to endpoint actions. A restricted key can still permit creating calls or other state-changing operations. The feature also has SDK-token limitations. Review the actual permission mapping and task authority instead of treating the word restricted as a read-only guarantee.",
    "required_buyer_context": "Identify key type, granted endpoint/action permissions, intended task and whether a client-side SDK token is required.",
    "missing_evidence": "A broader claim needs evidence matching the intended use. Payment does not upgrade the evidence state."
  },
  "private_boundary": "Raw logs, thresholds, private paths, source code, protected mechanisms and reconstruction-level details are excluded from public and paid delivery.",
  "decision_profile": {
    "schema": "varexis-vendor-evidence-review/1",
    "review_status": "documentation_review_only",
    "checked_on": "2026-10-14",
    "claim_to_check": "Any restricted API key is safe to use for read-only communication analysis.",
    "documented_statement": {
      "status": "documented",
      "statement": "Twilio Restricted API keys select permissions that map to endpoint actions. A restricted key can still permit creating calls or other state-changing operations. The feature also has SDK-token limitations. Review the actual permission mapping and task authority instead of treating the word restricted as a read-only guarantee.",
      "source_ids": [
        "twilio"
      ]
    },
    "buyer_evidence_required": [
      "Non-secret key type and permission inventory",
      "Mapping from approved task to granted endpoint actions",
      "Evidence of task approval and the intended server or client-SDK integration"
    ],
    "review_condition": {
      "status": "varexis_review_policy",
      "statement": "Require approved state-changing actions; do not infer a spending limit or read-only access from the key label."
    },
    "unknowns": "The buyer configuration, contract, effective entitlement and operational evidence have not been inspected. Missing evidence does not establish absence or failure of the feature.",
    "evidence_sources": [
      {
        "source_id": "twilio",
        "url": "https://www.twilio.com/docs/iam/api-keys/restricted-api-keys",
        "final_url": "https://www.twilio.com/docs/iam/api-keys/restricted-api-keys",
        "title": "Twilio restricted API key endpoint permissions and SDK limits",
        "checked_on": "2026-10-14",
        "sha256": "3370548cae6a08803d41f83fb204aecb18e052c7c5aea0badc47d0d3e9be0bde",
        "bytes": 244651
      }
    ],
    "observed_deployment": false,
    "commercial_reliance_boundary": "Procurement evidence support only; no supplier clearance, legal conclusion, configuration audit or verification of the buyer's claim is supplied.",
    "paid_value": {
      "decision_context": "Save the endpoint-action review behind granting a communication agent credentials.",
      "free": "Complete review, practical questions, sources and limitations; may be saved locally.",
      "single_request": "Existing server-saved version-bound route snapshot for later authenticated retrieval.",
      "evidence_receipt": "The same snapshot plus the existing unsigned delivery receipt.",
      "excluded": [
        "Fresh vendor research",
        "Continuous monitoring or change alerts",
        "Testing the buyer configuration",
        "Private evidence or vendor certification"
      ],
      "integrity": "Hashes identify content versions; they do not prove truth or provide a signature."
    },
    "revalidation": {
      "trigger": "A saved purchase does not recheck the source or buyer configuration.",
      "specific_watch": "Recheck permission changes, endpoint requirements and integration type."
    }
  },
  "paid_access_note": "The full published answer and boundaries are free. Paid access saves the selected route and source versions, with an unsigned receipt when purchased. Preview coverage before paying. Fresh research, bespoke assessment and protected evidence are excluded.",
  "service_route": {
    "request_guide": "/varexis-index/request.html",
    "request_workflow": "/varexis-index/request-workflow.json",
    "service_id": "single_request",
    "service_routes_url": "/varexis-index/service-routes.json",
    "payment_required": true,
    "availability_endpoint": "/api/index/capabilities",
    "operational_status": "AUTOMATIC_SERVICE_CAPABILITIES_GATED",
    "checkout_url": "/index-access"
  },
  "authority_boundary": "VAREXIS-INDEX informs evidence reliance. It does not provide advice, certification, deployment authority, security assurance, production approval, or guarantee.",
  "human_page": "/varexis-index/catalog.html#twilio-restricted-key-action-check",
  "machine_readable_record": "/varexis-index/records/twilio-restricted-key-action-check.json"
}
