Account lifecycle

Connected accounts do not stay connected forever. Chirio keeps them alive as long as the networks allow, but every platform eventually forces the user back through authorisation. This page is about noticing that before a publish fails.

Statuses

Status	Meaning	What to do
`active`	Usable for publishing	Nothing
`expired`	The token lapsed and could not be refreshed	Send the user through connect again
`revoked`	Disconnected — either by you calling `DELETE /accounts/:id`, or by the user removing Chirio in their platform settings	Send the user through connect again

Publishing to a non-active account fails that target with account_not_active. Other targets in the same request are unaffected.

How long a connection lasts

Platform	Lifetime	Refreshed automatically
Instagram	60 days	Yes
Threads	60 days	Yes
X	2 hours	Yes, at publish time
LinkedIn	60 days	Only where LinkedIn issues a refresh token

Refreshes happen without you doing anything. What you should plan for is the case where they run out: a LinkedIn connection typically needs re-authorising roughly every 60 days, because LinkedIn only issues refresh tokens to apps it has specifically approved for it.

Poll for expiry rather than waiting for a failure

GET /api/v1/accounts returns every account's status. Checking it on a schedule — or before a scheduled campaign — lets you prompt the user to reconnect at a convenient moment instead of discovering it when a launch post fails.

Reconnecting

Reconnecting is just running the connect flow again for the same platform. It replaces the stored credentials, and the account returns to active. The accountId survives. Chirio identifies an account by the platform profile behind it, not by the connection, so reconnecting the same profile — after an expiry, after a revocation, after you disconnected it yourself — reuses the same id. Ids you stored on your side keep working, and scheduled posts pointing at that account do not have to be rewritten. Beyond expiry and revocation, a reconnect is also what fixes an account whose authorisation predates a capability:

Instagram or Threads first comments — an older connection may not carry comment permission. The failure names this remedy explicitly in commentError.
Instagram or Threads metrics — insights permissions were added on 2026-08-10; a connection older than that reads likes and comments but reports the rest as null.
X media — an older connection may not be able to upload media, which surfaces as a media failure on an otherwise valid post.

Statuses

Status	Meaning	What to do
`active`	Usable for publishing	Nothing
`expired`	The token lapsed and could not be refreshed	Send the user through connect again
`revoked`	Disconnected — either by you calling `DELETE /accounts/:id`, or by the user removing Chirio in their platform settings	Send the user through connect again

Publishing to a non-active account fails that target with account_not_active. Other targets in the same request are unaffected.

How long a connection lasts

Platform	Lifetime	Refreshed automatically
Instagram	60 days	Yes
Threads	60 days	Yes
X	2 hours	Yes, at publish time
LinkedIn	60 days	Only where LinkedIn issues a refresh token

Poll for expiry rather than waiting for a failure

Reconnecting

Instagram or Threads first comments — an older connection may not carry comment permission. The failure names this remedy explicitly in commentError.
Instagram or Threads metrics — insights permissions were added on 2026-08-10; a connection older than that reads likes and comments but reports the rest as null.
X media — an older connection may not be able to upload media, which surfaces as a media failure on an otherwise valid post.

Statuses

How long a connection lasts

Reconnecting

Statuses

How long a connection lasts

Reconnecting

Designing for it