The Agent API is a set of method calls used to create, manage, and end "agent sessions". With an agent session, you are able to set the agent’s state and manage interactions (phone calls, chats, emails, voice mails, and work items).

To start an agent session, you need to get an API token from the token service. All API methods require some form of authentication token in each method call. Most agent applications require an Implicit or Password authentication token. See the API authentication token tutorial for information on what type of token is needed for your application and how to get an API Authentication Token.

Once you have an API Authentication Token, you use this token to create an agent session for the agent whose credentials you used to get the token. This is done by requesting the method, https://api-{cluster} and supplying either a "station ID" or a phone number which will be delivered to the agent.

Once you start an agent session, you receive a "session ID". This will be used in most Agent API method calls. The agent session is referenced using its ID as a resource, like this: https://api-{cluster}{session-id}