---
title: "Refresh a connected account's provider profile metadata"
method: POST
path: "/accounts/{account_id}/refresh-metadata"
tags: ["Accounts"]
---

# Refresh a connected account's provider profile metadata

`POST /accounts/{account_id}/refresh-metadata`

## Request

- Base URL: `https://app.openpo.st/api/v1`
- URL: `https://app.openpo.st/api/v1/accounts/{account_id}/refresh-metadata`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `openpost_session`

## Path parameters

- `account_id` string, required: OpenPost account ID

## Response `200`

OK

- AccountResponse
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `account_avatar_url` string, required: Account avatar URL
  - `account_id` string, required: Platform-specific account ID
  - `account_kind` string: Normalized identity kind, such as person, organization, creator, or business
  - `account_username` string, required: Account username
  - `alias` string: Internal account label. Does not change the provider identity.
  - `capability_checked_at` string, date-time: When account-specific publishing limits were last verified
  - `fediverse_software` string: Detected Fediverse server software (mastodon, pixelfed, peertube, lemmy, piefed, or a compatible implementation)
  - `grant_destination_count` integer, required: Number of active destinations using this provider authorization
  - `id` string, required: Account ID
  - `instance_url` string, required: Instance URL (Mastodon/Bluesky)
  - `is_active` boolean, required: Whether the account is active
  - `limit_profile` 'standard' | 'x-premium': Account-specific publishing limit profile
  - `messages_enabled` boolean, required: Deprecated compatibility shim. Use GET /account-features for messaging enabled state.
  - `messaging_supported` boolean, required: Deprecated compatibility shim. Use GET /account-features for messaging availability and enabled state.
  - `platform` string, required: Platform name
  - `provider_installation_id` string: Operator connector installation used by this account
  - `shared_grant` boolean, required: Whether revoking this authorization disconnects other destinations
  - `slug` string, required: User-editable account slug for CLI selectors
  - `thread_replies_supported` boolean, required: Whether this account supports thread replies in current server config

## Other responses

- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Unprocessable Entity
- `500`: Internal Server Error
- `501`: Not Implemented
- `502`: Bad Gateway

---

[API](https://skmtc.dev/openpo/apis/openpost-api.md) · [All operations](https://skmtc.dev/openpo/apis/openpost-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openpo/apis/openpost-api/revisions/67d3964458a7?raw)