Skip to main content
POST
/
v2
/
voice-agents
/
web-tool
/
version-check
Check Newer Versions for Web Tools
curl --request POST \
  --url https://api.tryhamsa.com/v2/voice-agents/web-tool/version-check \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "webToolIds": [
    "48f7656f-098b-4c43-b165-7cfd2cc8ac30",
    "59g8767g-109c-5d54-c276-8dgd3dd9bd41"
  ],
  "overrides": {
    "48f7656f-098b-4c43-b165-7cfd2cc8ac30": {
      "params": {
        "location": "New York"
      },
      "httpHeaders": {
        "X-Custom-Header": "value"
      }
    }
  }
}
'
{
  "success": true,
  "data": [
    {
      "toolId": "48f7656f-098b-4c43-b165-7cfd2cc8ac30",
      "hasNewerVersions": true,
      "latestVersion": 3,
      "latestVersionToolId": "59g8767g-109c-5d54-c276-8dgd3dd9bd41",
      "conflicts": {
        "params": [
          "<string>"
        ],
        "httpHeaders": [
          "<string>"
        ]
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Pass the API key in the Authorization header, You need to put Token keyword before the API key. e.g. 'Authorization: Token '

Body

application/json
​
webToolIds
string<uuid>[]
required

Array of web tool IDs to check for newer versions

Example:
[
  "48f7656f-098b-4c43-b165-7cfd2cc8ac30",
  "59g8767g-109c-5d54-c276-8dgd3dd9bd41"
]
​
overrides
object

Optional overrides to check for conflicts. Keys are web tool IDs.

Example:
{
  "48f7656f-098b-4c43-b165-7cfd2cc8ac30": {
    "params": { "location": "New York" },
    "httpHeaders": { "X-Custom-Header": "value" }
  }
}

Response

Successful response

​
success
boolean
Example:

true

​
data
object[]