> 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.

# Lista testkörningar

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

Listar alla testanrop med stöd för sidindelning och valfri sökfiltrering.

Reference: https://elevenlabs.io/docs/eleven-agents/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) — Filtrera efter agent-ID
- `branch_id` (string, optional) — Filtrera efter gren-ID
- `page_size` (integer, optional, default: 30) — Maximalt antal tester att returnera. Får inte överstiga 100, standardvärdet är 30.
- `search` (string, optional) — Sökfråga för att filtrera tester och mappar efter namn.
- `cursor` (string, optional) — Används för att hämta nästa sida. Markören returneras i svaret.

## Response

### 200

Lyckat svar

- `results` (list of TestInvocationSummaryResponseModel, required)
- `has_more` (boolean, required) — Om det finns fler tillgängliga resultat
- `meta` (ListResponseMeta, optional)
- `next_cursor` (string, optional) — Markör för nästa resultatsida

## Errors

### 422 Invocations List Request Unprocessable Entity Error

Valideringsfel

- `detail` (list of ValidationError, optional)

## Types

### TestInvocationSummaryResponseModel

- `id` (string, required) — ID:t för testkörningen
- `created_at_unix_secs` (integer, required) — Testkörningens skapandetid i Unix-sekunder
- `test_run_count` (integer, required) — Antal testkörningar i den här anropet
- `passed_count` (integer, required) — Antal godkända testkörningar
- `failed_count` (integer, required) — Antal misslyckade testkörningar
- `pending_count` (integer, required) — Antal väntande testkörningar
- `cancelled_count` (integer, required) — Antal avbrutna testkörningar
- `title` (string, required) — Titel för testanropet – mappnamnet för mappkörningar, annars namnet på det enskilda testet eller antalet tester
- `agent_id` (string, optional) — ID:t för agenten som denna testkörning tillhör
- `branch_id` (string, optional) — ID:t för grenen som denna testkörning kördes på
- `version_id` (string, optional) — ID:t för agentversionen som denna testkörning kördes mot. För utkast eller körningar med konfigurationsåsidosättning är detta versionen som de osparade ändringarna tillämpades ovanpå. None gäller endast körningar som registrerades innan detta fält fanns.
- `ran_against_draft` (boolean, optional, default: false) — Om körningen omfattade ocommittade ändringar (ett sparat utkast eller en tillfällig konfigurationsåsidosättning) ovanpå version_id.
- `runs_diverged_from_version` (boolean, optional, default: false) — Om testkörningarna i det här anropet inte alla kördes mot samma version, vilket sker när en delmängd av körningarna skickades in igen efter den ursprungliga körningen. När värdet är true beskriver version_id den senaste återinskickningen i stället för varje körning.
- `access_info` (ResourceAccessInfo, optional) — Åtkomstinformation för testkörningen
- `repeat_count` (integer, optional, default: 1) — Antal gånger varje test upprepades i det här anropet
- `cancelled` (boolean, optional, default: false) — Om denna testkörning avbröts
- `credits_used` (integer, optional) — Totalt antal krediter som debiterats för testkörningar i denna anrop. None när ingen körning har kostnadsdata.
- `total_price` (double, optional) — Totalt pris i USD för testkörningar i detta anrop. None när ingen körning har prisdata.

### ListResponseMeta

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

### ValidationError

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

### ResourceAccessInfo

- `is_creator` (boolean, required) — Om användaren som gör begäran är agentens skapare
- `creator_name` (string, required) — Namn på agentens skapare
- `creator_email` (string, required) — E-postadress till agentens skapare
- `role` (enum, required) — Rollen för användaren som gör begäran
  - Allowed values: `admin`, `editor`, `commenter`, `viewer`
- `anonymous_access_level_override` (enum, optional) — Åtkomstnivån för anonyma användare. Om värdet är None delas resursen inte offentligt.
  - Allowed values: `admin`, `editor`, `commenter`, `viewer`
- `access_source` (enum, optional) — Varför den begärande användaren har åtkomst till den här resursen. 'creator' = anroparen är ägaren. 'explicit' = anroparen (eller en av deras arbetsytas grupper) finns listad i role_to_group_ids utöver den arbetsyteomfattande gruppen för alla. 'workspace_default' = den arbetsyteomfattande gruppen för alla finns listad i role_to_group_ids (alla icke-anonyma medlemmar i arbetsytan, inklusive administratörer, ser den här resursen). 'workspace_admin' = anroparen är administratör för arbetsytan och administratörsplatsen är den *enda* åtkomstvägen; reserverad för dokument som ingen annan kan se. Gör det möjligt för användargränssnittet att förklara varför en administratör som kringgår behörigheter ser ett dokument som inte uttryckligen har delats med dem.
  - Allowed values: `creator`, `explicit`, `workspace_admin`, `workspace_default`

### ValidationErrorLocItem

## Examples

**Response**

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

**SDK Code**

```python
import requests

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

querystring = {"agent_id":"agent_id","branch_id":"branch_id","cursor":"cursor","page_size":"1","search":"search"}

response = requests.get(url, params=querystring)

print(response.json())
```

```javascript
const url = 'https://api.elevenlabs.io/v1/convai/test-invocations?agent_id=agent_id&branch_id=branch_id&cursor=cursor&page_size=1&search=search';
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?agent_id=agent_id&branch_id=branch_id&cursor=cursor&page_size=1&search=search"

	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?agent_id=agent_id&branch_id=branch_id&cursor=cursor&page_size=1&search=search")

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?agent_id=agent_id&branch_id=branch_id&cursor=cursor&page_size=1&search=search")
  .asString();
```

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

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.elevenlabs.io/v1/convai/test-invocations?agent_id=agent_id&branch_id=branch_id&cursor=cursor&page_size=1&search=search');

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

```csharp
using RestSharp;

var client = new RestClient("https://api.elevenlabs.io/v1/convai/test-invocations?agent_id=agent_id&branch_id=branch_id&cursor=cursor&page_size=1&search=search");
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?agent_id=agent_id&branch_id=branch_id&cursor=cursor&page_size=1&search=search")! 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()
```