List Real-time STT agents
Updated
Retrieves Real-time STT agents that match specified criteria.
https://api.agora.io/api/speech-to-text/v1/projects/{appid}/agentsUse this method to retrieve a list of real-time transcription and translation agents that match specified criteria.
Path Parameters
The App ID of the project.
Query Parameters
Filters the agent list by channel name.
The start of the query time range, as a Unix timestamp in seconds. Defaults to 1 day ago.
The end of the query time range, as a Unix timestamp in seconds. Defaults to the current time.
Filters agents by status. Only one status value can be specified per request:
0-IDLE: The agent is not initialized.1-STARTING: The agent is starting.2-RUNNING: The agent is running.3-STOPPING: The agent is exiting.4-STOPPED: The agent exited successfully.5-RECOVERING: The agent is recovering.6-FAILED: The agent exited with a failure.
2The pagination cursor. Set this to the agent_id of the last item from the previous page to retrieve the next page of results.
Response
- If the returned status code is
200, the request was successful. The response body contains the result of the request.
Response Body
application/json
application/json
Response schema
200OK
The number of agents returned in this response.
The list of agents matching the query criteria.
The Unix timestamp (in seconds) when the agent was created.
The current status of the agent:
IDLE: The agent is not initialized.STARTING: The agent is starting.RUNNING: The agent is running.STOPPING: The agent is exiting.STOPPED: The agent exited successfully.RECOVERING: The agent is recovering.FAILED: The agent exited with a failure.
The agent ID.
Metadata about the returned list.
The pagination cursor for the next page of results.
The total number of agents matching the query criteria.
The request status.
Response
Refer to the detail and reason fields to understand the possible reasons for failure.
Request examples
curl --request GET \
--url 'https://api.agora.io/api/speech-to-text/v1/projects/:appid/agents?state=2&limit=20' \
--header 'Authorization: Basic <credentials>'
Response example
{ "data": { "count": 1, "list": [ { "start_ts": 1735035893, "status": "RUNNING", "agent_id": "1NT29X11GQSxxxxx80BEIN56XF" } ] }, "meta": { "cursor": "", "total": 1 }, "status": "ok"}