---
title: "Move an account to another profile"
method: PATCH
path: "/accounts/{id}"
tags: ["Accounts"]
---

# Move an account to another profile

`PATCH /accounts/{id}`

## Request

- Base URL: `https://api.rizamo.com/v1`
- URL: `https://api.rizamo.com/v1/accounts/{id}`
- Auth: HTTP bearer

Moves the account to another profile you reach: from then on it is that profile's, for the people, keys and agents who reach it, and its old profile's stop seeing it. Events already written stay in the profile they happened in.

## Path parameters

- `id` string, required: The account's id (`acc_`).

## Request body

- object
  - `profileId` string, required: The profile (`prof_`) it moves to.

## Response `200`

OK

- Account
  - `id` string, required
  - `profileId` string, required
  - `network` 'instagram' | 'facebook' | 'threads' | 'linkedin' | 'tiktok' | 'youtube' | 'x' | 'pinterest' | 'google', required
  - `handle` string, required
  - `name` string, required
  - `status` 'connected' | 'expiring' | 'disconnected', required: connected: works. expiring: reconnect before `reconnectBy`. disconnected: the network revoked access; reconnect to publish again.
  - `billing` 'active' | 'awaiting_payment' | 'paused', required: active: covered by the plan. awaiting_payment: connected, and live once its payment succeeds (a team's third account starts a paid plan; on a paid plan, added accounts are charged when they connect; those a connect link adds beyond the owner's cap wait for an owner to pay). paused: the team's payment failed for 14 days or its paid plan ended, so only 2 accounts stay active; nothing is deleted. Accounts that are not active do not publish or send messages. Rizamo reads no posts, numbers or comments of an account awaiting payment, and reads a paused one for 30 days.
  - `followers` integer, required
  - `avatarUrl` string, nullable, required: Its picture. On Facebook, Instagram, Threads, TikTok and LinkedIn, whose own links expire, a small copy Rizamo keeps, on Rizamo's media host: the link works for a few hours, so get the account again for a fresh one. The network's own link elsewhere, and until the copy is made. Null when the network gives none, or its link expired with no copy.
  - `connectionId` string, required: The login this account came through. One login can bring several accounts, and one reconnect fixes them all.
  - `reconnectBy` string, date-time, nullable, required: When the network will end access unless someone logs in again (TikTok: a year after the first login; LinkedIn: 60 days after each login; Threads: 90 days after the login, moved on while Rizamo refreshes a public profile's token).
  - `capabilities` Capability[], required: What this account can do, from its login, your role on the network and the account's level. The API refuses the rest with `capability_missing`.
  - `formats` PostFormat[], required: The formats this account can publish.

## Other responses

- `400`: `invalid_request`: A field is missing or wrong, or the request cannot be done as asked: the message names the field or says what to change.
- `401`: `unauthorized`: No API key or sign-in, or the key does not work: it was deleted, or it expired.
- `403`: `forbidden`: The caller may not do this: the key or agent lacks the scope (the message names it), or the action needs another role or a fresh sign-in.
- `404`: `not_found`: No such object, or it is outside your team or the profiles your key reaches.
- `409`: `conflict`: The object's state does not allow it now, such as an account that needs a new login. `queue_empty`: A post with `queue: true` whose profile has no posting times: set them, or give a `scheduledAt`. `queue_full`: No posting time free for the post's accounts in the next 90 days: add times, or give a `scheduledAt`. `idempotency_key_in_use`: A request with this `Idempotency-Key` is still running: try again in a moment.
- `413`: `payload_too_large`: The body is over 1 MB: files go up through the upload links of `POST /v1/media`.
- `415`: `unsupported_media_type`: The body is not JSON: send it with `Content-Type: application/json`.
- `429`: `rate_limited`: Over one of Rizamo's limits, or a network asked Rizamo to slow down: wait for `Retry-After` seconds, or as long as the message says.
- `500`: `internal`: Our side failed: retry, and send the `requestId` if it keeps failing.
- `503`: `timeout`: The request took too long to work out, most often a report: try again in a moment, or ask a report for a shorter period or one profile.

---

[API](https://skmtc.dev/rizamo/apis/rizamo-api.md) - [All operations](https://skmtc.dev/rizamo/apis/rizamo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rizamo/apis/rizamo-api/revisions/31b0c1b1ffb5?raw)
