Open WebUI and MCP API

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/

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

Origin · header · optional

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

string

Request body · required

`application/json`

UpdateTimezoneForm

Responses

200 · Operazione completata

`application/json`

object

Field	Required	Structure and constraints
`status`	Yes	`boolean`

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

Origin · header · optional

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

string

Responses

200 · Operazione completata

`application/json`

object

Field	Required	Structure and constraints
`status`	Yes	`boolean` const `true`
`redirect_url`	Yes	`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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

raw · query · optional

boolean

default: false

Responses

200 · Successful Response

`application/json`

Any of

Variant 1

UserSettings

Variant 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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

Origin · header · optional

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

string

Request body · required

`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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

user_id · path · required

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

user_id · path · required

string

Responses

200 · Operazione completata

`application/json`

array

Array items

object

Field	Required	Structure and constraints
`id`	No	`string`
`provider`	No	`string`
`expires_at`	No	Any of Variant 1 `integer` Unix timestamp in secondi. Variant 2 `null`

200 · Operazione completata

`image/*`

string

format: "binary"

302 · Redirect all’immagine del profilo

Location

200 · Operazione completata

`application/json`

object

Field	Required	Structure and constraints
`active`	Yes	`boolean`

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

user_id · path · required

string

Origin · header · optional

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

user_id · path · required

string

Origin · header · optional

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

string

Request body · required

`application/json`

UserUpdateForm

Responses

200 · Successful Response

`application/json`

Any of

Variant 1

UserModel

Variant 2

boolean

default: false

Responses

200 · Operazione completata

`application/json`

array

Array items

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

user_id · path · required

string

Responses

200 · Operazione completata

`application/json`

object

Field Required Structure and constraints

user

Yes

object

Field	Required	Structure and constraints
`id`	Yes	`string`
`name`	Yes	`string`

groups

Yes

array

Array items

object

Field	Required	Structure and constraints
`id`	Yes	`string`
`name`	Yes	`string`

models

Yes

object

Field Required Structure and constraints

items

Yes

array

Array items

object

Field	Required	Structure and constraints
`id`	Yes	`string`
`name`	Yes	`string`

total

Yes

integer

knowledge

Yes

object

Field Required Structure and constraints

items

Yes

array

Array items

object

Field	Required	Structure and constraints
`id`	Yes	`string`
`name`	Yes	`string`

total

Yes

integer

tools

Yes

object

Field Required Structure and constraints

items

Yes

array

Array items

object

Field	Required	Structure and constraints
`id`	Yes	`string`
`name`	Yes	`string`

total

Yes

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

page · query · optional

Any of

Variant 1

integer

Variant 2

null

include_pinned · query · optional

default: false

Any of

Variant 1

boolean

Variant 2

null

include_folders · query · optional

default: false

Any of

Variant 1

boolean

Variant 2

null

sort_by · query · optional

string

default: "updated_at"

sort_dir · query · optional

string

default: "desc"

Responses

200 · Successful Response

`application/json`

array

Array items

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/

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

page · query · optional

Any of

Variant 1

integer

Variant 2

null

include_pinned · query · optional

default: false

Any of

Variant 1

boolean

Variant 2

null

include_folders · query · optional

default: false

Any of

Variant 1

boolean

Variant 2

null

sort_by · query · optional

string

default: "updated_at"

sort_dir · query · optional

string

default: "desc"

Responses

200 · Successful Response

`application/json`

array

Array items

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/

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

Origin · header · optional

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

Origin · header · optional

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

string

Responses

200 · Operazione completata

`application/json`

object

Field	Required	Structure and constraints
`updated_count`	Yes	`integer`
`folder_unread_counts`	Yes	`object` Additional field values `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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

items_per_page · query · optional

default: 50

Any of

Variant 1

integer

Variant 2

null

page · query · optional

default: 1

Any of

Variant 1

integer

Variant 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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

Origin · header · optional

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

string

Request body · required

`application/json`

ChatForm

Responses

200 · Successful Response

`application/json`

Any of

Variant 1

Variant 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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

Origin · header · optional

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

string

Request body · required

`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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

text · query · required

string

page · query · optional

Any of

Variant 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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

folder_id · path · required

string

page · query · optional

default: 1

Any of

Variant 1

integer

Variant 2

null

sort_by · query · optional

string

default: "unread_updated_at"

sort_dir · query · optional

string

default: "desc"

Responses

200 · Successful Response

`application/json`

array

Array items

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Responses

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

page · query · optional

Any of

Variant 1

integer

Variant 2

null

query · query · optional

Any of

Variant 1

string

Variant 2

null

order_by · query · optional

Any of

Variant 1

string

Variant 2

null

direction · query · optional

Any of

Variant 1

string

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

Origin · header · optional

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

Origin · header · optional

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

Origin · header · optional

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

string

Request body · optional

`application/json`

Any of

Variant 1

CompactChatForm

Variant 2

null

Responses

200 · Operazione completata

`application/json`

object

Field	Required	Structure and constraints
`ok`	Yes	`boolean`
`compacted`	Yes	`boolean`
`reason`	No	`string`
`summary`	No	`string`
`dropped_messages`	No	`integer`
`context_usage`	No	Any of Variant 1 JSONValue Variant 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}

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

Responses

200 · Successful Response

`application/json`

Any of

Variant 1

Variant 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}

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

Origin · header · optional

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

string

Request body · required

`application/json`

ChatForm

Responses

200 · Successful Response

`application/json`

Any of

Variant 1

Variant 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}

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

Origin · header · optional

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}

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

message_id · path · required

string

Origin · header · optional

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

string

Request body · required

`application/json`

Responses

200 · Successful Response

`application/json`

Any of

Variant 1

Variant 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}

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

message_id · path · required

string

Origin · header · optional

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

string

Responses

200 · Successful Response

`application/json`

Any of

Variant 1

Variant 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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

message_id · path · required

string

Origin · header · optional

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

string

Request body · required

`application/json`

EventForm

Responses

200 · Successful Response

`application/json`

Any of

Variant 1

boolean

Variant 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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

Responses

200 · Successful Response

`application/json`

Any of

Variant 1

boolean

Variant 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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

Origin · header · optional

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

string

Responses

200 · Successful Response

`application/json`

Any of

Variant 1

Variant 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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

Origin · header · optional

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

string

Request body · optional

`application/json`

Any of

Variant 1

ForkForm

Variant 2

null

Responses

200 · Successful Response

`application/json`

Any of

Variant 1

Variant 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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

Origin · header · optional

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

string

Responses

200 · Successful Response

`application/json`

Any of

Variant 1

Variant 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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

Origin · header · optional

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

string

Responses

200 · Operazione completata

`application/json`

object

Field	Required	Structure and constraints
`chat_id`	Yes	`string`
`last_read_at`	Yes	Any of Variant 1 `integer` Unix timestamp in secondi. Variant 2 `null`
`folder_id`	Yes	Any of Variant 1 `string` Variant 2 `null`
`folder_unread_counts`	Yes	`object` Additional field values `integer`

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

Origin · header · optional

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

string

Request body · required

`application/json`

ChatFolderIdForm

Responses

200 · Successful Response

`application/json`

Any of

Variant 1

Variant 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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

Origin · header · optional

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

string

Request body · required

`application/json`

TagForm

Responses

200 · Successful Response

`application/json`

array

Array items

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

Origin · header · optional

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

string

Request body · required

`application/json`

TagForm

Responses

200 · Successful Response

`application/json`

array

Array items

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · query · required

string

Responses

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}

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

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}

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

delete_contents · query · optional

default: true

Any of

Variant 1

boolean

Variant 2

null

Origin · header · optional

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

Origin · header · optional

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

string

Request body · required

`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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

Origin · header · optional

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

string

Request body · required

`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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

Origin · header · optional

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

string

Request body · required

`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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

Origin · header · optional

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

string

Request body · required

`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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

Origin · header · optional

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

string

Responses

200 · Operazione completata

`application/json`

object

Field	Required	Structure and constraints
`folder_id`	Yes	`string`
`folder_ids`	Yes	`array` Array items `string`
`updated_count`	Yes	`integer`
`folder_unread_counts`	Yes	`object` Additional field values `integer`

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

Origin · header · optional

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

string

Request body · required

`multipart/form-data`

object

Field	Required	Structure and constraints
`file`	Yes	`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/

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

page · query · optional

Page number (1-indexed)

integer

Page number (1-indexed)

minimum: 1
default: 1

content · query · optional

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

filename · query · required

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

string

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

content · query · optional

boolean

default: true

skip · query · optional

Number of files to skip

integer

Number of files to skip

minimum: 0
default: 0

limit · query · optional

Maximum number of files to return

integer

Maximum number of files to return

maximum: 1000
minimum: 1
default: 100

Responses

200 · Successful Response

`application/json`

array

Array items

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

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}

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

Responses

200 · Successful Response

`application/json`

Any of

Variant 1

FileModel

Variant 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}

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

Origin · header · optional

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

string

Responses

200 · Operazione completata

`application/json`

object

Field	Required	Structure and constraints
`message`	Yes	`string`

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

stream · query · optional

boolean

default: false

Responses

200 · Operazione completata

`application/json`

object

Field	Required	Structure and constraints
`status`	Yes	`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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

Responses

200 · Operazione completata

`application/json`

object

Field	Required	Structure and constraints
`content`	Yes	`string`

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

attachment · query · optional

boolean

default: false

Responses

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

Responses

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}

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

file_name · path · required

string

Responses

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

Origin · header · optional

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

string

Request body · required

`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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

refresh · query · optional

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

refresh · query · optional

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

Origin · header · optional

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

string

Request body · required

`application/json`

NativeChatRequest

Responses

200 · Operazione completata

`application/json`

Any of

Variant 1

GatewayChatResponse

Variant 2

object

Field	Required	Structure and constraints
`status`	Yes	`boolean`
`chat_id`	Yes	Any of Variant 1 `string` Variant 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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

Origin · header · optional

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

string

Request body · required

`application/json`

NativeChatRequest

Responses

200 · Operazione completata

`application/json`

Any of

Variant 1

GatewayChatResponse

Variant 2

object

Field	Required	Structure and constraints
`status`	Yes	`boolean`
`chat_id`	Yes	Any of Variant 1 `string` Variant 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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

id · path · required

string

message_id · path · required

string

Origin · header · optional

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

string

Request body · required

`application/json`

ResolveToolCallForm

Responses

200 · Operazione completata

`application/json`

object

Field	Required	Structure and constraints
`status`	Yes	`boolean`
`chat_id`	Yes	`string`
`message_id`	Yes	`string`
`task_ids`	No	`array` Array items `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}

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

task_id · path · required

string

Origin · header · optional

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

string

Responses

200 · Operazione completata

`application/json`

object

Field	Required	Structure and constraints
`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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Responses

200 · Operazione completata

`application/json`

object

Field	Required	Structure and constraints
`tasks`	Yes	`array` Array items `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}

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

chat_id · path · required

string

Responses

200 · Operazione completata

`application/json`

object

Field	Required	Structure and constraints
`task_ids`	No	`array` Array items `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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

chat_id · path · required

string

Origin · header · optional

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

string

Responses

200 · Operazione completata

`application/json`

object

Field	Required	Structure and constraints
`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

Security:[] · An empty array means no session/API key requirement; see operation-specific checks.

Responses

200 · Operazione completata

`application/json`

object

Field Required Structure and constraints

status

boolean

name

string

version

string

default_locale

string

features

object

Additional field values

boolean

oauth

object

Field	Required	Structure and constraints
`providers`	No	`object` Additional field values `string`
`auto_redirect`	No	Any of Variant 1 `boolean` Variant 2 `null`

i18n

object

Additional field values

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

Security:[] · An empty array means no session/API key requirement; see operation-specific checks.

Responses

200 · Operazione completata

`application/json`

object

Field	Required	Structure and constraints
`version`	Yes	`string`
`deployment_id`	Yes	`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

Security:[] · An empty array means no session/API key requirement; see operation-specific checks.

Responses

200 · Operazione completata

`application/json`

object

Field	Required	Structure and constraints
`status`	Yes	`string` const `"ok"`
`service`	Yes	`string` const `"openwebui"`
`version`	Yes	`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

Security:[] · An empty array means no session/API key requirement; see operation-specific checks.

Responses

200 · Operazione completata

`application/json`

object

Field	Required	Structure and constraints
`status`	Yes	`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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Responses

200 · Operazione completata

`application/json`

object

Field	Required	Structure and constraints
`status`	Yes	`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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Responses

200 · Operazione completata

`application/json`

array

maxItems: 0

Array items

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Responses

200 · Operazione completata

`application/json`

array

maxItems: 0

Array items

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Responses

200 · Operazione completata

`application/json`

array

maxItems: 0

Array items

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Responses

200 · Operazione completata

`application/json`

array

maxItems: 0

Array items

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Responses

200 · Operazione completata

`application/json`

array

maxItems: 0

Array items

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Responses

200 · Operazione completata

`application/json`

array

maxItems: 0

Array items

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Responses

200 · Operazione completata

`application/json`

array

maxItems: 0

Array items

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Responses

200 · Operazione completata

`application/json`

array

maxItems: 0

Array items

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Responses

200 · Operazione completata

`application/json`

array

maxItems: 0

Array items

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Responses

200 · Operazione completata

`application/json`

array

maxItems: 0

Array items

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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Responses

200 · Operazione completata

`application/json`

array

Array items

object

Field	Required	Structure and constraints
`id`	Yes	`string` const `"netter-context"`
`type`	Yes	`string` const `"info"`
`title`	Yes	`null`
`content`	Yes	`string`
`dismissible`	Yes	`boolean` const `true`
`timestamp`	Yes	`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

Security:[] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

Origin · header · required

string

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

Request body · required

`application/x-www-form-urlencoded`

object

Field	Required	Structure and constraints
`ticket`	Yes	`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

Security:[{"device":[]},{"chatSession":[]}] · An empty array means no session/API key requirement; see operation-specific checks.

Parameters

Origin · header · optional

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

string

Request body · required

`application/json`

MCPRequest

`chat_list`

Elenca le tue conversazioni nel workspace corrente.

Tool arguments

object

Field	Required	Structure and constraints
`offset`	No	`integer` minimum `0`

Additional fields are rejected.

Decoded result in content[].text

MCPChatList

`chat_search`

Cerca nelle tue conversazioni autorizzate.

Tool arguments

object

Field	Required	Structure and constraints
`query`	Yes	`string`
`offset`	No	`integer` minimum `0`

Additional fields are rejected.

Decoded result in content[].text

MCPChatList

`chat_get`

Legge una conversazione e la sua revisione corrente.

Tool arguments

object

Field	Required	Structure and constraints
`chat_id`	Yes	`string`

Additional fields are rejected.

Decoded result in content[].text

MCPChat

`chat_create`

Crea una conversazione Open WebUI.

Tool arguments

object

Field	Required	Structure and constraints
`title`	No	`string`
`model`	No	`string`
`operation_id`	Yes	`string` format `"uuid"`

Additional fields are rejected.

Decoded result in content[].text

MCPChat

`chat_append`

Aggiunge un messaggio alla revisione indicata. Non esegue inferenza.

Tool arguments

object

Field	Required	Structure and constraints
`chat_id`	Yes	`string`
`expected_revision`	Yes	`integer` minimum `0`
`operation_id`	Yes	`string` format `"uuid"`
`content`	Yes	`string`
`role`	No	enum `["user","assistant"]`

Additional fields are rejected.

Decoded result in content[].text

MCPChat

`chat_continue`

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

Tool arguments

object

Field	Required	Structure and constraints
`chat_id`	Yes	`string`
`expected_revision`	Yes	`integer` minimum `0`
`operation_id`	Yes	`string` format `"uuid"`
`content`	Yes	`string`
`model`	No	`string`

Additional fields are rejected.

Decoded result in content[].text

MCPContinueResult

Responses

200 · Operazione completata

`application/json`

Any of

Variant 1

MCPResult

Variant 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`

Data structures

Optional and nullable are distinct. All amounts and provider extensions follow the types and constraints below. Source descriptions are preserved in their original language.

BoundaryError

object

Field	Required	Structure and constraints
`detail`	Yes	Any of Variant 1 `string` Variant 2 `array` Array items JSONValue

ChatChunk

object

Field Required Structure and constraints

id

Yes

string

object

Yes

string

const: "chat.completion.chunk"

created

integer

model

choices

Yes

array

Array items

object

Field Required Structure and constraints

index

Yes

integer

delta

Yes

object

Field Required Structure and constraints

role

string

content

Any of

Variant 1

string

Variant 2

null

tool_calls

array

Array items

object

Field Required Structure and constraints

index

Yes

integer

id

string

type

string

function

object

Field	Required	Structure and constraints
`name`	No	`string`
`arguments`	No	`string`

Additional fields are allowed.

finish_reason

Any of

Variant 1

string

Variant 2

null

usage

Any of

Variant 1

Usage

Variant 2

null

Additional fields are allowed.

ChatConfigForm

object

Field	Required	Structure and constraints
`CONTEXT_COMPACTION_MODEL`	No	default `""` Any of Variant 1 `string` Variant 2 `null`
`ENABLE_CONTEXT_COMPACTION`	Yes	`boolean`
`CONTEXT_COMPACTION_TOKEN_THRESHOLD`	No	Any of Variant 1 `integer` Variant 2 `null`
`CONTEXT_COMPACTION_TOKEN_CAP`	No	Any of Variant 1 `integer` Variant 2 `null`
`CONTEXT_COMPACTION_RETENTION_PERCENTAGE`	No	Any of Variant 1 `integer` Variant 2 `null`
`CONTEXT_COMPACTION_PROMPT_TEMPLATE`	Yes	`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 `[]` Array items `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.

Field Required Structure and constraints

models

array

Array items

string

history

object

Field	Required	Structure and constraints
`messages`	Yes	`object` Additional field values ChatHistoryMessage
`currentId`	Yes	Any of Variant 1 `string` Variant 2 `null`

messages

array

Array items

ChatHistoryMessage

params

object

Additional field values

timestamp

integer

Unix timestamp in secondi.

Additional fields are allowed.

ChatFolderIdForm

object

Field	Required	Structure and constraints
`folder_id`	No	Any of Variant 1 `string` Variant 2 `null`

ChatForm

object

Field	Required	Structure and constraints
`chat`	Yes	ChatDocument
`variables`	No	Any of Variant 1 `object` Additional fields are allowed. Variant 2 `null`
`folder_id`	No	Any of Variant 1 `string` Variant 2 `null`

ChatHistoryMessage

object

Field	Required	Structure and constraints
`id`	Yes	`string`
`role`	Yes	`string` enum `["user","assistant","system","tool"]`
`content`	Yes	Any of Variant 1 `string` Variant 2 `array` Array items ContentPart
`parentId`	No	Any of Variant 1 `string` Variant 2 `null`
`childrenIds`	No	`array` Array items `string`
`timestamp`	No	`integer` Unix timestamp in secondi.
`done`	No	`boolean`
`model`	No	`string`
`models`	No	`array` Array items `string`
`files`	No	`array` Array items JSONValue
`info`	No	JSONValue

Additional fields are allowed.

ChatMessage

object

Field	Required	Structure and constraints
`role`	Yes	`string` enum `["system","developer","user","assistant","tool"]`
`content`	No	Any of Variant 1 `string` Variant 2 `array` Array items ContentPart Variant 3 `null`
`name`	No	`string`
`tool_call_id`	No	`string`
`tool_calls`	No	`array` Array items ToolCall

Additional fields are allowed.

ChatResponse

object

Field	Required	Structure and constraints
`id`	Yes	`string`
`user_id`	Yes	`string`
`title`	Yes	`string`
`chat`	Yes	ChatDocument
`updated_at`	Yes	`integer`
`created_at`	Yes	`integer`
`share_id`	No	Any of Variant 1 `string` Variant 2 `null`
`archived`	Yes	`boolean`
`pinned`	No	default `false` Any of Variant 1 `boolean` Variant 2 `null`
`meta`	No	`object` default `{}` Additional fields are allowed.
`variables`	No	`object` default `{}` Additional fields are allowed.
`folder_id`	No	Any of Variant 1 `string` Variant 2 `null`
`tasks`	No	Any of Variant 1 `array` Array items Variant 2 `null`
`summary`	No	Any of Variant 1 `string` Variant 2 `null`
`current_message_id`	No	Any of Variant 1 `string` Variant 2 `null`
`context_usage`	No	Any of Variant 1 `object` Additional fields are allowed. Variant 2 `null`

ChatTitleIdResponse

object

Field	Required	Structure and constraints
`id`	Yes	`string`
`title`	Yes	`string`
`updated_at`	Yes	`integer`
`created_at`	Yes	`integer`
`last_read_at`	No	Any of Variant 1 `integer` Variant 2 `null`
`snippet`	No	Any of Variant 1 `string` Variant 2 `null`
`active`	No	`boolean` default `false`
`archived`	No	`boolean` default `false`

ChatTool

object

Field Required Structure and constraints

type

Yes

string

const: "function"

function

Yes

object

Field	Required	Structure and constraints
`name`	Yes	`string`
`description`	No	`string`
`parameters`	No	`object` JSON Schema degli argomenti dello strumento eseguito dal client. Additional fields are allowed.
`strict`	No	`boolean`

ChatUsageStatsListResponse

object

Field	Required	Structure and constraints
`items`	Yes	`array` Array items ChatUsageStatsResponse
`total`	Yes	`integer`

Additional fields are allowed.

ChatUsageStatsResponse

object

Field	Required	Structure and constraints
`id`	Yes	`string`
`models`	No	`object` default `{}` Additional fields are allowed.
`message_count`	Yes	`integer`
`history_models`	No	`object` default `{}` Additional fields are allowed.
`history_message_count`	Yes	`integer`
`history_user_message_count`	Yes	`integer`
`history_assistant_message_count`	Yes	`integer`
`average_response_time`	Yes	`number`
`average_user_message_content_length`	Yes	`number`
`average_assistant_message_content_length`	Yes	`number`
`tags`	No	`array` default `[]` Array items `string`
`last_message_at`	Yes	`integer`
`updated_at`	Yes	`integer`
`created_at`	Yes	`integer`

Additional fields are allowed.

CompactChatForm

object

Field	Required	Structure and constraints
`model`	No	Any of Variant 1 `string` Variant 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.

Exactly one of

Variant 1

object

Field	Required	Structure and constraints
`type`	Yes	`string` enum `["text","input_text","output_text"]`
`text`	Yes	`string`

Variant 2

object

Field Required Structure and constraints

type

Yes

string

const: "image_url"

image_url

Yes

object

Field	Required	Structure and constraints
`url`	Yes	`string` URL immagine o data URI. I byte immagine non passano dal filtro PII.
`detail`	No	`string` enum `["auto","low","high"]`

Variant 3

object

Usare image_url oppure file_id Netter.

Field	Required	Structure and constraints
`type`	Yes	`string` const `"input_image"`
`image_url`	No	`string`
`file_id`	No	`string`
`detail`	No	`string` enum `["auto","low","high"]`

Variant 4

object

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

Field Required Structure and constraints

type

Yes

string

enum: ["input_file","document"]

file_id

string

file_data

string

filename

string

source

object

Field	Required	Structure and constraints
`type`	No	`string`
`data`	No	`string`
`media_type`	No	`string`

Variant 5

object

Field Required Structure and constraints

type

Yes

string

const: "input_audio"

input_audio

Yes

object

Field	Required	Structure and constraints
`data`	Yes	`string` contentEncoding `"base64"`
`format`	Yes	`string`

Variant 6

object

Field Required Structure and constraints

type

Yes

string

const: "image"

source

Yes

object

Field	Required	Structure and constraints
`type`	Yes	`string` enum `["base64","url"]`
`media_type`	No	`string`
`data`	No	`string`
`url`	No	`string`
`file_id`	No	`string`

Variant 7

object

Field	Required	Structure and constraints
`type`	Yes	`string` const `"tool_use"`
`id`	Yes	`string`
`name`	Yes	`string`
`input`	Yes	JSONValue

Variant 8

object

Field	Required	Structure and constraints
`type`	Yes	`string` const `"tool_result"`
`tool_use_id`	Yes	`string`
`content`	Yes	Any of Variant 1 `string` Variant 2 `array` Array items ContentPart
`is_error`	No	`boolean`

Variant 9

object

Field	Required	Structure and constraints
`type`	Yes	`string` const `"thinking"`
`thinking`	Yes	`string`
`signature`	No	`string`

Variant 10

object

Field	Required	Structure and constraints
`type`	Yes	`string` const `"redacted_thinking"`
`data`	Yes	`string`

EventForm

object

Field	Required	Structure and constraints
`type`	Yes	`string`
`data`	Yes	`object` Additional fields are allowed.

FileListResponse

object

Field	Required	Structure and constraints
`items`	Yes	`array` Array items FileModelResponse
`total`	Yes	`integer`

FileMeta

object

Field	Required	Structure and constraints
`name`	No	Any of Variant 1 `string` Variant 2 `null`
`content_type`	No	Any of Variant 1 `string` Variant 2 `null`
`size`	No	Any of Variant 1 `integer` Variant 2 `null`

Additional fields are allowed.

FileModel

object

Field	Required	Structure and constraints
`id`	Yes	`string`
`user_id`	Yes	`string`
`hash`	No	Any of Variant 1 `string` Variant 2 `null`
`filename`	Yes	`string`
`path`	No	Any of Variant 1 `string` Variant 2 `null`
`data`	No	Any of Variant 1 `object` Additional fields are allowed. Variant 2 `null`
`meta`	No	Any of Variant 1 `object` Additional fields are allowed. Variant 2 `null`
`created_at`	Yes	Any of Variant 1 `integer` Variant 2 `null`
`updated_at`	Yes	Any of Variant 1 `integer` Variant 2 `null`

FileModelResponse

object

Field	Required	Structure and constraints
`id`	Yes	`string`
`user_id`	Yes	`string`
`hash`	No	Any of Variant 1 `string` Variant 2 `null`
`filename`	Yes	`string`
`data`	No	Any of Variant 1 `object` Additional fields are allowed. Variant 2 `null`
`meta`	No	Any of Variant 1 FileMeta Variant 2 `null`
`created_at`	Yes	`integer`
`updated_at`	No	Any of Variant 1 `integer` Variant 2 `null`

Additional fields are allowed.

FileRenameForm

object

Field	Required	Structure and constraints
`filename`	Yes	`string`

FolderAccessGrantsForm

object

Field	Required	Structure and constraints
`access_grants`	Yes	`array` Array items `object` Additional fields are allowed.
`share_mode`	No	Any of Variant 1 `string` const `"continue"` Variant 2 `null`

FolderForm

object

Field	Required	Structure and constraints
`name`	Yes	`string`
`data`	No	Any of Variant 1 `object` Additional fields are allowed. Variant 2 `null`
`meta`	No	Any of Variant 1 `object` Additional fields are allowed. Variant 2 `null`
`parent_id`	No	Any of Variant 1 `string` Variant 2 `null`

Additional fields are rejected.

FolderIsExpandedForm

object

Field	Required	Structure and constraints
`is_expanded`	Yes	`boolean`

FolderMetadataResponse

object

Field	Required	Structure and constraints
`icon`	No	Any of Variant 1 `string` Variant 2 `null`

FolderModel

object

Field	Required	Structure and constraints
`id`	Yes	`string`
`parent_id`	No	Any of Variant 1 `string` Variant 2 `null`
`user_id`	Yes	`string`
`name`	Yes	`string`
`items`	No	Any of Variant 1 `object` Additional fields are allowed. Variant 2 `null`
`meta`	No	Any of Variant 1 `object` Additional fields are allowed. Variant 2 `null`
`data`	No	Any of Variant 1 `object` Additional fields are allowed. Variant 2 `null`
`is_expanded`	No	`boolean` default `false`
`created_at`	Yes	`integer`
`updated_at`	Yes	`integer`

FolderNameIdResponse

object

Field	Required	Structure and constraints
`id`	Yes	`string`
`name`	Yes	`string`
`meta`	No	Any of Variant 1 FolderMetadataResponse Variant 2 `null`
`parent_id`	No	Any of Variant 1 `string` Variant 2 `null`
`is_expanded`	No	`boolean` default `false`
`unread_count`	No	`integer` default `0`
`created_at`	Yes	`integer`
`updated_at`	Yes	`integer`

FolderParentIdForm

object

Field	Required	Structure and constraints
`parent_id`	No	Any of Variant 1 `string` Variant 2 `null`

FolderResponse

object

Field	Required	Structure and constraints
`id`	Yes	`string`
`parent_id`	No	Any of Variant 1 `string` Variant 2 `null`
`user_id`	Yes	`string`
`name`	Yes	`string`
`items`	No	Any of Variant 1 `object` Additional fields are allowed. Variant 2 `null`
`meta`	No	Any of Variant 1 `object` Additional fields are allowed. Variant 2 `null`
`data`	No	Any of Variant 1 `object` Additional fields are allowed. Variant 2 `null`
`is_expanded`	No	`boolean` default `false`
`created_at`	Yes	`integer`
`updated_at`	Yes	`integer`
`access_grants`	No	`array` default `[]` Array items `object` Additional fields are allowed.
`write_access`	No	`boolean` default `false`

FolderUpdateForm

object

Field	Required	Structure and constraints
`name`	No	Any of Variant 1 `string` Variant 2 `null`
`data`	No	Any of Variant 1 `object` Additional fields are allowed. Variant 2 `null`
`meta`	No	Any of Variant 1 `object` Additional fields are allowed. Variant 2 `null`

Additional fields are rejected.

ForkForm

object

Field	Required	Structure and constraints
`message_id`	No	Any of Variant 1 `string` Variant 2 `null`

FunctionCall

object

Field	Required	Structure and constraints
`name`	Yes	`string`
`arguments`	Yes	`string` Argomenti serializzati come stringa JSON.

GatewayChatResponse

object

Field Required Structure and constraints

id

Yes

string

object

Yes

string

const: "chat.completion"

created

integer

model

Yes

choices

Yes

array

Array items

object

Field	Required	Structure and constraints
`index`	Yes	`integer`
`message`	Yes	ChatMessage
`finish_reason`	No	Any of Variant 1 `string` Variant 2 `null`

usage

Usage

Additional fields are allowed.

HTTPValidationError

object

Field	Required	Structure and constraints
`detail`	No	`array` Array items 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

Field	Required	Structure and constraints
`id`	Yes	`string`
`title`	Yes	`string`
`chat`	Yes	ChatDocument
`revision`	Yes	`integer` minimum `0`

MCPChatList

object

Field Required Structure and constraints

items

Yes

array

Array items

object

Field	Required	Structure and constraints
`id`	Yes	`string`
`title`	Yes	`string`
`updated_at`	Yes	`integer` Unix timestamp in secondi.

next_offset

Yes

Any of

Variant 1

integer

minimum: 0

Variant 2

null

MCPContinueResult

Any of

Variant 1

object

Field	Required	Structure and constraints
`chat_id`	Yes	`string`
`revision`	Yes	`integer`
`content`	Yes	`string`
`saved`	Yes	`boolean` const `true`

Variant 2

object

Field	Required	Structure and constraints
`chat_id`	Yes	`string`
`content`	Yes	`string`
`saved`	Yes	`boolean` const `false`
`reason`	Yes	`string` enum `["conversation_deleted","parent_deleted"]`

Variant 3

object

Field	Required	Structure and constraints
`error`	Yes	`string`
`chat_id`	Yes	`string`

MCPMethodError

object

Field Required Structure and constraints

jsonrpc

Yes

string

const: "2.0"

id

Yes

Any of

Variant 1

string

Variant 2

integer

error

Yes

object

Field	Required	Structure and constraints
`code`	Yes	`integer` const `-32601`
`message`	Yes	`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.

Exactly one of

Variant 1

object

Field Required Structure and constraints

method

Yes

string

const: "tools/call"

params

Yes

Exactly one of

Variant 1

object

Field	Required	Structure and constraints
`name`	Yes	`string` const `"chat_list"`
`arguments`	Yes	chat_listArguments

Variant 2

object

Field	Required	Structure and constraints
`name`	Yes	`string` const `"chat_search"`
`arguments`	Yes	chat_searchArguments

Variant 3

object

Field	Required	Structure and constraints
`name`	Yes	`string` const `"chat_get"`
`arguments`	Yes	chat_getArguments

Variant 4

object

Field	Required	Structure and constraints
`name`	Yes	`string` const `"chat_create"`
`arguments`	Yes	chat_createArguments

Variant 5

object

Field	Required	Structure and constraints
`name`	Yes	`string` const `"chat_append"`
`arguments`	Yes	chat_appendArguments

Variant 6

object

Field	Required	Structure and constraints
`name`	Yes	`string` const `"chat_continue"`
`arguments`	Yes	chat_continueArguments

Variant 2

object

Field	Required	Structure and constraints
`method`	Yes	`string` enum `["initialize","ping","tools/list"]`

Field Required Structure and constraints

jsonrpc

string

const: "2.0"

id

Any of

Variant 1

Any of

Variant 1

string

Variant 2

integer

Variant 2

null

method

Yes

string

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

params

Any of

Variant 1

object

Field Required Structure and constraints

protocolVersion

string

capabilities

clientInfo

object

Field	Required	Structure and constraints
`name`	Yes	`string`
`version`	Yes	`string`

Variant 2

Exactly one of

Variant 1

object

Field	Required	Structure and constraints
`name`	Yes	`string` const `"chat_list"`
`arguments`	Yes	chat_listArguments

Variant 2

object

Field	Required	Structure and constraints
`name`	Yes	`string` const `"chat_search"`
`arguments`	Yes	chat_searchArguments

Variant 3

object

Field	Required	Structure and constraints
`name`	Yes	`string` const `"chat_get"`
`arguments`	Yes	chat_getArguments

Variant 4

object

Field	Required	Structure and constraints
`name`	Yes	`string` const `"chat_create"`
`arguments`	Yes	chat_createArguments

Variant 5

object

Field	Required	Structure and constraints
`name`	Yes	`string` const `"chat_append"`
`arguments`	Yes	chat_appendArguments

Variant 6

object

Field	Required	Structure and constraints
`name`	Yes	`string` const `"chat_continue"`
`arguments`	Yes	chat_continueArguments

MCPResult

object

Field Required Structure and constraints

jsonrpc

Yes

string

const: "2.0"

id

Yes

Any of

Variant 1

string

Variant 2

integer

result

Yes

Any of

Variant 1

object

Field Required Structure and constraints

protocolVersion

Yes

string

capabilities

Yes

object

Field Required Structure and constraints

tools

Yes

object

Field	Required	Structure and constraints
`listChanged`	Yes	`boolean` const `false`

serverInfo

Yes

object

Field	Required	Structure and constraints
`name`	Yes	`string` const `"netter-openwebui"`
`version`	Yes	`string` const `"1.0.0"`

Variant 2

object

Field Required Structure and constraints

tools

Yes

array

Array items

object

Field	Required	Structure and constraints
`name`	Yes	`string`
`description`	Yes	`string`
`inputSchema`	Yes	JSONValue
`annotations`	Yes	JSONValue

Variant 3

object

Field Required Structure and constraints

content

Yes

array

Array items

object

Field	Required	Structure and constraints
`type`	Yes	`string` const `"text"`
`text`	Yes	`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

Yes

boolean

Variant 4

object

Field	Required	Structure and constraints

Additional fields are rejected.

MessagesResponse

object

Field	Required	Structure and constraints
`id`	Yes	`string`
`type`	Yes	`string` const `"message"`
`role`	Yes	`string` const `"assistant"`
`content`	Yes	`array` Array items ContentPart
`model`	Yes	Profile
`stop_reason`	No	Any of Variant 1 `string` Variant 2 `null`
`stop_sequence`	No	Any of Variant 1 `string` Variant 2 `null`
`usage`	Yes	Usage

Additional fields are allowed.

MessagesStreamEvent

object

Field Required Structure and constraints

type

Yes

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

Field	Required	Structure and constraints
`type`	No	`string`
`text`	No	`string`
`partial_json`	No	`string`
`thinking`	No	`string`
`signature`	No	`string`
`stop_reason`	No	Any of Variant 1 `string` Variant 2 `null`
`stop_sequence`	No	Any of Variant 1 `string` Variant 2 `null`

Additional fields are allowed.

usage

Usage

error

Additional fields are allowed.

Model

object

Field Required Structure and constraints

id

Yes

display_name

Yes

string

object

Yes

string

const: "model"

type

Yes

string

const: "model"

created

Yes

integer

Unix timestamp in secondi.

created_at

Yes

string

format: "date-time"

owned_by

Yes

string

const: "openai"

operations

Yes

array

Array items

string

name

string

urlIdx

integer

info

object

Field Required Structure and constraints

meta

Yes

object

Field	Required	Structure and constraints
`capabilities`	Yes	`object` Additional field values `boolean`

params

Yes

object

Field	Required	Structure and constraints
`function_calling`	Yes	`string` const `"legacy"`

ModelList

object

Field	Required	Structure and constraints
`object`	Yes	`string` const `"list"`
`data`	Yes	`array` Array items Model
`has_more`	Yes	`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.

Field Required Structure and constraints

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

Yes

array

Array items

ChatMessage

max_tokens

integer

minimum: 1

max_completion_tokens

integer

minimum: 1

tools

array

Array items

ChatTool

tool_choice

Any of

Variant 1

string

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

Variant 2

object

Field Required Structure and constraints

type

Yes

string

const: "function"

function

Yes

object

Field	Required	Structure and constraints
`name`	Yes	`string`

parallel_tool_calls

boolean

response_format

object

Field Required Structure and constraints

type

Yes

string

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

json_schema

object

Field	Required	Structure and constraints
`name`	Yes	`string`
`description`	No	`string`
`schema`	Yes	`object` JSON Schema del risultato strutturato. Additional fields are allowed.
`strict`	No	`boolean`

stop

Any of

Variant 1

string

Variant 2

array

Array items

string

stream_options

object

Field	Required	Structure and constraints
`include_usage`	No	`boolean`

chat_id

string

id

string

message_ids

Any of

Variant 1

object

Additional field values

string

Variant 2

array

Array items

object

Field	Required	Structure and constraints
`message_id`	Yes	`string`

features

object

Field	Required	Structure and constraints
`web_search`	No	`boolean`
`code_interpreter`	No	`boolean`

params

object

Additional field values