---
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. Sending ``codex`` requires naming the credential, so the default keeps pointing at one account rather than "whichever ChatGPT".
  - `auth_provider` 'platform' | 'codex', nullable
  - `credential_id` string, nullable

## Response `200`

Successful Response

- ChatTransportsResponse
  - `transports` ChatTransportResponse[], required
    - `auth_provider` 'platform' | 'codex', 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-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-service-production.skmtc.workers.dev/v1/apis/significant-gravitas/autogpt-agent-server/revisions/dc8f009814db/schema)