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

GET https://api.elevenlabs.io/v1/convai/analysis-items

Lista analysobjekt som är tillgängliga i arbetsytan.

Reference: https://elevenlabs.io/docs/eleven-agents/api-reference/conversations/analysis-items/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

- `search` (string, optional) — Om det anges returneras endast analysobjekt vars namn börjar med denna sträng, sorterade efter relevans i stället för sort_direction.
- `page_size` (integer, optional) — Maximalt antal dokument att returnera. Får inte överstiga 100, standardvärdet är 30.
- `kind` (enum, optional) — Om det anges returneras endast analysobjekt av denna typ.
  - Allowed values: `evaluation`, `data_collection`
- `analysis_item_ids` (string, optional) — Om det anges returneras endast analysobjekt med dessa ID:n.
- `created_by_user_id` (string, optional) — Filtrera efter skaparens användar-ID. Använd '@me' för att referera till den autentiserade användaren.
- `sort_direction` (enum, optional) — Riktningen för att sortera resultaten
  - Allowed values: `asc`, `desc`
- `cursor` (string, optional) — Används för att hämta nästa sida. Markören returneras i svaret.

## Response

### 200

Lyckat svar

- `analysis_items` (list of AnalysisItemResponseModel, required)
- `has_more` (boolean, required)
- `next_cursor` (string, optional)

## Errors

### 422 Analysis Items List Request Unprocessable Entity Error

Valideringsfel

- `detail` (list of ValidationError, optional)

## Types

### AnalysisItemResponseModel

- `id` (string, required)
- `definition` (AnalysisItemResponseModelDefinition, required)
- `access_info` (ResourceAccessInfo, required)
- `created_at_unix_secs` (integer, required)
- `updated_at_unix_secs` (integer, required)
- `current_version_id` (string, required)
- `legacy_source_id` (string, optional)

### ValidationError

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

### AnalysisItemResponseModelDefinition

- `kind`: `data_collection`
  - `name` (string, required)
  - `value_schema` (DataCollectionValueSchema, required) — Typ/beskrivning/enum som beskriver värdet som ska extraheras.
  - `llm` (enum, optional) — LLM som ska användas för detta objekt. Om den inte anges används den kopplande agentens standardvärde för analysis_llm.
    - Allowed values: `gpt-4o-mini`, `gpt-4o`, `gpt-4`, `gpt-4-turbo`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-5`, `gpt-5.1`, `gpt-5.2`, `gpt-5.2-chat-latest`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.5`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`, `gpt-6-astra`, `gpt-6-sol`, `gpt-6-luna`, `gpt-6.1-sol`, `gpt-6.1-terra`, `gpt-5-mini`, `gpt-5-nano`, `gpt-3.5-turbo`, `gemini-1.5-pro`, `gemini-1.5-flash`, `gemini-2.0-flash`, `gemini-2.0-flash-lite`, `gemini-2.5-flash-lite`, `gemini-2.5-flash`, `gemini-3-pro-preview`, `gemini-3-flash-preview`, `gemini-3.1-pro-preview`, `gemini-3.1-flash-lite-preview`, `gemini-3.1-flash-lite`, `gemini-3.5-flash`, `gemini-3.5-flash-lite`, `gemini-3.6-flash`, `gemini-3.7-flash`, `gemini-3.8-flash`, `gemini-4-argon`, `claude-sonnet-4-5`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-opus-4-8`, `claude-opus-5`, `claude-opus-5-5`, `claude-sonnet-4-6`, `claude-sonnet-5`, `claude-sonnet-5-5`, `claude-sonnet-4`, `claude-haiku-4-5`, `claude-haiku-5-5`, `claude-3-7-sonnet`, `claude-3-5-sonnet`, `claude-3-5-sonnet-v1`, `claude-3-haiku`, `grok-beta`, `custom-llm`, `qwen3-4b`, `qwen3-30b-a3b`, `qwen36-35b-a3b`, `qwen35-397b-a17b`, `gpt-oss-20b`, `gpt-oss-120b`, `glm-45-air-fp8`, `glm-52`, `deepseek-v41-flash`, `nemotron-35-super-vl-nvfp4`, `gemini-2.5-flash-preview-09-2025`, `gemini-2.5-flash-lite-preview-09-2025`, `gemini-2.5-flash-preview-05-20`, `gemini-2.5-flash-preview-04-17`, `gemini-2.5-flash-lite-preview-06-17`, `gemini-2.0-flash-lite-001`, `gemini-2.0-flash-001`, `gemini-1.5-flash-002`, `gemini-1.5-flash-001`, `gemini-1.5-pro-002`, `gemini-1.5-pro-001`, `claude-sonnet-4@20250514`, `claude-sonnet-4-5@20250929`, `claude-haiku-4-5@20251001`, `claude-3-7-sonnet@20250219`, `claude-3-5-sonnet@20240620`, `claude-3-5-sonnet-v2@20241022`, `claude-3-haiku@20240307`, `gpt-5-2025-08-07`, `gpt-5.1-2025-11-13`, `gpt-5.2-2025-12-11`, `gpt-5.4-2026-03-05`, `gpt-5.4-mini-2026-03-17`, `gpt-5.4-nano-2026-03-17`, `gpt-5.5-2026-04-23`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-0613`, `gpt-4-0314`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`, `gpt-3.5-turbo-1106`, `watt-tool-8b`, `watt-tool-70b`
  - `source` ("user", optional)
- `kind`: `evaluation`
  - `conversation_goal_prompt` (string, required) — Prompten som används för att utvärdera konversationen.
  - `name` (string, required)
  - `llm` (enum, optional) — LLM som ska användas för detta objekt. Om den inte anges används den kopplande agentens standardvärde för analysis_llm.
    - Allowed values: `gpt-4o-mini`, `gpt-4o`, `gpt-4`, `gpt-4-turbo`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-5`, `gpt-5.1`, `gpt-5.2`, `gpt-5.2-chat-latest`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.5`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`, `gpt-6-astra`, `gpt-6-sol`, `gpt-6-luna`, `gpt-6.1-sol`, `gpt-6.1-terra`, `gpt-5-mini`, `gpt-5-nano`, `gpt-3.5-turbo`, `gemini-1.5-pro`, `gemini-1.5-flash`, `gemini-2.0-flash`, `gemini-2.0-flash-lite`, `gemini-2.5-flash-lite`, `gemini-2.5-flash`, `gemini-3-pro-preview`, `gemini-3-flash-preview`, `gemini-3.1-pro-preview`, `gemini-3.1-flash-lite-preview`, `gemini-3.1-flash-lite`, `gemini-3.5-flash`, `gemini-3.5-flash-lite`, `gemini-3.6-flash`, `gemini-3.7-flash`, `gemini-3.8-flash`, `gemini-4-argon`, `claude-sonnet-4-5`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-opus-4-8`, `claude-opus-5`, `claude-opus-5-5`, `claude-sonnet-4-6`, `claude-sonnet-5`, `claude-sonnet-5-5`, `claude-sonnet-4`, `claude-haiku-4-5`, `claude-haiku-5-5`, `claude-3-7-sonnet`, `claude-3-5-sonnet`, `claude-3-5-sonnet-v1`, `claude-3-haiku`, `grok-beta`, `custom-llm`, `qwen3-4b`, `qwen3-30b-a3b`, `qwen36-35b-a3b`, `qwen35-397b-a17b`, `gpt-oss-20b`, `gpt-oss-120b`, `glm-45-air-fp8`, `glm-52`, `deepseek-v41-flash`, `nemotron-35-super-vl-nvfp4`, `gemini-2.5-flash-preview-09-2025`, `gemini-2.5-flash-lite-preview-09-2025`, `gemini-2.5-flash-preview-05-20`, `gemini-2.5-flash-preview-04-17`, `gemini-2.5-flash-lite-preview-06-17`, `gemini-2.0-flash-lite-001`, `gemini-2.0-flash-001`, `gemini-1.5-flash-002`, `gemini-1.5-flash-001`, `gemini-1.5-pro-002`, `gemini-1.5-pro-001`, `claude-sonnet-4@20250514`, `claude-sonnet-4-5@20250929`, `claude-haiku-4-5@20251001`, `claude-3-7-sonnet@20250219`, `claude-3-5-sonnet@20240620`, `claude-3-5-sonnet-v2@20241022`, `claude-3-haiku@20240307`, `gpt-5-2025-08-07`, `gpt-5.1-2025-11-13`, `gpt-5.2-2025-12-11`, `gpt-5.4-2026-03-05`, `gpt-5.4-mini-2026-03-17`, `gpt-5.4-nano-2026-03-17`, `gpt-5.5-2026-04-23`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-0613`, `gpt-4-0314`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`, `gpt-3.5-turbo-1106`, `watt-tool-8b`, `watt-tool-70b`
  - `scoring` (UserEvaluationAnalysisItemScoring, optional) — Hur detta kriterium poängsätts (binary eller numeric_uniform).
  - `source` ("user", optional)
  - `use_knowledge_base` (boolean, optional, default: false) — Om den kopplande agentens kunskapsbas används vid utvärdering av detta kriterium.

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

- string
- integer

### DataCollectionValueSchema

Schemaegenskap för bokstavliga JSON-typer. VIKTIGT: Endast ETT av följande fält kan anges: description (LLM anger värdet), dynamic_variable (värde från variabel), is_system_provided (systemet anger värdet), constant_value (fast värde) eller is_omitted (parametern utelämnas). Dessa utesluter varandra.

- `type` (DataCollectionValueSchemaType, required)
- `description` (string, optional, default: ) — Beskrivningen av egenskapen. När den är angiven tillhandahåller LLM:en värdet baserat på denna beskrivning. Kan inte användas tillsammans med dynamic_variable, is_system_provided, constant_value och is_omitted.
- `enum` (list of string, optional) — List of allowed string values for string type parameters
- `is_system_provided` (boolean, optional, default: false) — Om värdet är true fylls värdet i av systemet vid körning. Används av API Integration Webhook-verktyg för mallar. Kan inte användas tillsammans med description, dynamic_variable, constant_value och is_omitted.
- `dynamic_variable` (string, optional, default: ) — Namnet på den dynamiska variabel som ska användas för den här egenskapens värde. Kan inte användas tillsammans med description, is_system_provided, constant_value och is_omitted.
- `allowed_values` (AllowedValues, optional) — Avvisningsskydd på serversidan för ett värde från en LLM: körtiden avvisar alla värden utanför den tillåtna uppsättning som objektet anger, och uppsättningen visas inte för LLM:en som en enum. Stöds endast när värdekällan är `description`; det går inte att kombinera med dynamic_variable, is_system_provided, constant_value eller is_omitted.
- `constant_value` (DataCollectionValueSchemaConstantValue, optional) — Ett konstant värde att använda för den här egenskapen. Kan inte användas tillsammans med description, dynamic_variable, is_system_provided och is_omitted.
- `is_omitted` (boolean, optional, default: false) — Om värdet är true utelämnas denna parameter helt från förfrågningen. Gäller endast valfria parametrar. Kan inte användas tillsammans med description, dynamic_variable, is_system_provided och constant_value.
- `allowed_values_dynamic_variable` (string, optional, default: , deprecated) — FÖRÅLDRAT: använd `allowed_values` i stället. När det är inställt tillhandahåller LLM:n värdet, men körningsmiljön avvisar alla värden som inte finns i listan som den här dynamiska variabeln innehåller (måste vara en JSON-array som ["ws_alpha", "ws_beta"]). Använd detta för att låta LLM:n välja från en serververifierad uppsättning (t.ex. de ID:n som den aktuella användaren har behörighet till). Kräver description; kan inte användas tillsammans med dynamic_variable, is_system_provided, constant_value och is_omitted.

### UserEvaluationAnalysisItemScoring

Hur detta kriterium poängsätts (binary eller numeric_uniform).

- `mode`: `binary`
- `mode`: `numeric_uniform`
  - `max_score` (integer, required)
  - `instructions` (string, optional)

### DataCollectionValueSchemaType

- "boolean"
- "string"
- "integer"
- "number"
- list of string

### AllowedValues

- `dynamic_variable` (string, required) — Namn på en dynamisk variabel som måste lösas till en JSON-array med tillåtna värden, t.ex. ["ws_alpha", "ws_beta"]. Systemvariabler fungerar endast om de löses till en lista.

### DataCollectionValueSchemaConstantValue

Ett konstant värde att använda för den här egenskapen. Kan inte användas tillsammans med description, dynamic_variable, is_system_provided och is_omitted.

- string
- integer
- double
- boolean

## Examples

**Response**

```json
{
  "analysis_items": [
    {
      "id": "id",
      "definition": {
        "kind": "data_collection",
        "name": "name",
        "value_schema": {
          "type": "string",
          "description": "A user-provided message"
        }
      },
      "access_info": {
        "is_creator": true,
        "creator_name": "John Doe",
        "creator_email": "john.doe@example.com",
        "role": "admin",
        "access_source": "creator"
      },
      "created_at_unix_secs": 1,
      "updated_at_unix_secs": 1,
      "current_version_id": "current_version_id",
      "legacy_source_id": "legacy_source_id"
    }
  ],
  "has_more": true,
  "next_cursor": "next_cursor"
}
```

**SDK Code**

```python
import requests

url = "https://api.elevenlabs.io/v1/convai/analysis-items"

querystring = {"analysis_item_ids":"[\"analysis_item_ids\"]","created_by_user_id":"created_by_user_id","cursor":"cursor","kind":"evaluation","page_size":"1","search":"search","sort_direction":"asc"}

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

print(response.json())
```

```javascript
const url = 'https://api.elevenlabs.io/v1/convai/analysis-items?analysis_item_ids=%5B%22analysis_item_ids%22%5D&created_by_user_id=created_by_user_id&cursor=cursor&kind=evaluation&page_size=1&search=search&sort_direction=asc';
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/analysis-items?analysis_item_ids=%5B%22analysis_item_ids%22%5D&created_by_user_id=created_by_user_id&cursor=cursor&kind=evaluation&page_size=1&search=search&sort_direction=asc"

	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/analysis-items?analysis_item_ids=%5B%22analysis_item_ids%22%5D&created_by_user_id=created_by_user_id&cursor=cursor&kind=evaluation&page_size=1&search=search&sort_direction=asc")

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/analysis-items?analysis_item_ids=%5B%22analysis_item_ids%22%5D&created_by_user_id=created_by_user_id&cursor=cursor&kind=evaluation&page_size=1&search=search&sort_direction=asc")
  .asString();
```

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

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.elevenlabs.io/v1/convai/analysis-items?analysis_item_ids=%5B%22analysis_item_ids%22%5D&created_by_user_id=created_by_user_id&cursor=cursor&kind=evaluation&page_size=1&search=search&sort_direction=asc');

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

```csharp
using RestSharp;

var client = new RestClient("https://api.elevenlabs.io/v1/convai/analysis-items?analysis_item_ids=%5B%22analysis_item_ids%22%5D&created_by_user_id=created_by_user_id&cursor=cursor&kind=evaluation&page_size=1&search=search&sort_direction=asc");
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/analysis-items?analysis_item_ids=%5B%22analysis_item_ids%22%5D&created_by_user_id=created_by_user_id&cursor=cursor&kind=evaluation&page_size=1&search=search&sort_direction=asc")! 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()
```