Elenca agenti

GET

/v1/convai/agents

GET

/v1/convai/agents

curl -G https://api.elevenlabs.io/v1/convai/agents \
     -d archived=true \
     -d created_by_user_id=created_by_user_id \
     -d cursor=cursor \
     -d page_size=1 \
     -d search=search \
     -d show_only_owned_agents=true \
     -d sort_by=name \
     -d sort_direction=asc \
     -d tags=tags

{
  "agents": [
    {
      "agent_id": "J3Pbu5gP6NNKBscdCdwB",
      "name": "My Agent",
      "voice_id": "UCaNsl8F6Xh4GALkVMLS",
      "tags": [
        "Customer Support",
        "Technical Help",
        "Eleven"
      ],
      "created_at_unix_secs": 1716153600,
      "access_info": {
        "is_creator": true,
        "creator_name": "John Doe",
        "creator_email": "john@example.com",
        "role": "admin"
      },
      "last_call_time_unix_secs": 1,
      "archived": false
    }
  ],
  "has_more": false,
  "next_cursor": "123"
}

Restituisce un elenco dei tuoi agenti e dei relativi metadati.

Parametri di query

page_sizeintegerOpzionale1-100Predefinito a 30

Numero massimo di agenti da restituire. Non può superare 100; il valore predefinito è 30.

searchstringOpzionale

Cerca per nome degli agenti.

archivedbooleanOpzionale

Filtra gli agenti in base allo stato di archiviazione

show_only_owned_agentsbooleanOpzionalePredefinito a falseDeprecated

Se impostato su true, l'endpoint ometterà gli agenti condivisi con te da altri e includerà solo quelli di tua proprietà. Deprecato: usa invece created_by_user_id.

created_by_user_idstringOpzionale

Filtra gli agenti in base all'ID dell'utente creatore. Se impostato, vengono restituiti solo gli agenti creati da questo utente. Ha la precedenza su show_only_owned_agents. Usa '@me' per fare riferimento all'utente autenticato.

tagsstringOpzionale

Filtra gli agenti in base al tag. Ripeti il parametro per trovare una corrispondenza con uno qualsiasi di più tag.

sort_directionenumOpzionale

La direzione per ordinare i risultati

Valori consentiti:

sort_byenumOpzionale

Il campo in base al quale ordinare i risultati

Valori consentiti:

cursorstringOpzionale

Usato per recuperare la pagina successiva. Il cursore viene restituito nella risposta.

Risposta

Risposta riuscita

agentslist of objects

Un elenco di agenti e dei relativi metadati.

has_moreboolean

Indica se ci sono altri agenti da visualizzare tramite paginazione

next_cursorstringOpzionale

Il cursore successivo per paginare gli agenti

Errori

422

Agents List Request Unprocessable Entity Error

Header

Parametri di query

Risposta

Errori