Call someone on the owner's behalf.

Say what you would tell a person, including what to accept if the first answer is no. Returns straight away with a call id; the call itself takes minutes.

post/calls

Request

  • Base URL: https://cosvoice.com/api/v1
  • URL: https://cosvoice.com/api/v1/calls
  • Auth: HTTP bearer

Request body

tostring required

Who to call, E.164.

purposestring required

The job, in plain English, including fallbacks. Up to 1,200 characters; a longer purpose is refused with an error, never trimmed.

callee_namestring

Who is being called.

desired_resolutionstring

What a good ending looks like.

max_minutesinteger

Hard stop for the call. No call runs longer than 10 minutes.

Example request

{
  "to": "+13105550142",
  "purpose": "Book a table for two this Friday at 7:30 under Graham. If 7:30 is gone, take anything between 7:00 and 8:30.",
  "callee_name": "Osteria Mozza, host stand",
  "desired_resolution": "A confirmed reservation with a time."
}

Response

The call was placed.

Example response

{
  "call": {
    "outcome": "Reserved · Friday 8:15pm · party of 2"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.