POpostproxy
Placements

Set active profile

Switches which connected profile serves the placement — posting and webhook traffic route through it from then on. The profile must be listed in the placement's linked_profiles and be connected. Switching an orphaned placement to a connected profile also fires the placement.restored webhook. Requires an account-wide API key; a group-scoped key returns 422.

patch/api/placements/{id}/set_active_profile

Request

  • Base URL
    https://api.postproxy.dev
  • URL
    https://api.postproxy.dev/api/placements/{id}/set_active_profile
  • Auth
    HTTP bearer

Path parameters

idstring required

Placement ID (the id from List placements, not the platform ID)

Headers

Idempotency-Keystring

Optional idempotency key (up to 255 characters; a UUID is ideal). Retrying a successful write with the same key replays the original response (with an Idempotent-Replay: true header) instead of executing again. Stored responses are kept for 24 hours; only 2xx responses are stored.

Request body

profile_idstring required

Profile to make active. Must be listed in the placement's linked_profiles and be connected.

Response

The updated placement

idstring

Placement ID. Postproxy's own ID, used in placement URLs — not the platform ID.

platform'facebook' | 'linkedin' | 'pinterest' | 'telegram' | 'google_business'

Platform the placement belongs to.

external_idstring

Platform-specific ID — the value used as page_id / chat_id when creating posts, and returned as id by the per-profile List placements endpoint.

namestring

Placement name.

avatar_urlstring nullable

Stable Postproxy storage URL of the placement's picture, resized to 256x256 (Facebook Pages). null until it has been mirrored and for networks without one.

status'active' | 'orphaned' | 'removed'

active (the active profile is connected), orphaned (the active profile is disconnected — posting is paused until you switch to a connected profile), or removed (access was revoked on the platform).

Changes

No recorded changes to this operation across all 1 revision of this API.