API Open WebUI e MCP

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/auths/

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

503 · Servizio temporaneamente non disponibile

`application/json`

POST/api/v1/auths/update/timezoneUpdate Timezone

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/auths/update/timezone

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Corpo della richiesta · obbligatorio

`application/json`

UpdateTimezoneForm

Risposte

200 · Operazione completata

`application/json`

object

Campo	Obbligatorio	Struttura e vincoli
`status`	Sì	`boolean`

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/auths/signout

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Risposte

200 · Operazione completata

`application/json`

object

Campo	Obbligatorio	Struttura e vincoli
`status`	Sì	`boolean` const `true`
`redirect_url`	Sì	`string`

GET/api/v1/users/user/settingsGet User Settings By Session User

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/users/user/settings

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

raw · query · facoltativo

boolean

default: false

Risposte

200 · Successful Response

`application/json`

Almeno uno tra

Variante 1

UserSettings

Variante 2

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/users/user/settings/update

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Corpo della richiesta · obbligatorio

`application/json`

UserSettings

GET/api/v1/users/{user_id}/infoGet User Info By Id

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti. user_id deve coincidere con l’identità Netter corrente (tenant UUID:user UUID).

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/users/{user_id}/info

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

user_id · path · obbligatorio

string

GET/api/v1/users/{user_id}/oauth/sessionsGet User Oauth Sessions By Id

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti. Richiede anche ruolo admin upstream, non assegnato dal boundary: normalmente restituisce 403. user_id deve coincidere con l’identità Netter corrente (tenant UUID:user UUID).

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/users/{user_id}/oauth/sessions

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

user_id · path · obbligatorio

string

Risposte

200 · Operazione completata

`application/json`

array

Elementi dell’array

object

Campo	Obbligatorio	Struttura e vincoli
`id`	No	`string`
`provider`	No	`string`
`expires_at`	No	Almeno uno tra Variante 1 `integer` Unix timestamp in secondi. Variante 2 `null`

200 · Operazione completata

`image/*`

string

format: "binary"

302 · Redirect all’immagine del profilo

Location

200 · Operazione completata

`application/json`

object

Campo	Obbligatorio	Struttura e vincoli
`active`	Sì	`boolean`

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/users/{user_id}/sessions/revoke

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

user_id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

POST/api/v1/users/{user_id}/updateUpdate User By Id

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti. Richiede anche ruolo admin upstream, non assegnato dal boundary: normalmente restituisce 403. user_id deve coincidere con l’identità Netter corrente (tenant UUID:user UUID).

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/users/{user_id}/update

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

user_id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Corpo della richiesta · obbligatorio

`application/json`

UserUpdateForm

Risposte

200 · Successful Response

`application/json`

Almeno uno tra

Variante 1

UserModel

Variante 2

boolean

default: false

Risposte

200 · Operazione completata

`application/json`

array

Elementi dell’array

Show what resources a specific user can access across all their groups. user_id deve coincidere con l’identità Netter corrente (tenant UUID:user UUID).

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/users/{user_id}/preview

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

user_id · path · obbligatorio

string

Risposte

200 · Operazione completata

`application/json`

object

Campo Obbligatorio Struttura e vincoli

user

Sì

object

Campo	Obbligatorio	Struttura e vincoli
`id`	Sì	`string`
`name`	Sì	`string`

groups

Sì

array

Elementi dell’array

object

Campo	Obbligatorio	Struttura e vincoli
`id`	Sì	`string`
`name`	Sì	`string`

models

Sì

object

Campo Obbligatorio Struttura e vincoli

items

Sì

array

Elementi dell’array

object

Campo	Obbligatorio	Struttura e vincoli
`id`	Sì	`string`
`name`	Sì	`string`

total

Sì

integer

knowledge

Sì

object

Campo Obbligatorio Struttura e vincoli

items

Sì

array

Elementi dell’array

object

Campo	Obbligatorio	Struttura e vincoli
`id`	Sì	`string`
`name`	Sì	`string`

total

Sì

integer

tools

Sì

object

Campo Obbligatorio Struttura e vincoli

items

Sì

array

Elementi dell’array

object

Campo	Obbligatorio	Struttura e vincoli
`id`	Sì	`string`
`name`	Sì	`string`

total

Sì

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/list

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

page · query · facoltativo

Almeno uno tra

Variante 1

integer

Variante 2

null

include_pinned · query · facoltativo

default: false

Almeno uno tra

Variante 1

boolean

Variante 2

null

include_folders · query · facoltativo

default: false

Almeno uno tra

Variante 1

boolean

Variante 2

null

sort_by · query · facoltativo

string

default: "updated_at"

sort_dir · query · facoltativo

string

default: "desc"

Risposte

200 · Successful Response

`application/json`

array

Elementi dell’array

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

page · query · facoltativo

Almeno uno tra

Variante 1

integer

Variante 2

null

include_pinned · query · facoltativo

default: false

Almeno uno tra

Variante 1

boolean

Variante 2

null

include_folders · query · facoltativo

default: false

Almeno uno tra

Variante 1

boolean

Variante 2

null

sort_by · query · facoltativo

string

default: "updated_at"

sort_dir · query · facoltativo

string

default: "desc"

Risposte

200 · Successful Response

`application/json`

array

Elementi dell’array

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

503 · Servizio temporaneamente non disponibile

`application/json`

POST/api/v1/chats/readMark Chats Read By User Id

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/read

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Risposte

200 · Operazione completata

`application/json`

object

Campo	Obbligatorio	Struttura e vincoli
`updated_count`	Sì	`integer`
`folder_unread_counts`	Sì	`object` Valori dei campi aggiuntivi `integer`

GET/api/v1/chats/stats/usageGet Session User Chat Usage Stats

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/stats/usage

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

items_per_page · query · facoltativo

default: 50

Almeno uno tra

Variante 1

integer

Variante 2

null

page · query · facoltativo

default: 1

Almeno uno tra

Variante 1

integer

Variante 2

null

POST/api/v1/chats/newCreate New Chat

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/new

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Corpo della richiesta · obbligatorio

`application/json`

ChatForm

Risposte

200 · Successful Response

`application/json`

Almeno uno tra

Variante 1

Variante 2

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/config

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

503 · Servizio temporaneamente non disponibile

`application/json`

POST/api/v1/chats/configSet Chat Config

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/config

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Corpo della richiesta · obbligatorio

`application/json`

ChatConfigForm

GET/api/v1/chats/searchSearch User Chats

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/search

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

text · query · obbligatorio

string

page · query · facoltativo

Almeno uno tra

Variante 1

integer

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/folder/{folder_id}/list

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

folder_id · path · obbligatorio

string

page · query · facoltativo

default: 1

Almeno uno tra

Variante 1

integer

Variante 2

null

sort_by · query · facoltativo

string

default: "unread_updated_at"

sort_dir · query · facoltativo

string

default: "desc"

Risposte

200 · Successful Response

`application/json`

array

Elementi dell’array

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

`application/json`

409 · Revisione o generazione già inviata

`application/json`

429 · Limite richieste raggiunto

`application/json`

503 · Servizio temporaneamente non disponibile

`application/json`

GET/api/v1/chats/allGet User Chats

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/all

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Risposte

200 · Operazione completata

`application/x-ndjson`

string

GET/api/v1/chats/all/archivedGet User Archived Chats

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

`application/json`

409 · Revisione o generazione già inviata

`application/json`

429 · Limite richieste raggiunto

`application/json`

503 · Servizio temporaneamente non disponibile

`application/json`

GET/api/v1/chats/all/tagsGet All User Tags

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

`application/json`

409 · Revisione o generazione già inviata

`application/json`

429 · Limite richieste raggiunto

`application/json`

503 · Servizio temporaneamente non disponibile

`application/json`

GET/api/v1/chats/archivedGet Archived Session User Chat List

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/archived

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

page · query · facoltativo

Almeno uno tra

Variante 1

integer

Variante 2

null

query · query · facoltativo

Almeno uno tra

Variante 1

string

Variante 2

null

order_by · query · facoltativo

Almeno uno tra

Variante 1

string

Variante 2

null

direction · query · facoltativo

Almeno uno tra

Variante 1

string

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

503 · Servizio temporaneamente non disponibile

`application/json`

POST/api/v1/chats/archive/allArchive All Chats

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/archive/all

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

503 · Servizio temporaneamente non disponibile

`application/json`

POST/api/v1/chats/unarchive/allUnarchive All Chats

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/unarchive/all

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

503 · Servizio temporaneamente non disponibile

`application/json`

POST/api/v1/chats/tagsGet User Chat List By Tag Name

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/tags

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

POST/api/v1/chats/{id}/compactCompact Chat By Id

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/{id}/compact

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Corpo della richiesta · facoltativo

`application/json`

Almeno uno tra

Variante 1

CompactChatForm

Variante 2

null

Risposte

200 · Operazione completata

`application/json`

object

Campo	Obbligatorio	Struttura e vincoli
`ok`	Sì	`boolean`
`compacted`	Sì	`boolean`
`reason`	No	`string`
`summary`	No	`string`
`dropped_messages`	No	`integer`
`context_usage`	No	Almeno uno tra Variante 1 JSONValue Variante 2 `null`

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/{id}

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

Risposte

200 · Successful Response

`application/json`

Almeno uno tra

Variante 1

Variante 2

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/{id}

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Corpo della richiesta · obbligatorio

`application/json`

ChatForm

Risposte

200 · Successful Response

`application/json`

Almeno uno tra

Variante 1

Variante 2

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/{id}

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

POST/api/v1/chats/{id}/messages/{message_id}Update Chat Message By Id

open_webui__routers__chats__MessageForm

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/{id}/messages/{message_id}

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

message_id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Corpo della richiesta · obbligatorio

`application/json`

Risposte

200 · Successful Response

`application/json`

Almeno uno tra

Variante 1

Variante 2

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/{id}/messages/{message_id}

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

message_id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Risposte

200 · Successful Response

`application/json`

Almeno uno tra

Variante 1

Variante 2

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/{id}/messages/{message_id}/event

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

message_id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Corpo della richiesta · obbligatorio

`application/json`

EventForm

Risposte

200 · Successful Response

`application/json`

Almeno uno tra

Variante 1

boolean

Variante 2

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/{id}/pinned

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

Risposte

200 · Successful Response

`application/json`

Almeno uno tra

Variante 1

boolean

Variante 2

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/{id}/pin

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Risposte

200 · Successful Response

`application/json`

Almeno uno tra

Variante 1

Variante 2

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/{id}/fork

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Corpo della richiesta · facoltativo

`application/json`

Almeno uno tra

Variante 1

ForkForm

Variante 2

null

Risposte

200 · Successful Response

`application/json`

Almeno uno tra

Variante 1

Variante 2

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/{id}/archive

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Risposte

200 · Successful Response

`application/json`

Almeno uno tra

Variante 1

Variante 2

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/{id}/unread

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Risposte

200 · Operazione completata

`application/json`

object

Campo	Obbligatorio	Struttura e vincoli
`chat_id`	Sì	`string`
`last_read_at`	Sì	Almeno uno tra Variante 1 `integer` Unix timestamp in secondi. Variante 2 `null`
`folder_id`	Sì	Almeno uno tra Variante 1 `string` Variante 2 `null`
`folder_unread_counts`	Sì	`object` Valori dei campi aggiuntivi `integer`

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/{id}/folder

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Corpo della richiesta · obbligatorio

`application/json`

ChatFolderIdForm

Risposte

200 · Successful Response

`application/json`

Almeno uno tra

Variante 1

Variante 2

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/{id}/tags

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/{id}/tags

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Corpo della richiesta · obbligatorio

`application/json`

TagForm

Risposte

200 · Successful Response

`application/json`

array

Elementi dell’array

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/{id}/tags

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Corpo della richiesta · obbligatorio

`application/json`

TagForm

Risposte

200 · Successful Response

`application/json`

array

Elementi dell’array

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/models/model/profile/image

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · query · obbligatorio

string

Risposte

200 · Operazione completata

`image/*`

string

format: "binary"

302 · Redirect all’immagine del profilo

Location

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

`application/json`

409 · Revisione o generazione già inviata

`application/json`

GET/api/v1/folders/{id}Get Folder By Id

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/folders/{id}

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

DELETE/api/v1/folders/{id}Delete Folder By Id

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/folders/{id}

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

delete_contents · query · facoltativo

default: true

Almeno uno tra

Variante 1

boolean

Variante 2

null

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

POST/api/v1/folders/{id}/updateUpdate Folder Name By Id

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/folders/{id}/update

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Corpo della richiesta · obbligatorio

`application/json`

FolderUpdateForm

POST/api/v1/folders/{id}/update/parentUpdate Folder Parent Id By Id

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/folders/{id}/update/parent

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Corpo della richiesta · obbligatorio

`application/json`

FolderParentIdForm

POST/api/v1/folders/{id}/update/expandedUpdate Folder Is Expanded By Id

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/folders/{id}/update/expanded

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Corpo della richiesta · obbligatorio

`application/json`

FolderIsExpandedForm

POST/api/v1/folders/{id}/access/updateUpdate Folder Access By Id

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/folders/{id}/access/update

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Corpo della richiesta · obbligatorio

`application/json`

FolderAccessGrantsForm

POST/api/v1/folders/{id}/readMark Folder Chats Read By Id

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/folders/{id}/read

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Risposte

200 · Operazione completata

`application/json`

object

Campo	Obbligatorio	Struttura e vincoli
`folder_id`	Sì	`string`
`folder_ids`	Sì	`array` Elementi dell’array `string`
`updated_count`	Sì	`integer`
`folder_unread_counts`	Sì	`object` Valori dei campi aggiuntivi `integer`

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/files/

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Corpo della richiesta · obbligatorio

`multipart/form-data`

object

Campo	Obbligatorio	Struttura e vincoli
`file`	Sì	`string` Massimo 20 MiB; memorizzazione cifrata Netter. format `"binary"`

GET/api/v1/files/List Files

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/files/

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

page · query · facoltativo

Page number (1-indexed)

integer

Page number (1-indexed)

minimum: 1
default: 1

content · query · facoltativo

boolean

default: true

GET/api/v1/files/searchSearch Files

Search for files by filename with support for wildcard patterns. Uses SQL-based filtering with pagination for better performance.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/files/search

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

filename · query · obbligatorio

Filename pattern to search for. Supports wildcards such as '*.txt'

string

Filename pattern to search for. Supports wildcards such as '*.txt'

content · query · facoltativo

boolean

default: true

skip · query · facoltativo

Number of files to skip

integer

Number of files to skip

minimum: 0
default: 0

limit · query · facoltativo

Maximum number of files to return

integer

Maximum number of files to return

maximum: 1000
minimum: 1
default: 100

Risposte

200 · Successful Response

`application/json`

array

Elementi dell’array

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/files/count

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

503 · Servizio temporaneamente non disponibile

`application/json`

GET/api/v1/files/{id}Get File By Id

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/files/{id}

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

Risposte

200 · Successful Response

`application/json`

Almeno uno tra

Variante 1

FileModel

Variante 2

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/files/{id}

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Risposte

200 · Operazione completata

`application/json`

object

Campo	Obbligatorio	Struttura e vincoli
`message`	Sì	`string`

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/files/{id}/process/status

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

stream · query · facoltativo

boolean

default: false

Risposte

200 · Operazione completata

`application/json`

object

Campo	Obbligatorio	Struttura e vincoli
`status`	Sì	`string`

`text/event-stream`

string

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/files/{id}/data/content

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

Risposte

200 · Operazione completata

`application/json`

object

Campo	Obbligatorio	Struttura e vincoli
`content`	Sì	`string`

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/files/{id}/content

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

attachment · query · facoltativo

boolean

default: false

Risposte

200 · Operazione completata

`application/octet-stream`

string

format: "binary"

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/files/{id}/content/html

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

Risposte

200 · Operazione completata

`application/octet-stream`

string

format: "binary"

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/files/{id}/content/{file_name}

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

file_name · path · obbligatorio

string

Risposte

200 · Operazione completata

`application/octet-stream`

string

format: "binary"

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/files/{id}/rename

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Corpo della richiesta · obbligatorio

`application/json`

FileRenameForm

GET/api/v1/modelsGet Models

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/models

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

refresh · query · facoltativo

boolean

default: false

GET/api/modelsGet Models

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/models

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

refresh · query · facoltativo

boolean

default: false

GET/api/models/baseGet Base Models

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/models/base

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

503 · Servizio temporaneamente non disponibile

`application/json`

POST/api/v1/chat/completionsChat Completion

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chat/completions

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Corpo della richiesta · obbligatorio

`application/json`

NativeChatRequest

Risposte

200 · Operazione completata

`application/json`

Almeno uno tra

Variante 1

GatewayChatResponse

Variante 2

object

Campo	Obbligatorio	Struttura e vincoli
`status`	Sì	`boolean`
`chat_id`	Sì	Almeno uno tra Variante 1 `string` Variante 2 `null`
`paused`	No	`boolean`

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/chat/completions

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Corpo della richiesta · obbligatorio

`application/json`

NativeChatRequest

Risposte

200 · Operazione completata

`application/json`

Almeno uno tra

Variante 1

GatewayChatResponse

Variante 2

object

Campo	Obbligatorio	Struttura e vincoli
`status`	Sì	`boolean`
`chat_id`	Sì	Almeno uno tra Variante 1 `string` Variante 2 `null`
`paused`	No	`boolean`

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/chats/{id}/messages/{message_id}/resolve

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

id · path · obbligatorio

string

message_id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Corpo della richiesta · obbligatorio

`application/json`

ResolveToolCallForm

Risposte

200 · Operazione completata

`application/json`

object

Campo	Obbligatorio	Struttura e vincoli
`status`	Sì	`boolean`
`chat_id`	Sì	`string`
`message_id`	Sì	`string`
`task_ids`	No	`array` Elementi dell’array `string`

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/tasks/stop/{task_id}

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

task_id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Risposte

200 · Operazione completata

`application/json`

object

Campo	Obbligatorio	Struttura e vincoli
`status`	No	`boolean`

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/tasks

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Risposte

200 · Operazione completata

`application/json`

object

Campo	Obbligatorio	Struttura e vincoli
`tasks`	Sì	`array` Elementi dell’array `string`

GET/api/tasks/chat/{chat_id}List Tasks By Chat Id Endpoint

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/tasks/chat/{chat_id}

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

chat_id · path · obbligatorio

string

Risposte

200 · Operazione completata

`application/json`

object

Campo	Obbligatorio	Struttura e vincoli
`task_ids`	No	`array` Elementi dell’array `string`

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/tasks/chat/{chat_id}/stop

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

chat_id · path · obbligatorio

string

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Risposte

200 · Operazione completata

`application/json`

object

Campo	Obbligatorio	Struttura e vincoli
`status`	No	`boolean`

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/config

Sicurezza:[] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Risposte

200 · Operazione completata

`application/json`

object

Campo Obbligatorio Struttura e vincoli

status

boolean

name

string

version

string

default_locale

string

features

object

Valori dei campi aggiuntivi

boolean

oauth

object

Campo	Obbligatorio	Struttura e vincoli
`providers`	No	`object` Valori dei campi aggiuntivi `string`
`auto_redirect`	No	Almeno uno tra Variante 1 `boolean` Variante 2 `null`

i18n

object

Valori dei campi aggiuntivi

GET/api/versionGet App Version

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/version

Sicurezza:[] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Risposte

200 · Operazione completata

`application/json`

object

Campo	Obbligatorio	Struttura e vincoli
`version`	Sì	`string`
`deployment_id`	Sì	`string`

GET/healthget health

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/health

Sicurezza:[] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Risposte

200 · Operazione completata

`application/json`

object

Campo	Obbligatorio	Struttura e vincoli
`status`	Sì	`string` const `"ok"`
`service`	Sì	`string` const `"openwebui"`
`version`	Sì	`string` const `"0.12.3"`

GET/health/dbget health db

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/health/db

Sicurezza:[] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Risposte

200 · Operazione completata

`application/json`

object

Campo	Obbligatorio	Struttura e vincoli
`status`	Sì	`boolean`

GET/readyget ready

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/ready

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Risposte

200 · Operazione completata

`application/json`

object

Campo	Obbligatorio	Struttura e vincoli
`status`	Sì	`boolean`

GET/api/v1/skillsget api v1 skills

Funzione disabilitata nell’integrazione Netter: restituisce sempre [].

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/skills

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Risposte

200 · Operazione completata

`application/json`

array

maxItems: 0

Elementi dell’array

GET/api/v1/promptsget api v1 prompts

Funzione disabilitata nell’integrazione Netter: restituisce sempre [].

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/prompts

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Risposte

200 · Operazione completata

`application/json`

array

maxItems: 0

Elementi dell’array

GET/api/v1/knowledgeget api v1 knowledge

Funzione disabilitata nell’integrazione Netter: restituisce sempre [].

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/knowledge

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Risposte

200 · Operazione completata

`application/json`

array

maxItems: 0

Elementi dell’array

GET/api/v1/groups/userget api v1 groups user

Funzione disabilitata nell’integrazione Netter: restituisce sempre [].

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/groups/user

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Risposte

200 · Operazione completata

`application/json`

array

maxItems: 0

Elementi dell’array

GET/api/v1/toolsget api v1 tools

Funzione disabilitata nell’integrazione Netter: restituisce sempre [].

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/tools

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Risposte

200 · Operazione completata

`application/json`

array

maxItems: 0

Elementi dell’array

GET/api/v1/functionsget api v1 functions

Funzione disabilitata nell’integrazione Netter: restituisce sempre [].

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/functions

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Risposte

200 · Operazione completata

`application/json`

array

maxItems: 0

Elementi dell’array

GET/api/v1/notes/pinnedget api v1 notes pinned

Funzione disabilitata nell’integrazione Netter: restituisce sempre [].

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/notes/pinned

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Risposte

200 · Operazione completata

`application/json`

array

maxItems: 0

Elementi dell’array

GET/api/v1/channelsget api v1 channels

Funzione disabilitata nell’integrazione Netter: restituisce sempre [].

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/channels

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Risposte

200 · Operazione completata

`application/json`

array

maxItems: 0

Elementi dell’array

GET/api/v1/terminalsget api v1 terminals

Funzione disabilitata nell’integrazione Netter: restituisce sempre [].

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/terminals

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Risposte

200 · Operazione completata

`application/json`

array

maxItems: 0

Elementi dell’array

GET/api/v1/folders/sharedget api v1 folders shared

Funzione disabilitata nell’integrazione Netter: restituisce sempre [].

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/folders/shared

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Risposte

200 · Operazione completata

`application/json`

array

maxItems: 0

Elementi dell’array

GET/api/v1/configs/bannersget api v1 configs banners

API nativa Open WebUI 0.12.3 entro il boundary Netter. Tenant, utente, plafond, scadenza e scope del token sono verificati sul server; la presenza nel contratto non sostituisce i permessi richiesti.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/api/v1/configs/banners

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Risposte

200 · Operazione completata

`application/json`

array

Elementi dell’array

object

Campo	Obbligatorio	Struttura e vincoli
`id`	Sì	`string` const `"netter-context"`
`type`	Sì	`string` const `"info"`
`title`	Sì	`null`
`content`	Sì	`string`
`dismissible`	Sì	`boolean` const `true`
`timestamp`	Sì	`integer` const `0`

POST/netter/bootstrappost netter bootstrap

Scambia il ticket monouso di /api/v1/openwebui/access. Origin deve essere esattamente il portale Netter; crea un cookie HttpOnly Secure e inizializza l’accesso nel browser. Mai inserire ticket/token in URL.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/netter/bootstrap

Sicurezza:[] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

Origin · header · obbligatorio

string

const: "https://admin.llm.netter.io"

Corpo della richiesta · obbligatorio

`application/x-www-form-urlencoded`

object

Campo	Obbligatorio	Struttura e vincoli
`ticket`	Sì	`string`

503 · Servizio temporaneamente non disponibile

`application/json`

POST/mcppost mcp

MCP stateless su HTTP. Conflitti, errori di input, permessi strumento ed esiti incerti sono tools/call result.isError=true (HTTP 200); autenticazione del boundary usa HTTP 401/403. Non ritentare generazioni incerte con un nuovo operation_id.

URL: https://00000000-0000-0000-0000-000000000001.chat.llm.netter.io/mcp

Sicurezza:[{"device":[]},{"chatSession":[]}] · Un array vuoto indica assenza di sessione/chiave API; consulta i controlli specifici dell’operazione.

Parametri

Origin · header · facoltativo

Se presente deve essere https://admin.llm.netter.io oppure l’origine HTTPS del workspace. Può essere omesso dai client dispositivo/MCP.

string

Corpo della richiesta · obbligatorio

`application/json`

MCPRequest

`chat_list`

Elenca le tue conversazioni nel workspace corrente.

Argomenti dello strumento

object

Campo	Obbligatorio	Struttura e vincoli
`offset`	No	`integer` minimum `0`

I campi aggiuntivi sono rifiutati.

Risultato decodificato in content[].text

MCPChatList

`chat_search`

Cerca nelle tue conversazioni autorizzate.

Argomenti dello strumento

object

Campo	Obbligatorio	Struttura e vincoli
`query`	Sì	`string`
`offset`	No	`integer` minimum `0`

I campi aggiuntivi sono rifiutati.

Risultato decodificato in content[].text

MCPChatList

`chat_get`

Legge una conversazione e la sua revisione corrente.

Argomenti dello strumento

object

Campo	Obbligatorio	Struttura e vincoli
`chat_id`	Sì	`string`

I campi aggiuntivi sono rifiutati.

Risultato decodificato in content[].text

MCPChat

`chat_create`

Crea una conversazione Open WebUI.

Argomenti dello strumento

object

Campo	Obbligatorio	Struttura e vincoli
`title`	No	`string`
`model`	No	`string`
`operation_id`	Sì	`string` format `"uuid"`

I campi aggiuntivi sono rifiutati.

Risultato decodificato in content[].text

MCPChat

`chat_append`

Aggiunge un messaggio alla revisione indicata. Non esegue inferenza.

Argomenti dello strumento

object

Campo	Obbligatorio	Struttura e vincoli
`chat_id`	Sì	`string`
`expected_revision`	Sì	`integer` minimum `0`
`operation_id`	Sì	`string` format `"uuid"`
`content`	Sì	`string`
`role`	No	enum `["user","assistant"]`

I campi aggiuntivi sono rifiutati.

Risultato decodificato in content[].text

MCPChat

`chat_continue`

Invia un messaggio al modello, usa il plafond Netter e salva la risposta nella conversazione.

Argomenti dello strumento

object

Campo	Obbligatorio	Struttura e vincoli
`chat_id`	Sì	`string`
`expected_revision`	Sì	`integer` minimum `0`
`operation_id`	Sì	`string` format `"uuid"`
`content`	Sì	`string`
`model`	No	`string`

I campi aggiuntivi sono rifiutati.

Risultato decodificato in content[].text

MCPContinueResult

Risposte

200 · Operazione completata

`application/json`

Almeno uno tra

Variante 1

MCPResult

Variante 2

MCPMethodError

202 · Notifica senza id: nessun corpo

401 · Accesso Netter richiesto

`application/json`

403 · Scope, Origin o funzione non consentiti

`application/json`

404 · Risorsa assente o non visibile

`application/json`

405 · Metodo HTTP non consentito; Allow: POST

409 · Revisione o generazione già inviata

`application/json`

429 · Limite richieste raggiunto

`application/json`

503 · Servizio temporaneamente non disponibile

`application/json`

Strutture dati

Facoltativo e nullable sono distinti. Importi ed estensioni dei provider seguono i tipi e i vincoli indicati.

BoundaryError

object

Campo	Obbligatorio	Struttura e vincoli
`detail`	Sì	Almeno uno tra Variante 1 `string` Variante 2 `array` Elementi dell’array JSONValue

ChatChunk

object

Campo Obbligatorio Struttura e vincoli

id

Sì

string

object

Sì

string

const: "chat.completion.chunk"

created

integer

model

choices

Sì

array

Elementi dell’array

object

Campo Obbligatorio Struttura e vincoli

index

Sì

integer

delta

Sì

object

Campo Obbligatorio Struttura e vincoli

role

string

content

Almeno uno tra

Variante 1

string

Variante 2

null

tool_calls

array

Elementi dell’array

object

Campo Obbligatorio Struttura e vincoli

index

Sì

integer

id

string

type

string

function

object

Campo	Obbligatorio	Struttura e vincoli
`name`	No	`string`
`arguments`	No	`string`

Sono ammessi campi aggiuntivi.

finish_reason

Almeno uno tra

Variante 1

string

Variante 2

null

usage

Almeno uno tra

Variante 1

Usage

Variante 2

null

Sono ammessi campi aggiuntivi.

ChatConfigForm

object

Campo	Obbligatorio	Struttura e vincoli
`CONTEXT_COMPACTION_MODEL`	No	default `""` Almeno uno tra Variante 1 `string` Variante 2 `null`
`ENABLE_CONTEXT_COMPACTION`	Sì	`boolean`
`CONTEXT_COMPACTION_TOKEN_THRESHOLD`	No	Almeno uno tra Variante 1 `integer` Variante 2 `null`
`CONTEXT_COMPACTION_TOKEN_CAP`	No	Almeno uno tra Variante 1 `integer` Variante 2 `null`
`CONTEXT_COMPACTION_RETENTION_PERCENTAGE`	No	Almeno uno tra Variante 1 `integer` Variante 2 `null`
`CONTEXT_COMPACTION_PROMPT_TEMPLATE`	Sì	`string`
`ENABLE_TOOL_PERMISSIONS`	No	`boolean` default `false`
`ENABLE_TOOL_SEARCH`	No	`boolean` default `false`
`TOOL_SEARCH_DEFER_THRESHOLD`	No	`integer` default `400`
`TOOL_SEARCH_ALWAYS_LOADED`	No	`array` default `[]` Elementi dell’array `string`
`TOOL_SEARCH_DEFER_BUILTIN_TOOLS`	No	`boolean` default `true`

ChatDocument

object

Documento nativo Open WebUI: history contiene l’albero dei messaggi, messages il ramo corrente. I contenuti sono cifrati da Netter in PostgreSQL. La lettura non rinnova la scadenza.

Campo Obbligatorio Struttura e vincoli

models

array

Elementi dell’array

string

history

object

Campo	Obbligatorio	Struttura e vincoli
`messages`	Sì	`object` Valori dei campi aggiuntivi ChatHistoryMessage
`currentId`	Sì	Almeno uno tra Variante 1 `string` Variante 2 `null`

messages

array

Elementi dell’array

ChatHistoryMessage

params

object

Valori dei campi aggiuntivi

timestamp

integer

Unix timestamp in secondi.

Sono ammessi campi aggiuntivi.

ChatFolderIdForm

object

Campo	Obbligatorio	Struttura e vincoli
`folder_id`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`

ChatForm

object

Campo	Obbligatorio	Struttura e vincoli
`chat`	Sì	ChatDocument
`variables`	No	Almeno uno tra Variante 1 `object` Sono ammessi campi aggiuntivi. Variante 2 `null`
`folder_id`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`

ChatHistoryMessage

object

Campo	Obbligatorio	Struttura e vincoli
`id`	Sì	`string`
`role`	Sì	`string` enum `["user","assistant","system","tool"]`
`content`	Sì	Almeno uno tra Variante 1 `string` Variante 2 `array` Elementi dell’array ContentPart
`parentId`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`
`childrenIds`	No	`array` Elementi dell’array `string`
`timestamp`	No	`integer` Unix timestamp in secondi.
`done`	No	`boolean`
`model`	No	`string`
`models`	No	`array` Elementi dell’array `string`
`files`	No	`array` Elementi dell’array JSONValue
`info`	No	JSONValue

Sono ammessi campi aggiuntivi.

ChatMessage

object

Campo	Obbligatorio	Struttura e vincoli
`role`	Sì	`string` enum `["system","developer","user","assistant","tool"]`
`content`	No	Almeno uno tra Variante 1 `string` Variante 2 `array` Elementi dell’array ContentPart Variante 3 `null`
`name`	No	`string`
`tool_call_id`	No	`string`
`tool_calls`	No	`array` Elementi dell’array ToolCall

Sono ammessi campi aggiuntivi.

ChatResponse

object

Campo	Obbligatorio	Struttura e vincoli
`id`	Sì	`string`
`user_id`	Sì	`string`
`title`	Sì	`string`
`chat`	Sì	ChatDocument
`updated_at`	Sì	`integer`
`created_at`	Sì	`integer`
`share_id`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`
`archived`	Sì	`boolean`
`pinned`	No	default `false` Almeno uno tra Variante 1 `boolean` Variante 2 `null`
`meta`	No	`object` default `{}` Sono ammessi campi aggiuntivi.
`variables`	No	`object` default `{}` Sono ammessi campi aggiuntivi.
`folder_id`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`
`tasks`	No	Almeno uno tra Variante 1 `array` Elementi dell’array Variante 2 `null`
`summary`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`
`current_message_id`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`
`context_usage`	No	Almeno uno tra Variante 1 `object` Sono ammessi campi aggiuntivi. Variante 2 `null`

ChatTitleIdResponse

object

Campo	Obbligatorio	Struttura e vincoli
`id`	Sì	`string`
`title`	Sì	`string`
`updated_at`	Sì	`integer`
`created_at`	Sì	`integer`
`last_read_at`	No	Almeno uno tra Variante 1 `integer` Variante 2 `null`
`snippet`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`
`active`	No	`boolean` default `false`
`archived`	No	`boolean` default `false`

ChatTool

object

Campo Obbligatorio Struttura e vincoli

type

Sì

string

const: "function"

function

Sì

object

Campo	Obbligatorio	Struttura e vincoli
`name`	Sì	`string`
`description`	No	`string`
`parameters`	No	`object` JSON Schema degli argomenti dello strumento eseguito dal client. Sono ammessi campi aggiuntivi.
`strict`	No	`boolean`

ChatUsageStatsListResponse

object

Campo	Obbligatorio	Struttura e vincoli
`items`	Sì	`array` Elementi dell’array ChatUsageStatsResponse
`total`	Sì	`integer`

Sono ammessi campi aggiuntivi.

ChatUsageStatsResponse

object

Campo	Obbligatorio	Struttura e vincoli
`id`	Sì	`string`
`models`	No	`object` default `{}` Sono ammessi campi aggiuntivi.
`message_count`	Sì	`integer`
`history_models`	No	`object` default `{}` Sono ammessi campi aggiuntivi.
`history_message_count`	Sì	`integer`
`history_user_message_count`	Sì	`integer`
`history_assistant_message_count`	Sì	`integer`
`average_response_time`	Sì	`number`
`average_user_message_content_length`	Sì	`number`
`average_assistant_message_content_length`	Sì	`number`
`tags`	No	`array` default `[]` Elementi dell’array `string`
`last_message_at`	Sì	`integer`
`updated_at`	Sì	`integer`
`created_at`	Sì	`integer`

Sono ammessi campi aggiuntivi.

CompactChatForm

object

Campo	Obbligatorio	Struttura e vincoli
`model`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`

ContentPart

Blocchi nativi del protocollo selezionato; usare solo i tipi supportati dal modello e dalla route. Firme e blocchi opachi vanno reinviati invariati.

Esattamente uno tra

Variante 1

object

Campo	Obbligatorio	Struttura e vincoli
`type`	Sì	`string` enum `["text","input_text","output_text"]`
`text`	Sì	`string`

Variante 2

object

Campo Obbligatorio Struttura e vincoli

type

Sì

string

const: "image_url"

image_url

Sì

object

Campo	Obbligatorio	Struttura e vincoli
`url`	Sì	`string` URL immagine o data URI. I byte immagine non passano dal filtro PII.
`detail`	No	`string` enum `["auto","low","high"]`

Variante 3

object

Usare image_url oppure file_id Netter.

Campo	Obbligatorio	Struttura e vincoli
`type`	Sì	`string` const `"input_image"`
`image_url`	No	`string`
`file_id`	No	`string`
`detail`	No	`string` enum `["auto","low","high"]`

Variante 4

object

Usare file_id Netter oppure dati base64. Il documento viene estratto localmente; URL remoti non supportati.

Campo Obbligatorio Struttura e vincoli

type

Sì

string

enum: ["input_file","document"]

file_id

string

file_data

string

filename

string

source

object

Campo	Obbligatorio	Struttura e vincoli
`type`	No	`string`
`data`	No	`string`
`media_type`	No	`string`

Variante 5

object

Campo Obbligatorio Struttura e vincoli

type

Sì

string

const: "input_audio"

input_audio

Sì

object

Campo	Obbligatorio	Struttura e vincoli
`data`	Sì	`string` contentEncoding `"base64"`
`format`	Sì	`string`

Variante 6

object

Campo Obbligatorio Struttura e vincoli

type

Sì

string

const: "image"

source

Sì

object

Campo	Obbligatorio	Struttura e vincoli
`type`	Sì	`string` enum `["base64","url"]`
`media_type`	No	`string`
`data`	No	`string`
`url`	No	`string`
`file_id`	No	`string`

Variante 7

object

Campo	Obbligatorio	Struttura e vincoli
`type`	Sì	`string` const `"tool_use"`
`id`	Sì	`string`
`name`	Sì	`string`
`input`	Sì	JSONValue

Variante 8

object

Campo	Obbligatorio	Struttura e vincoli
`type`	Sì	`string` const `"tool_result"`
`tool_use_id`	Sì	`string`
`content`	Sì	Almeno uno tra Variante 1 `string` Variante 2 `array` Elementi dell’array ContentPart
`is_error`	No	`boolean`

Variante 9

object

Campo	Obbligatorio	Struttura e vincoli
`type`	Sì	`string` const `"thinking"`
`thinking`	Sì	`string`
`signature`	No	`string`

Variante 10

object

Campo	Obbligatorio	Struttura e vincoli
`type`	Sì	`string` const `"redacted_thinking"`
`data`	Sì	`string`

EventForm

object

Campo	Obbligatorio	Struttura e vincoli
`type`	Sì	`string`
`data`	Sì	`object` Sono ammessi campi aggiuntivi.

FileListResponse

object

Campo	Obbligatorio	Struttura e vincoli
`items`	Sì	`array` Elementi dell’array FileModelResponse
`total`	Sì	`integer`

FileMeta

object

Campo	Obbligatorio	Struttura e vincoli
`name`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`
`content_type`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`
`size`	No	Almeno uno tra Variante 1 `integer` Variante 2 `null`

Sono ammessi campi aggiuntivi.

FileModel

object

Campo	Obbligatorio	Struttura e vincoli
`id`	Sì	`string`
`user_id`	Sì	`string`
`hash`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`
`filename`	Sì	`string`
`path`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`
`data`	No	Almeno uno tra Variante 1 `object` Sono ammessi campi aggiuntivi. Variante 2 `null`
`meta`	No	Almeno uno tra Variante 1 `object` Sono ammessi campi aggiuntivi. Variante 2 `null`
`created_at`	Sì	Almeno uno tra Variante 1 `integer` Variante 2 `null`
`updated_at`	Sì	Almeno uno tra Variante 1 `integer` Variante 2 `null`

FileModelResponse

object

Campo	Obbligatorio	Struttura e vincoli
`id`	Sì	`string`
`user_id`	Sì	`string`
`hash`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`
`filename`	Sì	`string`
`data`	No	Almeno uno tra Variante 1 `object` Sono ammessi campi aggiuntivi. Variante 2 `null`
`meta`	No	Almeno uno tra Variante 1 FileMeta Variante 2 `null`
`created_at`	Sì	`integer`
`updated_at`	No	Almeno uno tra Variante 1 `integer` Variante 2 `null`

Sono ammessi campi aggiuntivi.

FileRenameForm

object

Campo	Obbligatorio	Struttura e vincoli
`filename`	Sì	`string`

FolderAccessGrantsForm

object

Campo	Obbligatorio	Struttura e vincoli
`access_grants`	Sì	`array` Elementi dell’array `object` Sono ammessi campi aggiuntivi.
`share_mode`	No	Almeno uno tra Variante 1 `string` const `"continue"` Variante 2 `null`

FolderForm

object

Campo	Obbligatorio	Struttura e vincoli
`name`	Sì	`string`
`data`	No	Almeno uno tra Variante 1 `object` Sono ammessi campi aggiuntivi. Variante 2 `null`
`meta`	No	Almeno uno tra Variante 1 `object` Sono ammessi campi aggiuntivi. Variante 2 `null`
`parent_id`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`

I campi aggiuntivi sono rifiutati.

FolderIsExpandedForm

object

Campo	Obbligatorio	Struttura e vincoli
`is_expanded`	Sì	`boolean`

FolderMetadataResponse

object

Campo	Obbligatorio	Struttura e vincoli
`icon`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`

FolderModel

object

Campo	Obbligatorio	Struttura e vincoli
`id`	Sì	`string`
`parent_id`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`
`user_id`	Sì	`string`
`name`	Sì	`string`
`items`	No	Almeno uno tra Variante 1 `object` Sono ammessi campi aggiuntivi. Variante 2 `null`
`meta`	No	Almeno uno tra Variante 1 `object` Sono ammessi campi aggiuntivi. Variante 2 `null`
`data`	No	Almeno uno tra Variante 1 `object` Sono ammessi campi aggiuntivi. Variante 2 `null`
`is_expanded`	No	`boolean` default `false`
`created_at`	Sì	`integer`
`updated_at`	Sì	`integer`

FolderNameIdResponse

object

Campo	Obbligatorio	Struttura e vincoli
`id`	Sì	`string`
`name`	Sì	`string`
`meta`	No	Almeno uno tra Variante 1 FolderMetadataResponse Variante 2 `null`
`parent_id`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`
`is_expanded`	No	`boolean` default `false`
`unread_count`	No	`integer` default `0`
`created_at`	Sì	`integer`
`updated_at`	Sì	`integer`

FolderParentIdForm

object

Campo	Obbligatorio	Struttura e vincoli
`parent_id`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`

FolderResponse

object

Campo	Obbligatorio	Struttura e vincoli
`id`	Sì	`string`
`parent_id`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`
`user_id`	Sì	`string`
`name`	Sì	`string`
`items`	No	Almeno uno tra Variante 1 `object` Sono ammessi campi aggiuntivi. Variante 2 `null`
`meta`	No	Almeno uno tra Variante 1 `object` Sono ammessi campi aggiuntivi. Variante 2 `null`
`data`	No	Almeno uno tra Variante 1 `object` Sono ammessi campi aggiuntivi. Variante 2 `null`
`is_expanded`	No	`boolean` default `false`
`created_at`	Sì	`integer`
`updated_at`	Sì	`integer`
`access_grants`	No	`array` default `[]` Elementi dell’array `object` Sono ammessi campi aggiuntivi.
`write_access`	No	`boolean` default `false`

FolderUpdateForm

object

Campo	Obbligatorio	Struttura e vincoli
`name`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`
`data`	No	Almeno uno tra Variante 1 `object` Sono ammessi campi aggiuntivi. Variante 2 `null`
`meta`	No	Almeno uno tra Variante 1 `object` Sono ammessi campi aggiuntivi. Variante 2 `null`

I campi aggiuntivi sono rifiutati.

ForkForm

object

Campo	Obbligatorio	Struttura e vincoli
`message_id`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`

FunctionCall

object

Campo	Obbligatorio	Struttura e vincoli
`name`	Sì	`string`
`arguments`	Sì	`string` Argomenti serializzati come stringa JSON.

GatewayChatResponse

object

Campo Obbligatorio Struttura e vincoli

id

Sì

string

object

Sì

string

const: "chat.completion"

created

integer

model

Sì

choices

Sì

array

Elementi dell’array

object

Campo	Obbligatorio	Struttura e vincoli
`index`	Sì	`integer`
`message`	Sì	ChatMessage
`finish_reason`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`

usage

Usage

Sono ammessi campi aggiuntivi.

HTTPValidationError

object

Campo	Obbligatorio	Struttura e vincoli
`detail`	No	`array` Elementi dell’array ValidationError

JSONValue

Valore JSON applicativo arbitrario: null, booleano, numero, stringa, array oppure oggetto. La struttura dipende dal contenuto salvato o dallo schema JSON fornito dal chiamante.

MCPChat

object

Campo	Obbligatorio	Struttura e vincoli
`id`	Sì	`string`
`title`	Sì	`string`
`chat`	Sì	ChatDocument
`revision`	Sì	`integer` minimum `0`

MCPChatList

object

Campo Obbligatorio Struttura e vincoli

items

Sì

array

Elementi dell’array

object

Campo	Obbligatorio	Struttura e vincoli
`id`	Sì	`string`
`title`	Sì	`string`
`updated_at`	Sì	`integer` Unix timestamp in secondi.

next_offset

Sì

Almeno uno tra

Variante 1

integer

minimum: 0

Variante 2

null

MCPContinueResult

Almeno uno tra

Variante 1

object

Campo	Obbligatorio	Struttura e vincoli
`chat_id`	Sì	`string`
`revision`	Sì	`integer`
`content`	Sì	`string`
`saved`	Sì	`boolean` const `true`

Variante 2

object

Campo	Obbligatorio	Struttura e vincoli
`chat_id`	Sì	`string`
`content`	Sì	`string`
`saved`	Sì	`boolean` const `false`
`reason`	Sì	`string` enum `["conversation_deleted","parent_deleted"]`

Variante 3

object

Campo	Obbligatorio	Struttura e vincoli
`error`	Sì	`string`
`chat_id`	Sì	`string`

MCPMethodError

object

Campo Obbligatorio Struttura e vincoli

jsonrpc

Sì

string

const: "2.0"

id

Sì

Almeno uno tra

Variante 1

string

Variante 2

integer

error

Sì

object

Campo	Obbligatorio	Struttura e vincoli
`code`	Sì	`integer` const `-32601`
`message`	Sì	`string` const `"Method not found"`

MCPRequest

object

JSON-RPC 2.0 via HTTP POST. initialize/ping/tools/list non richiedono params. tools/call richiede params con name e arguments corrispondenti allo strumento. id assente o null: notifica, HTTP 202 senza corpo. Ogni chiamata con id richiede chat:read; le scritture richiedono anche chat:write e chat_continue richiede chat:infer.

Esattamente uno tra

Variante 1

object

Campo Obbligatorio Struttura e vincoli

method

Sì

string

const: "tools/call"

params

Sì

Esattamente uno tra

Variante 1

object

Campo	Obbligatorio	Struttura e vincoli
`name`	Sì	`string` const `"chat_list"`
`arguments`	Sì	chat_listArguments

Variante 2

object

Campo	Obbligatorio	Struttura e vincoli
`name`	Sì	`string` const `"chat_search"`
`arguments`	Sì	chat_searchArguments

Variante 3

object

Campo	Obbligatorio	Struttura e vincoli
`name`	Sì	`string` const `"chat_get"`
`arguments`	Sì	chat_getArguments

Variante 4

object

Campo	Obbligatorio	Struttura e vincoli
`name`	Sì	`string` const `"chat_create"`
`arguments`	Sì	chat_createArguments

Variante 5

object

Campo	Obbligatorio	Struttura e vincoli
`name`	Sì	`string` const `"chat_append"`
`arguments`	Sì	chat_appendArguments

Variante 6

object

Campo	Obbligatorio	Struttura e vincoli
`name`	Sì	`string` const `"chat_continue"`
`arguments`	Sì	chat_continueArguments

Variante 2

object

Campo	Obbligatorio	Struttura e vincoli
`method`	Sì	`string` enum `["initialize","ping","tools/list"]`

Campo Obbligatorio Struttura e vincoli

jsonrpc

string

const: "2.0"

id

Almeno uno tra

Variante 1

Almeno uno tra

Variante 1

string

Variante 2

integer

Variante 2

null

method

Sì

string

enum: ["initialize","ping","tools/list","tools/call"]

params

Almeno uno tra

Variante 1

object

Campo Obbligatorio Struttura e vincoli

protocolVersion

string

capabilities

clientInfo

object

Campo	Obbligatorio	Struttura e vincoli
`name`	Sì	`string`
`version`	Sì	`string`

Variante 2

Esattamente uno tra

Variante 1

object

Campo	Obbligatorio	Struttura e vincoli
`name`	Sì	`string` const `"chat_list"`
`arguments`	Sì	chat_listArguments

Variante 2

object

Campo	Obbligatorio	Struttura e vincoli
`name`	Sì	`string` const `"chat_search"`
`arguments`	Sì	chat_searchArguments

Variante 3

object

Campo	Obbligatorio	Struttura e vincoli
`name`	Sì	`string` const `"chat_get"`
`arguments`	Sì	chat_getArguments

Variante 4

object

Campo	Obbligatorio	Struttura e vincoli
`name`	Sì	`string` const `"chat_create"`
`arguments`	Sì	chat_createArguments

Variante 5

object

Campo	Obbligatorio	Struttura e vincoli
`name`	Sì	`string` const `"chat_append"`
`arguments`	Sì	chat_appendArguments

Variante 6

object

Campo	Obbligatorio	Struttura e vincoli
`name`	Sì	`string` const `"chat_continue"`
`arguments`	Sì	chat_continueArguments

MCPResult

object

Campo Obbligatorio Struttura e vincoli

jsonrpc

Sì

string

const: "2.0"

id

Sì

Almeno uno tra

Variante 1

string

Variante 2

integer

result

Sì

Almeno uno tra

Variante 1

object

Campo Obbligatorio Struttura e vincoli

protocolVersion

Sì

string

capabilities

Sì

object

Campo Obbligatorio Struttura e vincoli

tools

Sì

object

Campo	Obbligatorio	Struttura e vincoli
`listChanged`	Sì	`boolean` const `false`

serverInfo

Sì

object

Campo	Obbligatorio	Struttura e vincoli
`name`	Sì	`string` const `"netter-openwebui"`
`version`	Sì	`string` const `"1.0.0"`

Variante 2

object

Campo Obbligatorio Struttura e vincoli

tools

Sì

array

Elementi dell’array

object

Campo	Obbligatorio	Struttura e vincoli
`name`	Sì	`string`
`description`	Sì	`string`
`inputSchema`	Sì	JSONValue
`annotations`	Sì	JSONValue

Variante 3

object

Campo Obbligatorio Struttura e vincoli

content

Sì

array

Elementi dell’array

object

Campo	Obbligatorio	Struttura e vincoli
`type`	Sì	`string` const `"text"`
`text`	Sì	`string` Per tools/call contiene JSON serializzato: decodificare text secondo lo schema del risultato dello strumento. In caso di errore può essere testo semplice.

isError

Sì

boolean

Variante 4

object

Campo	Obbligatorio	Struttura e vincoli

I campi aggiuntivi sono rifiutati.

MessagesResponse

object

Campo	Obbligatorio	Struttura e vincoli
`id`	Sì	`string`
`type`	Sì	`string` const `"message"`
`role`	Sì	`string` const `"assistant"`
`content`	Sì	`array` Elementi dell’array ContentPart
`model`	Sì	Profile
`stop_reason`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`
`stop_sequence`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`
`usage`	Sì	Usage

Sono ammessi campi aggiuntivi.

MessagesStreamEvent

object

Campo Obbligatorio Struttura e vincoli

type

Sì

string

enum: ["message_start","content_block_start","content_block_delta","content_block_stop","message_delta","message_stop","ping","error"]

index

integer

message

MessagesResponse

content_block

ContentPart

delta

object

Campo	Obbligatorio	Struttura e vincoli
`type`	No	`string`
`text`	No	`string`
`partial_json`	No	`string`
`thinking`	No	`string`
`signature`	No	`string`
`stop_reason`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`
`stop_sequence`	No	Almeno uno tra Variante 1 `string` Variante 2 `null`

Sono ammessi campi aggiuntivi.

usage

Usage

error

Sono ammessi campi aggiuntivi.

Model

object

Campo Obbligatorio Struttura e vincoli

id

Sì

display_name

Sì

string

object

Sì

string

const: "model"

type

Sì

string

const: "model"

created

Sì

integer

Unix timestamp in secondi.

created_at

Sì

string

format: "date-time"

owned_by

Sì

string

const: "openai"

operations

Sì

array

Elementi dell’array

string

name

string

urlIdx

integer

info

object

Campo Obbligatorio Struttura e vincoli

meta

Sì

object

Campo	Obbligatorio	Struttura e vincoli
`capabilities`	Sì	`object` Valori dei campi aggiuntivi `boolean`

params

Sì

object

Campo	Obbligatorio	Struttura e vincoli
`function_calling`	Sì	`string` const `"legacy"`

ModelList

object

Campo	Obbligatorio	Struttura e vincoli
`object`	Sì	`string` const `"list"`
`data`	Sì	`array` Elementi dell’array Model
`has_more`	Sì	`boolean` const `false`

NativeChatRequest

object

Serve un identificativo di generazione: id oppure un singolo valore in message_ids. Un identificativo già inviato restituisce 409 e non ridispatcha inferenza. chat_id deve appartenere all’utente. Soltanto web_search e code_interpreter sono abilitabili; tool/provider esterni e background_tasks sono filtrati sul server.

Campo Obbligatorio Struttura e vincoli

model

Nome pubblico esatto. Se omesso usa il default effettivo della chiave; switchyard disponibile solo su Chat, Responses e Messages.

stream

boolean

default: false

temperature

number

top_p

number

reasoning_effort

ReasoningEffort

messages

Sì

array

Elementi dell’array

ChatMessage

max_tokens

integer

minimum: 1

max_completion_tokens

integer

minimum: 1

tools

array

Elementi dell’array

ChatTool

tool_choice

Almeno uno tra

Variante 1

string

enum: ["auto","none","required"]

Variante 2

object

Campo Obbligatorio Struttura e vincoli

type

Sì

string

const: "function"

function

Sì

object

Campo	Obbligatorio	Struttura e vincoli
`name`	Sì	`string`

parallel_tool_calls

boolean

response_format

object

Campo Obbligatorio Struttura e vincoli

type

Sì

string

enum: ["text","json_object","json_schema"]

json_schema

object

Campo	Obbligatorio	Struttura e vincoli
`name`	Sì	`string`
`description`	No	`string`
`schema`	Sì	`object` JSON Schema del risultato strutturato. Sono ammessi campi aggiuntivi.
`strict`	No	`boolean`

stop

Almeno uno tra

Variante 1

string

Variante 2

array

Elementi dell’array

string

stream_options

object

Campo	Obbligatorio	Struttura e vincoli
`include_usage`	No	`boolean`

chat_id

string

id

string

message_ids

Almeno uno tra

Variante 1

object

Valori dei campi aggiuntivi

string

Variante 2

array

Elementi dell’array

object

Campo	Obbligatorio	Struttura e vincoli
`message_id`	Sì	`string`

features

object

Campo	Obbligatorio	Struttura e vincoli
`web_search`	No	`boolean`
`code_interpreter`	No	`boolean`

params

object

Valori dei campi aggiuntivi