Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This resource returns details related to the specified agent, most commonly used to get the GUID of the current or previous call.

Insert excerpt
_ExcerptRequestScheme
_ExcerptRequestScheme
nopaneltrue

Request URI

GET v{v#}/{accountKey}/agents/{agentId}

Insert excerpt
_ExcerptAPIHeaders
_ExcerptAPIHeaders
nopaneltrue

Examples

Insert excerpt
_ExcerptAPICloud
_ExcerptAPICloud
nopaneltrue

Determine the call GUID for agent 462's previous call

curl -X GET "https://***.newvoicemedia.com/v0/a1b2c3d4e5/agents/462" -H "Authorization: Bearer <ACCESS_TOKEN>" -H "Accept: application/json"

Determine the call GUID for agent 462's current call

curl -X GET "https://***.newvoicemedia.com/v0/a1b2c3d4e5/agents/462" -H "Authorization: Bearer <ACCESS_TOKEN>" -H "Accept: application/json"

Example: Successful response

Insert excerpt
_ExcerptAPICloud
_ExcerptAPICloud
nopaneltrue

Returns HTTP Status Code 200 OK.

{
id: "462"
links: [
{
href: https://***.newvoicemedia.com/V0/a1b2c3d4e5/Agents/462
rel: "_self"
}
{
href: https://***.newvoicemedia.com/V0/a1b2c3d4e5/Calls/01461e37-deb9-b2bf-240d-032be5fe917e
rel: "currentCall"
}
]
currentCallGuid: "01461e37-deb9-b2bf-240d-032be5fe917e"
}