---
title: "Changes to Start a global AO Codex account switch"
method: POST
path: "/api/v1/agents/codex/account-switches"
---

# Changes to Start a global AO Codex account switch

`POST /api/v1/agents/codex/account-switches`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 168 revisions.

- **2026-09-15** `7f5cb1f3ca16` — 4 breaking, 9 info
- **2026-09-03** `d31a2d019c47` — 3 info
- **2026-09-03** `0989da474d24` — 1 info

## Changes

- **2026-09-15** `7f5cb1f3ca16` — 4 breaking, 9 info
  - the `expectedAccountRevision` request property type changed from `integer` to `null, integer`, and format from `int64` to no format
  - the response property `sourceAccountId` became optional for the status `202`
  - removed the required property `canRecover` from the response with the `202` status
  - removed the required property `sessions` from the response with the `202` status
  - the request property `expectedAccountRevision` became nullable
  - the request property `expectedAccountRevision` became optional
  - request property `expectedAccountRevision` deprecated
  - removed the `restarting_sessions` enum value from the `phase` response property for the response status `202`
  - removed the `rollback_required` enum value from the `phase` response property for the response status `202`
  - removed the `sessions_stopped` enum value from the `phase` response property for the response status `202`
  - removed the `stopping_sessions` enum value from the `phase` response property for the response status `202`
  - removed the `verifying_target` enum value from the `phase` response property for the response status `202`
  - added the required property `sourceKind` to the response with the `202` status
- **2026-09-03** `d31a2d019c47` — 3 info
  - added the optional property `reporting_owner` to the response with the `400` status
  - added the optional property `reporting_owner` to the response with the `409` status
  - added the optional property `reporting_owner` to the response with the `503` status
- **2026-09-03** `0989da474d24` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/docs/api/v1/agents/codex/account-switches/post.md) · [API](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon.md) · [Page](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/changes/api/v1/agents/codex/account-switches/post)
