Agent API Troubleshooting

Review these troubleshooting tips if you run into issues when calling the API.

If you receive an HTTP 400 response, there's a problem with your request.

  • Message field in response contains "{VALUE} is not a valid agent ID". Verify that your agent ID is correct in your API request. See Call the API.

If you recieve an HTTP 401 response, there's typically an authorization issue. Review Get Started with Agent API.

If you receive an HTTP 404 response, verify that you're using the correct token and that you're using the correct endpoint. Review Get Started with Agent API.

If you receive an HTTP 500 response, verify that you've followed the setup instructions correctly.

  • Message field in response contains "Unsupported Media Type". Use the correct Content-Type value in the header: Content-Type: application/json.
  • Error field in response contains "EngineConfigLookupException". When specifying your domain in the start session endpoint, make sure that you're using the My Domain endpoint for your org. From Setup, search for My Domain. Copy the value shown in the Current My Domain URL field.
  • Error field in response contains "HttpServerErrorException". Verify that you are using the correct agent ID in the endpoint. See Get the Agent ID for an Agent for instructions on obtaining your agent ID.
  • For other issues, review Get Started with Agent API.