Skip to main content
Glama

Patch MCP

get_call

Read-only

Get the status and, once terminal, the structured resolution of a call started with place_call. Returns instantly by default. Pass wait_seconds (max 50) to have the server hold the request and return early on any status change — fewer round trips while a call is in progress. Terminal statuses: completed, answered_silently, no_answer, busy, voicemail, failed, rejected, canceled, declined_recording, opted_out. rejected means safety screening declined the objective before dialing; error.message and resolution.summary explain why. Terminal calls include a resolution {outcome: achieved|partially_achieved|not_achieved|no_conversation|unknown, summary, commitments[], follow_ups[], key_facts[]} — read it before the transcript; it is the answer. unknown means the outcome could not be determined; review the transcript. Completed calls also carry the transcript (may be marked transcript_truncated) and a recording_url the user can listen to (private links expire after ~1 hour; on staging, fetch with the same OAuth Authorization: Bearer header). The resolution can lag the terminal status by a few seconds while it is extracted. Calls include the resolved locale, language, voice, and is_public; public calls return token-free listen and recording URLs that remain accessible while public. Use set_call_visibility only when the user explicitly asks to publish or make private. Every call includes a listen_url — the call page for the user (live audio + transcript while in progress; recording + transcript once ended). ended_by='user' on a canceled call means the user deliberately stopped it from that page — don't retry. recording_status=processing means the LiveKit session recording is being finalized and copied to private storage separately from the result. A recording can fail or be unavailable. Call get_call again, or pass wait_seconds on an already-terminal call to wait for a recording state change.

Input Schema

NameRequiredDescriptionDefault
call_idYesThe id returned by place_call.
wait_secondsNo0 (default) = instant status check. Up to 50 = server-side long-poll.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "amd_result": {
      -        "anyOf": [
      -          {
      -            "description": "Answering-machine detection result.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "call_id": {
      -        "description": "Call identifier used with get_call, end_call and set_call_visibility.",
      -        "type": "string"
      -      },
      -      "callee_name": {
      -        "anyOf": [
      -          {
      -            "description": "Recipient display name.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "costs": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "currency": {
      -            "const": "USD",
      -            "type": "string"
      -          },
      -          "reserved_usage_units": {
      -            "anyOf": [
      -              {
      -                "description": "Reserved usage units; absent on legacy calls.",
      -                "type": "number"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          }
      -        },
      -        "required": [
      -          "currency"
      -        ],
      -        "type": "object"
      -      },
      -      "created_at": {
      -        "description": "ISO 8601 creation time.",
      -        "type": "string"
      -      },
      -      "duration_seconds": {
      -        "description": "Connected duration in seconds.",
      -        "type": "number"
      -      },
      -      "end_reason": {
      -        "description": "Reason the call ended.",
      -        "type": "string"
      -      },
      -      "ended_at": {
      -        "anyOf": [
      -          {
      -            "description": "ISO 8601 end time; null while active.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "ended_by": {
      -        "description": "Party or system that ended the call.",
      -        "type": "string"
      -      },
      -      "error": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "properties": {
      -              "code": {
      -                "description": "Call failure code.",
      -                "type": "string"
      -              },
      -              "message": {
      -                "description": "Call failure explanation.",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "code",
      -              "message"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "is_public": {
      -        "description": "Whether the call has a public link.",
      -        "type": "boolean"
      -      },
      -      "language": {
      -        "description": "Resolved call language.",
      -        "type": "string"
      -      },
      -      "listen_url": {
      -        "description": "URL for the user to listen, read the transcript and stop an active call.",
      -        "type": "string"
      -      },
      -      "locale": {
      -        "description": "Resolved BCP 47 language/locale for this call.",
      -        "type": "string"
      -      },
      -      "recording_status": {
      -        "description": "Recording availability.",
      -        "enum": [
      -          "none",
      -          "processing",
      -          "available",
      -          "failed"
      -        ],
      -        "type": "string"
      -      },
      -      "recording_url": {
      -        "anyOf": [
      -          {
      -            "description": "Audio URL when ready; private URLs expire.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "resolution": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "properties": {
      -              "callee_requested_no_further_calls": {
      -                "description": "Whether the recipient asked not to be called again.",
      -                "type": "boolean"
      -              },
      -              "commitments": {
      -                "description": "What the callee agreed to.",
      -                "items": {
      -                  "description": "Confirmed commitment.",
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "follow_ups": {
      -                "description": "Actions the user still needs to take.",
      -                "items": {
      -                  "description": "Next action.",
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "key_facts": {
      -                "description": "Useful information from the conversation.",
      -                "items": {
      -                  "description": "Fact learned.",
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "outcome": {
      -                "description": "Whether the call objective was met; unknown when review is unavailable or evidence is insufficient.",
      -                "enum": [
      -                  "achieved",
      -                  "partially_achieved",
      -                  "not_achieved",
      -                  "no_conversation",
      -                  "unknown"
      -                ],
      -                "type": "string"
      -              },
      -              "summary": {
      -                "description": "User-facing summary of what happened.",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "outcome",
      -              "summary",
      -              "commitments",
      -              "follow_ups",
      -              "key_facts",
      -              "callee_requested_no_further_calls"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "status": {
      -        "description": "Current call lifecycle state.",
      -        "enum": [
      -          "queued",
      -          "ringing",
      -          "in_progress",
      -          "completed",
      -          "answered_silently",
      -          "no_answer",
      -          "busy",
      -          "voicemail",
      -          "failed",
      -          "rejected",
      -          "canceled",
      -          "declined_recording",
      -          "opted_out"
      -        ],
      -        "type": "string"
      -      },
      -      "to": {
      -        "description": "Destination in E.164 format.",
      -        "type": "string"
      -      },
      -      "transcript": {
      -        "description": "Conversation entries; empty before speech is available.",
      -        "items": {
      -          "additionalProperties": {},
      -          "properties": {
      -            "at_ms": {
      -              "description": "Milliseconds from the transcript timeline origin.",
      -              "type": "number"
      -            },
      -            "id": {
      -              "type": "string"
      -            },
      -            "role": {
      -              "description": "Speaker or confirmed keypad action.",
      -              "enum": [
      -                "callee",
      -                "agent",
      -                "keypad"
      -              ],
      -              "type": "string"
      -            },
      -            "sequence": {
      -              "type": "number"
      -            },
      -            "text": {
      -              "description": "Transcript text.",
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "role",
      -            "text",
      -            "at_ms"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "transcript_truncated": {
      -        "description": "Whether earlier transcript content was omitted.",
      -        "type": "boolean"
      -      },
      -      "voice": {
      -        "anyOf": [
      -          {
      -            "description": "Resolved voice identifier.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "required": [
      -      "call_id",
      -      "status",
      -      "to",
      -      "callee_name",
      -      "language",
      -      "locale",
      -      "voice",
      -      "amd_result",
      -      "duration_seconds",
      -      "is_public",
      -      "listen_url",
      -      "resolution",
      -      "transcript",
      -      "recording_url",
      -      "recording_status",
      -      "costs",
      -      "error",
      -      "created_at",
      -      "ended_at"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "error": {
      -        "description": "Machine-readable failure code.",
      -        "type": "string"
      -      },
      -      "message": {
      -        "description": "Explanation or recovery guidance.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "error"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "next_action": {
      -        "type": "string"
      -      },
      -      "operation_id": {
      -        "type": "string"
      -      },
      -      "status": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "operation_id",
      -      "status"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "amd_result": {
      +        "anyOf": [
      +          {
      +            "description": "Answering-machine detection result.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "call_id": {
      +        "description": "Call identifier used with get_call, end_call and set_call_visibility.",
      +        "type": "string"
      +      },
      +      "callee_name": {
      +        "anyOf": [
      +          {
      +            "description": "Recipient display name.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "costs": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "currency": {
      +            "const": "USD",
      +            "type": "string"
      +          },
      +          "reserved_usage_units": {
      +            "anyOf": [
      +              {
      +                "description": "Reserved usage units; absent on legacy calls.",
      +                "type": "number"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          }
      +        },
      +        "required": [
      +          "currency"
      +        ],
      +        "type": "object"
      +      },
      +      "created_at": {
      +        "description": "ISO 8601 creation time.",
      +        "type": "string"
      +      },
      +      "duration_seconds": {
      +        "description": "Connected duration in seconds.",
      +        "type": "number"
      +      },
      +      "end_reason": {
      +        "description": "Reason the call ended.",
      +        "type": "string"
      +      },
      +      "ended_at": {
      +        "anyOf": [
      +          {
      +            "description": "ISO 8601 end time; null while active.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "ended_by": {
      +        "description": "Party or system that ended the call.",
      +        "type": "string"
      +      },
      +      "error": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "properties": {
      +              "code": {
      +                "description": "Call failure code.",
      +                "type": "string"
      +              },
      +              "message": {
      +                "description": "Call failure explanation.",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "code",
      +              "message"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "is_public": {
      +        "description": "Whether the call has a public link.",
      +        "type": "boolean"
      +      },
      +      "language": {
      +        "description": "Resolved call language.",
      +        "type": "string"
      +      },
      +      "listen_url": {
      +        "description": "URL for the user to listen, read the transcript and stop an active call.",
      +        "type": "string"
      +      },
      +      "locale": {
      +        "description": "Resolved BCP 47 language/locale for this call.",
      +        "type": "string"
      +      },
      +      "number_id": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "recording_status": {
      +        "description": "Recording availability.",
      +        "enum": [
      +          "none",
      +          "processing",
      +          "available",
      +          "failed"
      +        ],
      +        "type": "string"
      +      },
      +      "recording_url": {
      +        "anyOf": [
      +          {
      +            "description": "Audio URL when ready; private URLs expire.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "resolution": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "properties": {
      +              "callee_requested_no_further_calls": {
      +                "description": "Whether the recipient asked not to be called again.",
      +                "type": "boolean"
      +              },
      +              "commitments": {
      +                "description": "What the callee agreed to.",
      +                "items": {
      +                  "description": "Confirmed commitment.",
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "follow_ups": {
      +                "description": "Actions the user still needs to take.",
      +                "items": {
      +                  "description": "Next action.",
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "key_facts": {
      +                "description": "Useful information from the conversation.",
      +                "items": {
      +                  "description": "Fact learned.",
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "outcome": {
      +                "description": "Whether the call objective was met; unknown when review is unavailable or evidence is insufficient.",
      +                "enum": [
      +                  "achieved",
      +                  "partially_achieved",
      +                  "not_achieved",
      +                  "no_conversation",
      +                  "unknown"
      +                ],
      +                "type": "string"
      +              },
      +              "summary": {
      +                "description": "User-facing summary of what happened.",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "outcome",
      +              "summary",
      +              "commitments",
      +              "follow_ups",
      +              "key_facts",
      +              "callee_requested_no_further_calls"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "status": {
      +        "description": "Current call lifecycle state.",
      +        "enum": [
      +          "queued",
      +          "ringing",
      +          "in_progress",
      +          "completed",
      +          "answered_silently",
      +          "no_answer",
      +          "busy",
      +          "voicemail",
      +          "failed",
      +          "rejected",
      +          "canceled",
      +          "declined_recording",
      +          "opted_out"
      +        ],
      +        "type": "string"
      +      },
      +      "to": {
      +        "description": "Destination in E.164 format.",
      +        "type": "string"
      +      },
      +      "transcript": {
      +        "description": "Conversation entries; empty before speech is available.",
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "at_ms": {
      +              "description": "Milliseconds from the transcript timeline origin.",
      +              "type": "number"
      +            },
      +            "id": {
      +              "type": "string"
      +            },
      +            "role": {
      +              "description": "Speaker or confirmed keypad action.",
      +              "enum": [
      +                "callee",
      +                "agent",
      +                "keypad"
      +              ],
      +              "type": "string"
      +            },
      +            "sequence": {
      +              "type": "number"
      +            },
      +            "text": {
      +              "description": "Transcript text.",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "role",
      +            "text",
      +            "at_ms"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "transcript_truncated": {
      +        "description": "Whether earlier transcript content was omitted.",
      +        "type": "boolean"
      +      },
      +      "voice": {
      +        "anyOf": [
      +          {
      +            "description": "Resolved voice identifier.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      }
      +    },
      +    "required": [
      +      "call_id",
      +      "status",
      +      "to",
      +      "callee_name",
      +      "language",
      +      "locale",
      +      "voice",
      +      "amd_result",
      +      "duration_seconds",
      +      "is_public",
      +      "listen_url",
      +      "resolution",
      +      "transcript",
      +      "recording_url",
      +      "recording_status",
      +      "costs",
      +      "error",
      +      "created_at",
      +      "ended_at",
      +      "number_id"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "error": {
      +        "description": "Machine-readable failure code.",
      +        "type": "string"
      +      },
      +      "message": {
      +        "description": "Explanation or recovery guidance.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "error"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "next_action": {
      +        "type": "string"
      +      },
      +      "operation_id": {
      +        "type": "string"
      +      },
      +      "status": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "operation_id",
      +      "status"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "amd_result": {
      -        "anyOf": [
      -          {
      -            "description": "Answering-machine detection result.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "call_id": {
      -        "description": "Call identifier used with get_call, end_call and set_call_visibility.",
      -        "type": "string"
      -      },
      -      "callee_name": {
      -        "anyOf": [
      -          {
      -            "description": "Recipient display name.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "costs": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "currency": {
      -            "const": "USD",
      -            "type": "string"
      -          },
      -          "rate_version": {
      -            "anyOf": [
      -              {
      -                "description": "Rate deck version.",
      -                "type": "string"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "reserved_usage_units": {
      -            "anyOf": [
      -              {
      -                "description": "Reserved usage units; absent on legacy calls.",
      -                "type": "number"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          }
      -        },
      -        "required": [
      -          "currency",
      -          "rate_version"
      -        ],
      -        "type": "object"
      -      },
      -      "created_at": {
      -        "description": "ISO 8601 creation time.",
      -        "type": "string"
      -      },
      -      "duration_seconds": {
      -        "description": "Connected duration in seconds.",
      -        "type": "number"
      -      },
      -      "end_reason": {
      -        "description": "Reason the call ended.",
      -        "type": "string"
      -      },
      -      "ended_at": {
      -        "anyOf": [
      -          {
      -            "description": "ISO 8601 end time; null while active.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "ended_by": {
      -        "description": "Party or system that ended the call.",
      -        "type": "string"
      -      },
      -      "error": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "properties": {
      -              "code": {
      -                "description": "Call failure code.",
      -                "type": "string"
      -              },
      -              "message": {
      -                "description": "Call failure explanation.",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "code",
      -              "message"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "is_public": {
      -        "description": "Whether the call has a public link.",
      -        "type": "boolean"
      -      },
      -      "language": {
      -        "description": "Resolved call language.",
      -        "type": "string"
      -      },
      -      "listen_url": {
      -        "description": "URL for the user to listen, read the transcript and stop an active call.",
      -        "type": "string"
      -      },
      -      "locale": {
      -        "description": "Resolved BCP 47 language/locale for this call.",
      -        "type": "string"
      -      },
      -      "recording_status": {
      -        "description": "Recording availability.",
      -        "enum": [
      -          "none",
      -          "processing",
      -          "available",
      -          "failed"
      -        ],
      -        "type": "string"
      -      },
      -      "recording_url": {
      -        "anyOf": [
      -          {
      -            "description": "Audio URL when ready; private URLs expire.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "resolution": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "properties": {
      -              "callee_requested_no_further_calls": {
      -                "description": "Whether the recipient asked not to be called again.",
      -                "type": "boolean"
      -              },
      -              "commitments": {
      -                "description": "What the callee agreed to.",
      -                "items": {
      -                  "description": "Confirmed commitment.",
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "follow_ups": {
      -                "description": "Actions the user still needs to take.",
      -                "items": {
      -                  "description": "Next action.",
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "key_facts": {
      -                "description": "Useful information from the conversation.",
      -                "items": {
      -                  "description": "Fact learned.",
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "outcome": {
      -                "description": "Whether the call objective was met; unknown when review is unavailable or evidence is insufficient.",
      -                "enum": [
      -                  "achieved",
      -                  "partially_achieved",
      -                  "not_achieved",
      -                  "no_conversation",
      -                  "unknown"
      -                ],
      -                "type": "string"
      -              },
      -              "summary": {
      -                "description": "User-facing summary of what happened.",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "outcome",
      -              "summary",
      -              "commitments",
      -              "follow_ups",
      -              "key_facts",
      -              "callee_requested_no_further_calls"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "status": {
      -        "description": "Current call lifecycle state.",
      -        "enum": [
      -          "queued",
      -          "ringing",
      -          "in_progress",
      -          "completed",
      -          "answered_silently",
      -          "no_answer",
      -          "busy",
      -          "voicemail",
      -          "failed",
      -          "rejected",
      -          "canceled",
      -          "declined_recording",
      -          "opted_out"
      -        ],
      -        "type": "string"
      -      },
      -      "to": {
      -        "description": "Destination in E.164 format.",
      -        "type": "string"
      -      },
      -      "transcript": {
      -        "description": "Conversation entries; empty before speech is available.",
      -        "items": {
      -          "additionalProperties": {},
      -          "properties": {
      -            "at_ms": {
      -              "description": "Milliseconds from the transcript timeline origin.",
      -              "type": "number"
      -            },
      -            "id": {
      -              "type": "string"
      -            },
      -            "role": {
      -              "description": "Speaker or confirmed keypad action.",
      -              "enum": [
      -                "callee",
      -                "agent",
      -                "keypad"
      -              ],
      -              "type": "string"
      -            },
      -            "sequence": {
      -              "type": "number"
      -            },
      -            "text": {
      -              "description": "Transcript text.",
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "role",
      -            "text",
      -            "at_ms"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "transcript_truncated": {
      -        "description": "Whether earlier transcript content was omitted.",
      -        "type": "boolean"
      -      },
      -      "voice": {
      -        "anyOf": [
      -          {
      -            "description": "Resolved voice identifier.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "required": [
      -      "call_id",
      -      "status",
      -      "to",
      -      "callee_name",
      -      "language",
      -      "locale",
      -      "voice",
      -      "amd_result",
      -      "duration_seconds",
      -      "is_public",
      -      "listen_url",
      -      "resolution",
      -      "transcript",
      -      "recording_url",
      -      "recording_status",
      -      "costs",
      -      "error",
      -      "created_at",
      -      "ended_at"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "error": {
      -        "description": "Machine-readable failure code.",
      -        "type": "string"
      -      },
      -      "message": {
      -        "description": "Explanation or recovery guidance.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "error"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "next_action": {
      -        "type": "string"
      -      },
      -      "operation_id": {
      -        "type": "string"
      -      },
      -      "status": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "operation_id",
      -      "status"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "amd_result": {
      +        "anyOf": [
      +          {
      +            "description": "Answering-machine detection result.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "call_id": {
      +        "description": "Call identifier used with get_call, end_call and set_call_visibility.",
      +        "type": "string"
      +      },
      +      "callee_name": {
      +        "anyOf": [
      +          {
      +            "description": "Recipient display name.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "costs": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "currency": {
      +            "const": "USD",
      +            "type": "string"
      +          },
      +          "reserved_usage_units": {
      +            "anyOf": [
      +              {
      +                "description": "Reserved usage units; absent on legacy calls.",
      +                "type": "number"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          }
      +        },
      +        "required": [
      +          "currency"
      +        ],
      +        "type": "object"
      +      },
      +      "created_at": {
      +        "description": "ISO 8601 creation time.",
      +        "type": "string"
      +      },
      +      "duration_seconds": {
      +        "description": "Connected duration in seconds.",
      +        "type": "number"
      +      },
      +      "end_reason": {
      +        "description": "Reason the call ended.",
      +        "type": "string"
      +      },
      +      "ended_at": {
      +        "anyOf": [
      +          {
      +            "description": "ISO 8601 end time; null while active.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "ended_by": {
      +        "description": "Party or system that ended the call.",
      +        "type": "string"
      +      },
      +      "error": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "properties": {
      +              "code": {
      +                "description": "Call failure code.",
      +                "type": "string"
      +              },
      +              "message": {
      +                "description": "Call failure explanation.",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "code",
      +              "message"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "is_public": {
      +        "description": "Whether the call has a public link.",
      +        "type": "boolean"
      +      },
      +      "language": {
      +        "description": "Resolved call language.",
      +        "type": "string"
      +      },
      +      "listen_url": {
      +        "description": "URL for the user to listen, read the transcript and stop an active call.",
      +        "type": "string"
      +      },
      +      "locale": {
      +        "description": "Resolved BCP 47 language/locale for this call.",
      +        "type": "string"
      +      },
      +      "recording_status": {
      +        "description": "Recording availability.",
      +        "enum": [
      +          "none",
      +          "processing",
      +          "available",
      +          "failed"
      +        ],
      +        "type": "string"
      +      },
      +      "recording_url": {
      +        "anyOf": [
      +          {
      +            "description": "Audio URL when ready; private URLs expire.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "resolution": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "properties": {
      +              "callee_requested_no_further_calls": {
      +                "description": "Whether the recipient asked not to be called again.",
      +                "type": "boolean"
      +              },
      +              "commitments": {
      +                "description": "What the callee agreed to.",
      +                "items": {
      +                  "description": "Confirmed commitment.",
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "follow_ups": {
      +                "description": "Actions the user still needs to take.",
      +                "items": {
      +                  "description": "Next action.",
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "key_facts": {
      +                "description": "Useful information from the conversation.",
      +                "items": {
      +                  "description": "Fact learned.",
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "outcome": {
      +                "description": "Whether the call objective was met; unknown when review is unavailable or evidence is insufficient.",
      +                "enum": [
      +                  "achieved",
      +                  "partially_achieved",
      +                  "not_achieved",
      +                  "no_conversation",
      +                  "unknown"
      +                ],
      +                "type": "string"
      +              },
      +              "summary": {
      +                "description": "User-facing summary of what happened.",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "outcome",
      +              "summary",
      +              "commitments",
      +              "follow_ups",
      +              "key_facts",
      +              "callee_requested_no_further_calls"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "status": {
      +        "description": "Current call lifecycle state.",
      +        "enum": [
      +          "queued",
      +          "ringing",
      +          "in_progress",
      +          "completed",
      +          "answered_silently",
      +          "no_answer",
      +          "busy",
      +          "voicemail",
      +          "failed",
      +          "rejected",
      +          "canceled",
      +          "declined_recording",
      +          "opted_out"
      +        ],
      +        "type": "string"
      +      },
      +      "to": {
      +        "description": "Destination in E.164 format.",
      +        "type": "string"
      +      },
      +      "transcript": {
      +        "description": "Conversation entries; empty before speech is available.",
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "at_ms": {
      +              "description": "Milliseconds from the transcript timeline origin.",
      +              "type": "number"
      +            },
      +            "id": {
      +              "type": "string"
      +            },
      +            "role": {
      +              "description": "Speaker or confirmed keypad action.",
      +              "enum": [
      +                "callee",
      +                "agent",
      +                "keypad"
      +              ],
      +              "type": "string"
      +            },
      +            "sequence": {
      +              "type": "number"
      +            },
      +            "text": {
      +              "description": "Transcript text.",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "role",
      +            "text",
      +            "at_ms"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "transcript_truncated": {
      +        "description": "Whether earlier transcript content was omitted.",
      +        "type": "boolean"
      +      },
      +      "voice": {
      +        "anyOf": [
      +          {
      +            "description": "Resolved voice identifier.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      }
      +    },
      +    "required": [
      +      "call_id",
      +      "status",
      +      "to",
      +      "callee_name",
      +      "language",
      +      "locale",
      +      "voice",
      +      "amd_result",
      +      "duration_seconds",
      +      "is_public",
      +      "listen_url",
      +      "resolution",
      +      "transcript",
      +      "recording_url",
      +      "recording_status",
      +      "costs",
      +      "error",
      +      "created_at",
      +      "ended_at"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "error": {
      +        "description": "Machine-readable failure code.",
      +        "type": "string"
      +      },
      +      "message": {
      +        "description": "Explanation or recovery guidance.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "error"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "next_action": {
      +        "type": "string"
      +      },
      +      "operation_id": {
      +        "type": "string"
      +      },
      +      "status": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "operation_id",
      +      "status"
      +    ],
      +    "type": "object"
      +  }
      +]
  3. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "amd_result": {
      -        "anyOf": [
      -          {
      -            "description": "Answering-machine detection result.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "call_id": {
      -        "description": "Call identifier used with get_call, end_call and set_call_visibility.",
      -        "type": "string"
      -      },
      -      "callee_name": {
      -        "anyOf": [
      -          {
      -            "description": "Recipient display name.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "costs": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "currency": {
      -            "const": "USD",
      -            "type": "string"
      -          },
      -          "rate_version": {
      -            "anyOf": [
      -              {
      -                "description": "Rate deck version.",
      -                "type": "string"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "reserved_usage_units": {
      -            "anyOf": [
      -              {
      -                "description": "Reserved usage units; absent on legacy calls.",
      -                "type": "number"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          }
      -        },
      -        "required": [
      -          "currency",
      -          "rate_version"
      -        ],
      -        "type": "object"
      -      },
      -      "created_at": {
      -        "description": "ISO 8601 creation time.",
      -        "type": "string"
      -      },
      -      "duration_seconds": {
      -        "description": "Connected duration in seconds.",
      -        "type": "number"
      -      },
      -      "end_reason": {
      -        "description": "Reason the call ended.",
      -        "type": "string"
      -      },
      -      "ended_at": {
      -        "anyOf": [
      -          {
      -            "description": "ISO 8601 end time; null while active.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "ended_by": {
      -        "description": "Party or system that ended the call.",
      -        "type": "string"
      -      },
      -      "error": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "properties": {
      -              "code": {
      -                "description": "Call failure code.",
      -                "type": "string"
      -              },
      -              "message": {
      -                "description": "Call failure explanation.",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "code",
      -              "message"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "is_public": {
      -        "description": "Whether the call has a public link.",
      -        "type": "boolean"
      -      },
      -      "language": {
      -        "description": "Resolved call language.",
      -        "type": "string"
      -      },
      -      "listen_url": {
      -        "description": "URL for the user to listen, read the transcript and stop an active call.",
      -        "type": "string"
      -      },
      -      "locale": {
      -        "description": "Resolved BCP 47 language/locale for this call.",
      -        "type": "string"
      -      },
      -      "recording_status": {
      -        "description": "Recording availability.",
      -        "enum": [
      -          "none",
      -          "processing",
      -          "available",
      -          "failed"
      -        ],
      -        "type": "string"
      -      },
      -      "recording_url": {
      -        "anyOf": [
      -          {
      -            "description": "Audio URL when ready; private URLs expire.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "resolution": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "properties": {
      -              "callee_requested_no_further_calls": {
      -                "description": "Whether the recipient asked not to be called again.",
      -                "type": "boolean"
      -              },
      -              "commitments": {
      -                "description": "What the callee agreed to.",
      -                "items": {
      -                  "description": "Confirmed commitment.",
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "follow_ups": {
      -                "description": "Actions the user still needs to take.",
      -                "items": {
      -                  "description": "Next action.",
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "key_facts": {
      -                "description": "Useful information from the conversation.",
      -                "items": {
      -                  "description": "Fact learned.",
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "outcome": {
      -                "description": "Whether the call objective was met; unknown when review is unavailable or evidence is insufficient.",
      -                "enum": [
      -                  "achieved",
      -                  "partially_achieved",
      -                  "not_achieved",
      -                  "no_conversation",
      -                  "unknown"
      -                ],
      -                "type": "string"
      -              },
      -              "summary": {
      -                "description": "User-facing summary of what happened.",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "outcome",
      -              "summary",
      -              "commitments",
      -              "follow_ups",
      -              "key_facts",
      -              "callee_requested_no_further_calls"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "status": {
      -        "description": "Current call lifecycle state.",
      -        "enum": [
      -          "queued",
      -          "ringing",
      -          "in_progress",
      -          "completed",
      -          "answered_silently",
      -          "no_answer",
      -          "busy",
      -          "voicemail",
      -          "failed",
      -          "rejected",
      -          "canceled",
      -          "declined_recording",
      -          "opted_out"
      -        ],
      -        "type": "string"
      -      },
      -      "to": {
      -        "description": "Destination in E.164 format.",
      -        "type": "string"
      -      },
      -      "transcript": {
      -        "description": "Conversation entries; empty before speech is available.",
      -        "items": {
      -          "additionalProperties": {},
      -          "properties": {
      -            "at_ms": {
      -              "description": "Milliseconds from the transcript timeline origin.",
      -              "type": "number"
      -            },
      -            "id": {
      -              "type": "string"
      -            },
      -            "role": {
      -              "description": "Speaker or confirmed keypad action.",
      -              "enum": [
      -                "callee",
      -                "agent",
      -                "keypad"
      -              ],
      -              "type": "string"
      -            },
      -            "sequence": {
      -              "type": "number"
      -            },
      -            "text": {
      -              "description": "Transcript text.",
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "role",
      -            "text",
      -            "at_ms"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "transcript_truncated": {
      -        "description": "Whether earlier transcript content was omitted.",
      -        "type": "boolean"
      -      },
      -      "voice": {
      -        "anyOf": [
      -          {
      -            "description": "Resolved voice identifier.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "required": [
      -      "call_id",
      -      "status",
      -      "to",
      -      "callee_name",
      -      "language",
      -      "locale",
      -      "voice",
      -      "amd_result",
      -      "duration_seconds",
      -      "is_public",
      -      "listen_url",
      -      "resolution",
      -      "transcript",
      -      "recording_url",
      -      "recording_status",
      -      "costs",
      -      "error",
      -      "created_at",
      -      "ended_at"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "error": {
      -        "description": "Machine-readable failure code.",
      -        "type": "string"
      -      },
      -      "message": {
      -        "description": "Explanation or recovery guidance.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "error"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "amd_result": {
      +        "anyOf": [
      +          {
      +            "description": "Answering-machine detection result.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "call_id": {
      +        "description": "Call identifier used with get_call, end_call and set_call_visibility.",
      +        "type": "string"
      +      },
      +      "callee_name": {
      +        "anyOf": [
      +          {
      +            "description": "Recipient display name.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "costs": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "currency": {
      +            "const": "USD",
      +            "type": "string"
      +          },
      +          "rate_version": {
      +            "anyOf": [
      +              {
      +                "description": "Rate deck version.",
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "reserved_usage_units": {
      +            "anyOf": [
      +              {
      +                "description": "Reserved usage units; absent on legacy calls.",
      +                "type": "number"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          }
      +        },
      +        "required": [
      +          "currency",
      +          "rate_version"
      +        ],
      +        "type": "object"
      +      },
      +      "created_at": {
      +        "description": "ISO 8601 creation time.",
      +        "type": "string"
      +      },
      +      "duration_seconds": {
      +        "description": "Connected duration in seconds.",
      +        "type": "number"
      +      },
      +      "end_reason": {
      +        "description": "Reason the call ended.",
      +        "type": "string"
      +      },
      +      "ended_at": {
      +        "anyOf": [
      +          {
      +            "description": "ISO 8601 end time; null while active.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "ended_by": {
      +        "description": "Party or system that ended the call.",
      +        "type": "string"
      +      },
      +      "error": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "properties": {
      +              "code": {
      +                "description": "Call failure code.",
      +                "type": "string"
      +              },
      +              "message": {
      +                "description": "Call failure explanation.",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "code",
      +              "message"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "is_public": {
      +        "description": "Whether the call has a public link.",
      +        "type": "boolean"
      +      },
      +      "language": {
      +        "description": "Resolved call language.",
      +        "type": "string"
      +      },
      +      "listen_url": {
      +        "description": "URL for the user to listen, read the transcript and stop an active call.",
      +        "type": "string"
      +      },
      +      "locale": {
      +        "description": "Resolved BCP 47 language/locale for this call.",
      +        "type": "string"
      +      },
      +      "recording_status": {
      +        "description": "Recording availability.",
      +        "enum": [
      +          "none",
      +          "processing",
      +          "available",
      +          "failed"
      +        ],
      +        "type": "string"
      +      },
      +      "recording_url": {
      +        "anyOf": [
      +          {
      +            "description": "Audio URL when ready; private URLs expire.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "resolution": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "properties": {
      +              "callee_requested_no_further_calls": {
      +                "description": "Whether the recipient asked not to be called again.",
      +                "type": "boolean"
      +              },
      +              "commitments": {
      +                "description": "What the callee agreed to.",
      +                "items": {
      +                  "description": "Confirmed commitment.",
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "follow_ups": {
      +                "description": "Actions the user still needs to take.",
      +                "items": {
      +                  "description": "Next action.",
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "key_facts": {
      +                "description": "Useful information from the conversation.",
      +                "items": {
      +                  "description": "Fact learned.",
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "outcome": {
      +                "description": "Whether the call objective was met; unknown when review is unavailable or evidence is insufficient.",
      +                "enum": [
      +                  "achieved",
      +                  "partially_achieved",
      +                  "not_achieved",
      +                  "no_conversation",
      +                  "unknown"
      +                ],
      +                "type": "string"
      +              },
      +              "summary": {
      +                "description": "User-facing summary of what happened.",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "outcome",
      +              "summary",
      +              "commitments",
      +              "follow_ups",
      +              "key_facts",
      +              "callee_requested_no_further_calls"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "status": {
      +        "description": "Current call lifecycle state.",
      +        "enum": [
      +          "queued",
      +          "ringing",
      +          "in_progress",
      +          "completed",
      +          "answered_silently",
      +          "no_answer",
      +          "busy",
      +          "voicemail",
      +          "failed",
      +          "rejected",
      +          "canceled",
      +          "declined_recording",
      +          "opted_out"
      +        ],
      +        "type": "string"
      +      },
      +      "to": {
      +        "description": "Destination in E.164 format.",
      +        "type": "string"
      +      },
      +      "transcript": {
      +        "description": "Conversation entries; empty before speech is available.",
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "at_ms": {
      +              "description": "Milliseconds from the transcript timeline origin.",
      +              "type": "number"
      +            },
      +            "id": {
      +              "type": "string"
      +            },
      +            "role": {
      +              "description": "Speaker or confirmed keypad action.",
      +              "enum": [
      +                "callee",
      +                "agent",
      +                "keypad"
      +              ],
      +              "type": "string"
      +            },
      +            "sequence": {
      +              "type": "number"
      +            },
      +            "text": {
      +              "description": "Transcript text.",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "role",
      +            "text",
      +            "at_ms"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "transcript_truncated": {
      +        "description": "Whether earlier transcript content was omitted.",
      +        "type": "boolean"
      +      },
      +      "voice": {
      +        "anyOf": [
      +          {
      +            "description": "Resolved voice identifier.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      }
      +    },
      +    "required": [
      +      "call_id",
      +      "status",
      +      "to",
      +      "callee_name",
      +      "language",
      +      "locale",
      +      "voice",
      +      "amd_result",
      +      "duration_seconds",
      +      "is_public",
      +      "listen_url",
      +      "resolution",
      +      "transcript",
      +      "recording_url",
      +      "recording_status",
      +      "costs",
      +      "error",
      +      "created_at",
      +      "ended_at"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "error": {
      +        "description": "Machine-readable failure code.",
      +        "type": "string"
      +      },
      +      "message": {
      +        "description": "Explanation or recovery guidance.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "error"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "next_action": {
      +        "type": "string"
      +      },
      +      "operation_id": {
      +        "type": "string"
      +      },
      +      "status": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "operation_id",
      +      "status"
      +    ],
      +    "type": "object"
      +  }
      +]
  4. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "amd_result": {
      -        "anyOf": [
      -          {
      -            "description": "Answering-machine detection result.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "call_id": {
      -        "description": "Call identifier used with get_call, end_call and set_call_visibility.",
      -        "type": "string"
      -      },
      -      "callee_name": {
      -        "anyOf": [
      -          {
      -            "description": "Recipient display name.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "costs": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "currency": {
      -            "const": "USD",
      -            "type": "string"
      -          },
      -          "rate_version": {
      -            "anyOf": [
      -              {
      -                "description": "Rate deck version.",
      -                "type": "string"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "reserved_usage_units": {
      -            "anyOf": [
      -              {
      -                "description": "Reserved usage units; absent on legacy calls.",
      -                "type": "number"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          }
      -        },
      -        "required": [
      -          "currency",
      -          "rate_version"
      -        ],
      -        "type": "object"
      -      },
      -      "created_at": {
      -        "description": "ISO 8601 creation time.",
      -        "type": "string"
      -      },
      -      "duration_seconds": {
      -        "description": "Connected duration in seconds.",
      -        "type": "number"
      -      },
      -      "end_reason": {
      -        "description": "Reason the call ended.",
      -        "type": "string"
      -      },
      -      "ended_at": {
      -        "anyOf": [
      -          {
      -            "description": "ISO 8601 end time; null while active.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "ended_by": {
      -        "description": "Party or system that ended the call.",
      -        "type": "string"
      -      },
      -      "error": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "properties": {
      -              "code": {
      -                "description": "Call failure code.",
      -                "type": "string"
      -              },
      -              "message": {
      -                "description": "Call failure explanation.",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "code",
      -              "message"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "is_public": {
      -        "description": "Whether the call has a public link.",
      -        "type": "boolean"
      -      },
      -      "language": {
      -        "description": "Resolved call language.",
      -        "type": "string"
      -      },
      -      "listen_url": {
      -        "description": "URL for the user to listen, read the transcript and stop an active call.",
      -        "type": "string"
      -      },
      -      "locale": {
      -        "description": "Resolved BCP 47 language/locale for this call.",
      -        "type": "string"
      -      },
      -      "recording_status": {
      -        "description": "Recording availability.",
      -        "enum": [
      -          "none",
      -          "processing",
      -          "available",
      -          "failed"
      -        ],
      -        "type": "string"
      -      },
      -      "recording_url": {
      -        "anyOf": [
      -          {
      -            "description": "Audio URL when ready; private URLs expire.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "resolution": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "properties": {
      -              "callee_requested_no_further_calls": {
      -                "description": "Whether the recipient asked not to be called again.",
      -                "type": "boolean"
      -              },
      -              "commitments": {
      -                "description": "What the callee agreed to.",
      -                "items": {
      -                  "description": "Confirmed commitment.",
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "follow_ups": {
      -                "description": "Actions the user still needs to take.",
      -                "items": {
      -                  "description": "Next action.",
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "key_facts": {
      -                "description": "Useful information from the conversation.",
      -                "items": {
      -                  "description": "Fact learned.",
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "outcome": {
      -                "description": "Whether the call objective was met.",
      -                "enum": [
      -                  "achieved",
      -                  "partially_achieved",
      -                  "not_achieved",
      -                  "no_conversation"
      -                ],
      -                "type": "string"
      -              },
      -              "summary": {
      -                "description": "User-facing summary of what happened.",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "outcome",
      -              "summary",
      -              "commitments",
      -              "follow_ups",
      -              "key_facts",
      -              "callee_requested_no_further_calls"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "status": {
      -        "description": "Current call lifecycle state.",
      -        "enum": [
      -          "queued",
      -          "ringing",
      -          "in_progress",
      -          "completed",
      -          "no_answer",
      -          "busy",
      -          "voicemail",
      -          "failed",
      -          "rejected",
      -          "canceled",
      -          "declined_recording",
      -          "opted_out"
      -        ],
      -        "type": "string"
      -      },
      -      "to": {
      -        "description": "Destination in E.164 format.",
      -        "type": "string"
      -      },
      -      "transcript": {
      -        "description": "Conversation entries; empty before speech is available.",
      -        "items": {
      -          "additionalProperties": {},
      -          "properties": {
      -            "at_ms": {
      -              "description": "Milliseconds from the transcript timeline origin.",
      -              "type": "number"
      -            },
      -            "id": {
      -              "type": "string"
      -            },
      -            "role": {
      -              "description": "Speaker or confirmed keypad action.",
      -              "enum": [
      -                "callee",
      -                "agent",
      -                "keypad"
      -              ],
      -              "type": "string"
      -            },
      -            "sequence": {
      -              "type": "number"
      -            },
      -            "text": {
      -              "description": "Transcript text.",
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "role",
      -            "text",
      -            "at_ms"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "transcript_truncated": {
      -        "description": "Whether earlier transcript content was omitted.",
      -        "type": "boolean"
      -      },
      -      "voice": {
      -        "anyOf": [
      -          {
      -            "description": "Resolved voice identifier.",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "required": [
      -      "call_id",
      -      "status",
      -      "to",
      -      "callee_name",
      -      "language",
      -      "locale",
      -      "voice",
      -      "amd_result",
      -      "duration_seconds",
      -      "is_public",
      -      "listen_url",
      -      "resolution",
      -      "transcript",
      -      "recording_url",
      -      "recording_status",
      -      "costs",
      -      "error",
      -      "created_at",
      -      "ended_at"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "error": {
      -        "description": "Machine-readable failure code.",
      -        "type": "string"
      -      },
      -      "message": {
      -        "description": "Explanation or recovery guidance.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "error"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "amd_result": {
      +        "anyOf": [
      +          {
      +            "description": "Answering-machine detection result.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "call_id": {
      +        "description": "Call identifier used with get_call, end_call and set_call_visibility.",
      +        "type": "string"
      +      },
      +      "callee_name": {
      +        "anyOf": [
      +          {
      +            "description": "Recipient display name.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "costs": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "currency": {
      +            "const": "USD",
      +            "type": "string"
      +          },
      +          "rate_version": {
      +            "anyOf": [
      +              {
      +                "description": "Rate deck version.",
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "reserved_usage_units": {
      +            "anyOf": [
      +              {
      +                "description": "Reserved usage units; absent on legacy calls.",
      +                "type": "number"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          }
      +        },
      +        "required": [
      +          "currency",
      +          "rate_version"
      +        ],
      +        "type": "object"
      +      },
      +      "created_at": {
      +        "description": "ISO 8601 creation time.",
      +        "type": "string"
      +      },
      +      "duration_seconds": {
      +        "description": "Connected duration in seconds.",
      +        "type": "number"
      +      },
      +      "end_reason": {
      +        "description": "Reason the call ended.",
      +        "type": "string"
      +      },
      +      "ended_at": {
      +        "anyOf": [
      +          {
      +            "description": "ISO 8601 end time; null while active.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "ended_by": {
      +        "description": "Party or system that ended the call.",
      +        "type": "string"
      +      },
      +      "error": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "properties": {
      +              "code": {
      +                "description": "Call failure code.",
      +                "type": "string"
      +              },
      +              "message": {
      +                "description": "Call failure explanation.",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "code",
      +              "message"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "is_public": {
      +        "description": "Whether the call has a public link.",
      +        "type": "boolean"
      +      },
      +      "language": {
      +        "description": "Resolved call language.",
      +        "type": "string"
      +      },
      +      "listen_url": {
      +        "description": "URL for the user to listen, read the transcript and stop an active call.",
      +        "type": "string"
      +      },
      +      "locale": {
      +        "description": "Resolved BCP 47 language/locale for this call.",
      +        "type": "string"
      +      },
      +      "recording_status": {
      +        "description": "Recording availability.",
      +        "enum": [
      +          "none",
      +          "processing",
      +          "available",
      +          "failed"
      +        ],
      +        "type": "string"
      +      },
      +      "recording_url": {
      +        "anyOf": [
      +          {
      +            "description": "Audio URL when ready; private URLs expire.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "resolution": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "properties": {
      +              "callee_requested_no_further_calls": {
      +                "description": "Whether the recipient asked not to be called again.",
      +                "type": "boolean"
      +              },
      +              "commitments": {
      +                "description": "What the callee agreed to.",
      +                "items": {
      +                  "description": "Confirmed commitment.",
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "follow_ups": {
      +                "description": "Actions the user still needs to take.",
      +                "items": {
      +                  "description": "Next action.",
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "key_facts": {
      +                "description": "Useful information from the conversation.",
      +                "items": {
      +                  "description": "Fact learned.",
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "outcome": {
      +                "description": "Whether the call objective was met; unknown when review is unavailable or evidence is insufficient.",
      +                "enum": [
      +                  "achieved",
      +                  "partially_achieved",
      +                  "not_achieved",
      +                  "no_conversation",
      +                  "unknown"
      +                ],
      +                "type": "string"
      +              },
      +              "summary": {
      +                "description": "User-facing summary of what happened.",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "outcome",
      +              "summary",
      +              "commitments",
      +              "follow_ups",
      +              "key_facts",
      +              "callee_requested_no_further_calls"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "status": {
      +        "description": "Current call lifecycle state.",
      +        "enum": [
      +          "queued",
      +          "ringing",
      +          "in_progress",
      +          "completed",
      +          "answered_silently",
      +          "no_answer",
      +          "busy",
      +          "voicemail",
      +          "failed",
      +          "rejected",
      +          "canceled",
      +          "declined_recording",
      +          "opted_out"
      +        ],
      +        "type": "string"
      +      },
      +      "to": {
      +        "description": "Destination in E.164 format.",
      +        "type": "string"
      +      },
      +      "transcript": {
      +        "description": "Conversation entries; empty before speech is available.",
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "at_ms": {
      +              "description": "Milliseconds from the transcript timeline origin.",
      +              "type": "number"
      +            },
      +            "id": {
      +              "type": "string"
      +            },
      +            "role": {
      +              "description": "Speaker or confirmed keypad action.",
      +              "enum": [
      +                "callee",
      +                "agent",
      +                "keypad"
      +              ],
      +              "type": "string"
      +            },
      +            "sequence": {
      +              "type": "number"
      +            },
      +            "text": {
      +              "description": "Transcript text.",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "role",
      +            "text",
      +            "at_ms"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "transcript_truncated": {
      +        "description": "Whether earlier transcript content was omitted.",
      +        "type": "boolean"
      +      },
      +      "voice": {
      +        "anyOf": [
      +          {
      +            "description": "Resolved voice identifier.",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      }
      +    },
      +    "required": [
      +      "call_id",
      +      "status",
      +      "to",
      +      "callee_name",
      +      "language",
      +      "locale",
      +      "voice",
      +      "amd_result",
      +      "duration_seconds",
      +      "is_public",
      +      "listen_url",
      +      "resolution",
      +      "transcript",
      +      "recording_url",
      +      "recording_status",
      +      "costs",
      +      "error",
      +      "created_at",
      +      "ended_at"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "error": {
      +        "description": "Machine-readable failure code.",
      +        "type": "string"
      +      },
      +      "message": {
      +        "description": "Explanation or recovery guidance.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "error"
      +    ],
      +    "type": "object"
      +  }
      +]
  5. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "http://json-schema.org/draft-07/schema#",
      +  "anyOf": [
      +    {
      +      "additionalProperties": {},
      +      "properties": {
      +        "amd_result": {
      +          "anyOf": [
      +            {
      +              "description": "Answering-machine detection result.",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "call_id": {
      +          "description": "Call identifier used with get_call, end_call and set_call_visibility.",
      +          "type": "string"
      +        },
      +        "callee_name": {
      +          "anyOf": [
      +            {
      +              "description": "Recipient display name.",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "costs": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "currency": {
      +              "const": "USD",
      +              "type": "string"
      +            },
      +            "rate_version": {
      +              "anyOf": [
      +                {
      +                  "description": "Rate deck version.",
      +                  "type": "string"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            },
      +            "reserved_usage_units": {
      +              "anyOf": [
      +                {
      +                  "description": "Reserved usage units; absent on legacy calls.",
      +                  "type": "number"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            }
      +          },
      +          "required": [
      +            "currency",
      +            "rate_version"
      +          ],
      +          "type": "object"
      +        },
      +        "created_at": {
      +          "description": "ISO 8601 creation time.",
      +          "type": "string"
      +        },
      +        "duration_seconds": {
      +          "description": "Connected duration in seconds.",
      +          "type": "number"
      +        },
      +        "end_reason": {
      +          "description": "Reason the call ended.",
      +          "type": "string"
      +        },
      +        "ended_at": {
      +          "anyOf": [
      +            {
      +              "description": "ISO 8601 end time; null while active.",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "ended_by": {
      +          "description": "Party or system that ended the call.",
      +          "type": "string"
      +        },
      +        "error": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": {},
      +              "properties": {
      +                "code": {
      +                  "description": "Call failure code.",
      +                  "type": "string"
      +                },
      +                "message": {
      +                  "description": "Call failure explanation.",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "code",
      +                "message"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "is_public": {
      +          "description": "Whether the call has a public link.",
      +          "type": "boolean"
      +        },
      +        "language": {
      +          "description": "Resolved call language.",
      +          "type": "string"
      +        },
      +        "listen_url": {
      +          "description": "URL for the user to listen, read the transcript and stop an active call.",
      +          "type": "string"
      +        },
      +        "locale": {
      +          "description": "Resolved BCP 47 language/locale for this call.",
      +          "type": "string"
      +        },
      +        "recording_status": {
      +          "description": "Recording availability.",
      +          "enum": [
      +            "none",
      +            "processing",
      +            "available",
      +            "failed"
      +          ],
      +          "type": "string"
      +        },
      +        "recording_url": {
      +          "anyOf": [
      +            {
      +              "description": "Audio URL when ready; private URLs expire.",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "resolution": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": {},
      +              "properties": {
      +                "callee_requested_no_further_calls": {
      +                  "description": "Whether the recipient asked not to be called again.",
      +                  "type": "boolean"
      +                },
      +                "commitments": {
      +                  "description": "What the callee agreed to.",
      +                  "items": {
      +                    "description": "Confirmed commitment.",
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                },
      +                "follow_ups": {
      +                  "description": "Actions the user still needs to take.",
      +                  "items": {
      +                    "description": "Next action.",
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                },
      +                "key_facts": {
      +                  "description": "Useful information from the conversation.",
      +                  "items": {
      +                    "description": "Fact learned.",
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                },
      +                "outcome": {
      +                  "description": "Whether the call objective was met.",
      +                  "enum": [
      +                    "achieved",
      +                    "partially_achieved",
      +                    "not_achieved",
      +                    "no_conversation"
      +                  ],
      +                  "type": "string"
      +                },
      +                "summary": {
      +                  "description": "User-facing summary of what happened.",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "outcome",
      +                "summary",
      +                "commitments",
      +                "follow_ups",
      +                "key_facts",
      +                "callee_requested_no_further_calls"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "status": {
      +          "description": "Current call lifecycle state.",
      +          "enum": [
      +            "queued",
      +            "ringing",
      +            "in_progress",
      +            "completed",
      +            "no_answer",
      +            "busy",
      +            "voicemail",
      +            "failed",
      +            "rejected",
      +            "canceled",
      +            "declined_recording",
      +            "opted_out"
      +          ],
      +          "type": "string"
      +        },
      +        "to": {
      +          "description": "Destination in E.164 format.",
      +          "type": "string"
      +        },
      +        "transcript": {
      +          "description": "Conversation entries; empty before speech is available.",
      +          "items": {
      +            "additionalProperties": {},
      +            "properties": {
      +              "at_ms": {
      +                "description": "Milliseconds from the transcript timeline origin.",
      +                "type": "number"
      +              },
      +              "id": {
      +                "type": "string"
      +              },
      +              "role": {
      +                "description": "Speaker or confirmed keypad action.",
      +                "enum": [
      +                  "callee",
      +                  "agent",
      +                  "keypad"
      +                ],
      +                "type": "string"
      +              },
      +              "sequence": {
      +                "type": "number"
      +              },
      +              "text": {
      +                "description": "Transcript text.",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "role",
      +              "text",
      +              "at_ms"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "transcript_truncated": {
      +          "description": "Whether earlier transcript content was omitted.",
      +          "type": "boolean"
      +        },
      +        "voice": {
      +          "anyOf": [
      +            {
      +              "description": "Resolved voice identifier.",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        }
      +      },
      +      "required": [
      +        "call_id",
      +        "status",
      +        "to",
      +        "callee_name",
      +        "language",
      +        "locale",
      +        "voice",
      +        "amd_result",
      +        "duration_seconds",
      +        "is_public",
      +        "listen_url",
      +        "resolution",
      +        "transcript",
      +        "recording_url",
      +        "recording_status",
      +        "costs",
      +        "error",
      +        "created_at",
      +        "ended_at"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "additionalProperties": {},
      +      "properties": {
      +        "error": {
      +          "description": "Machine-readable failure code.",
      +          "type": "string"
      +        },
      +        "message": {
      +          "description": "Explanation or recovery guidance.",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "error"
      +      ],
      +      "type": "object"
      +    }
      +  ],
      +  "description": "Successful result or a machine-readable tool error.",
      +  "type": "object"
      +}
  6. First observed

TDQS

A4.5/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only say read-only/non-destructive; the description goes far beyond by disclosing long-poll semantics (max 50s, early return on status change), the full terminal status set, that resolution can lag the terminal status by seconds, that recording_url links expire after ~1 hour and need the OAuth header on staging, and that recording_status=processing means a separate copy is still finalizing. These are exactly the operational facts an agent cannot infer from structured fields.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose is correctly front-loaded, but the body is one dense run-on paragraph that crams terminal statuses, resolution shape, transcript, recording expiry, staging auth, public-call URLs, and retry advice together with no grouping. Some lines are near-redundant ('A recording can fail or be unavailable', the repeated 'call get_call again'), so it is longer than it needs to be for the information delivered.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite an output schema existing, the description supplies everything an agent needs to interpret the richer-than-usual response states: the meaning of 'rejected' vs other terminal statuses, what to do when outcome is 'unknown', that resolution precedes the transcript, and how listen_url/public URLs differ. Nothing material about calling or reading the result is left unexplained.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3, but the description adds real meaning: wait_seconds is not just 'server-side long-poll' — the server holds the request and returns early on any status change, which is how you avoid polling loops. call_id's origin (returned by place_call) is also restated usefully in context.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a specific verb + resource + scope: 'Get the status and, once terminal, the structured resolution of a call started with place_call.' It explicitly ties itself to place_call as the creator and names set_call_visibility as a different action, so an agent can distinguish it from the listing/diagnostics siblings without opening a schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives concrete when-to guidance: default is an instant check; pass wait_seconds to long-poll instead of round-tripping, and call again on a terminal call to wait for a recording state change. It also states when NOT to act ('use set_call_visibility only when the user explicitly asks', 'ended_by=user ... don't retry'). It does not, however, route the agent to get_call_diagnostics or get_call_listener for those sibling use cases.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources