> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Elenca invocazioni dei test

GET https://api.elevenlabs.io/v1/convai/test-invocations

Elenca tutte le esecuzioni dei test con supporto per la paginazione e filtro di ricerca facoltativo.

Reference: https://elevenlabs.io/docs/api-reference/tests/test-invocations/list

## Servers

- `https://api.elevenlabs.io` (Production, default)
- `https://api.us.elevenlabs.io` (Production US)
- `https://api.eu.residency.elevenlabs.io` (Production EU)
- `https://api.in.residency.elevenlabs.io` (Production India)
- `https://api.sg.residency.elevenlabs.io` (Production Singapore)

## Request

### Query parameters

- `agent_id` (string, optional, nullable) — Filtra in base all'ID dell'agente
- `branch_id` (string, optional, nullable) — Filtra in base all'ID del branch
- `page_size` (integer, optional, default: 30) — Numero massimo di test da restituire. Non può superare 100; il valore predefinito è 30.
- `search` (string, optional, nullable) — Query di ricerca per filtrare test e cartelle in base al nome.
- `cursor` (string, optional, nullable) — Usato per recuperare la pagina successiva. Il cursore viene restituito nella risposta.

## Response

### 200

Risposta riuscita

- `results` (list of TestInvocationSummaryResponseModel, required)
- `has_more` (boolean, required) — Indica se sono disponibili altri risultati
- `meta` (ListResponseMeta, optional)
- `next_cursor` (string, optional, nullable) — Cursore per la pagina successiva dei risultati

## Errors

### 422 Unprocessable Entity Error

Errore di convalida

- `detail` (list of ValidationError, optional)

## Types

### TestInvocationSummaryResponseModel

- `id` (string, required) — L'ID dell'esecuzione di test
- `created_at_unix_secs` (integer, required) — Ora di creazione dell'esecuzione del test in secondi Unix
- `test_run_count` (integer, required) — Numero di esecuzioni di test in questa invocazione
- `passed_count` (integer, required) — Numero di esecuzioni di test superate
- `failed_count` (integer, required) — Numero di esecuzioni di test non riuscite
- `pending_count` (integer, required) — Numero di esecuzioni di test in attesa
- `cancelled_count` (integer, required) — Numero di esecuzioni di test annullate
- `title` (string, required) — Titolo dell'invocazione del test: il nome della cartella per le esecuzioni di cartelle, altrimenti il nome del singolo test o il numero di test
- `agent_id` (string, optional, nullable) — L'ID dell'agente a cui appartiene questa esecuzione di test
- `branch_id` (string, optional, nullable) — L'ID del branch su cui è stata eseguita questa invocazione di test
- `version_id` (string, optional, nullable) — L'ID della versione dell'agente su cui è stata eseguita questa invocazione di test. Per le esecuzioni in bozza o con override della configurazione, è la versione su cui sono state applicate le modifiche non salvate. None è previsto solo per le esecuzioni registrate prima dell'introduzione di questo campo.
- `ran_against_draft` (boolean, optional, default: false) — Se il run includeva modifiche senza commit (una bozza salvata o una sovrascrittura ad hoc della configurazione) applicate sopra version_id.
- `runs_diverged_from_version` (boolean, optional, default: false) — Se i run di test in questa invocazione non sono stati tutti eseguiti rispetto alla stessa versione, cosa che accade quando un sottoinsieme di run viene inviato nuovamente dopo il run originale. Se true, version_id descrive il nuovo invio più recente anziché ogni run.
- `access_info` (ResourceAccessInfo, optional, nullable) — Le informazioni di accesso dell'invocazione del test
- `repeat_count` (integer, optional, default: 1) — Numero di volte in cui ogni test è stato ripetuto in questa invocazione
- `cancelled` (boolean, optional, default: false) — Indica se questa esecuzione del test è stata annullata
- `credits_used` (integer, optional, nullable) — Totale dei crediti fatturati nelle esecuzioni di test in questa invocazione. None se nessuna esecuzione dispone di dati sui costi.
- `total_price` (double, optional, nullable) — Prezzo totale in USD nelle esecuzioni di test in questa invocazione. None se nessuna esecuzione dispone di dati sui prezzi.

### ListResponseMeta

- `total` (integer, optional, nullable)
- `page` (integer, optional, nullable)
- `page_size` (integer, optional, nullable)

### ValidationError

- `loc` (list of ValidationErrorLocItems, required)
- `msg` (string, required)
- `type` (string, required)

### ResourceAccessInfo

- `is_creator` (boolean, required) — Se l'utente che effettua la richiesta è il creatore dell'agente
- `creator_name` (string, required) — Nome del creatore dell'agente
- `creator_email` (string, required) — Email del creatore dell'agente
- `role` (enum, required) — Il ruolo dell'utente che effettua la richiesta
  - Allowed values: `admin`, `editor`, `commenter`, `viewer`
- `anonymous_access_level_override` (enum, optional, nullable) — Il livello di accesso per gli utenti anonimi. Se è None, la risorsa non è condivisa pubblicamente.
  - Allowed values: `admin`, `editor`, `commenter`, `viewer`
- `access_source` (enum, optional, nullable) — Motivo per cui l'utente richiedente ha accesso a questa risorsa. 'creator' = il chiamante è il proprietario. 'explicit' = il chiamante, o uno dei suoi gruppi del workspace, è elencato in role_to_group_ids oltre al gruppo everyone dell'intero workspace. 'workspace_default' = il gruppo everyone dell'intero workspace è elencato in role_to_group_ids (ogni membro non anonimo del workspace, inclusi gli amministratori, vede questa risorsa). 'workspace_admin' = il chiamante è un amministratore del workspace e il ruolo di amministratore è l'*unica* modalità di accesso; riservato ai documenti che nessun altro può vedere. Consente all'interfaccia di indicare perché un visualizzatore con bypass da amministratore vede un documento che non è stato condiviso esplicitamente con lui.
  - Allowed values: `creator`, `explicit`, `workspace_admin`, `workspace_default`

### ValidationErrorLocItems

## Examples

**Response**

```json
{
  "results": [
    {
      "id": "string",
      "created_at_unix_secs": 1,
      "test_run_count": 1,
      "passed_count": 1,
      "failed_count": 1,
      "pending_count": 1,
      "cancelled_count": 1,
      "title": "string",
      "agent_id": "string",
      "branch_id": "string",
      "version_id": "string",
      "ran_against_draft": false,
      "runs_diverged_from_version": false,
      "access_info": {
        "is_creator": true,
        "creator_name": "John Doe",
        "creator_email": "john.doe@example.com",
        "role": "admin",
        "access_source": "creator"
      },
      "repeat_count": 1,
      "cancelled": false,
      "credits_used": 1,
      "total_price": 1.1
    }
  ],
  "has_more": true,
  "meta": {
    "total": 1,
    "page": 1,
    "page_size": 1
  },
  "next_cursor": "string"
}
```

**SDK Code**

```python
import requests

url = "https://api.elevenlabs.io/v1/convai/test-invocations"

response = requests.get(url)

print(response.json())
```

```javascript
const url = 'https://api.elevenlabs.io/v1/convai/test-invocations';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.elevenlabs.io/v1/convai/test-invocations"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.elevenlabs.io/v1/convai/test-invocations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.elevenlabs.io/v1/convai/test-invocations")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.elevenlabs.io/v1/convai/test-invocations');

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.elevenlabs.io/v1/convai/test-invocations");
var request = new RestRequest(Method.GET);
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let request = NSMutableURLRequest(url: NSURL(string: "https://api.elevenlabs.io/v1/convai/test-invocations")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```