---
title: "Set Default Chat Transport"
method: PUT
path: "/api/chat/transports/default"
tags: ["v2", "chat", "chat"]
---

# Set Default Chat Transport

`PUT /api/chat/transports/default`

Save the connection every new chat starts on.

Applies to chats nobody routed explicitly — a fresh session in the web
app, and every conversation that arrives without a request to read a route
from: bot links, schedules, briefings, dream passes. It does not touch a
conversation that already exists; sessions keep the route they were
created with.

## Request body

- SetDefaultTransportRequest — The connection new chats should start on. ``auth_provider: null`` clears the choice and hands the decision back to the server. A user-backed provider requires naming the credential, so the default keeps pointing at one account rather than whichever account exists.
  - `auth_provider` 'platform' | 'codex' | 'microsoft_365_copilot', nullable
  - `credential_id` string, nullable

## Response `200`

Successful Response

- ChatTransportsResponse
  - `transports` ChatTransportResponse[], required
    - `auth_provider` 'platform' | 'codex' | 'microsoft_365_copilot', required
    - `credential_id` string, nullable, required
    - `label` string, required
    - `available` boolean, required
    - `default` boolean, required

## Other responses

- `401` — Authentication required
- `404` — The credential or user profile was not found
- `422` — Validation Error

## Changes

- **2026-09-12** `95db58ee8138` — 1 warning, 1 info
  - added the new `microsoft_365_copilot` enum value to the `transports/items/auth_provider` response property for the response status `200`
  - added the new `microsoft_365_copilot` enum value to the request property `auth_provider/anyOf[subschema #1]/`
- **2026-09-02** `f78ea958d870` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/changes/api/chat/transports/default/put.md)

---

[API](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/revisions/a8f415ca28ec?raw)