---
title: "List a post's plugs"
method: GET
path: "/posts/{id}/plugs"
tags: ["Posts"]
---

# List a post's plugs

`GET /posts/{id}/plugs`

## Request

- Base URL: `https://www.sociahive.com/api/v1`
- URL: `https://www.sociahive.com/api/v1/posts/{id}/plugs`
- Auth: one of:
  - API key in header `X-API-Key`
  - OAuth 2 (authorization code, authorization URL `/api/oauth/authorize`, token URL `/api/oauth/token`, scopes: `posts:read`)

The plugs on the post and the targets that can carry one, with each platform's metrics and actions.

## Path parameters

- `id` string, required: MongoDB ObjectId (24-character hex string)

## Response `200`

Plugs

- object
  - `success` true, required
  - `data` PostPlugs, required
    - `plugs` Plug[], required
      - `id` string, required: MongoDB ObjectId (24-character hex string)
      - `post_id` string, required: MongoDB ObjectId (24-character hex string)
      - `account_id` string, required: The connected account (post target) the plug watches.
      - `trigger` object, required
        - `metric` 'likes' | 'comments' | 'reposts' | 'views', required
        - `threshold` integer, required
      - `action` object, required
        - `kind` 'repost' | 'comment', required
        - `text` string
      - `state` 'armed' | 'fired' | 'expired' | 'failed', required: armed: watching (or firing). fired: the action ran once. expired: the window ended, or the post was deleted. failed: see error.
      - `last_value` integer: Last value read from the platform.
      - `last_checked_at` string, date-time
      - `fired_at` string, date-time
      - `expires_at` string, date-time, required
      - `error` object: Why the plug failed or ended, or a read problem while it keeps watching. AMBIGUOUS_MAY_HAVE_POSTED: check the platform before arming again.
        - `code` string, required
        - `message` string, required
      - `created_at` string, date-time, required
    - `targets` PlugTarget[], required: Targets of the post that can carry a plug (X, Instagram, Facebook, LinkedIn company pages).
      - `account_id` string, required: MongoDB ObjectId (24-character hex string)
      - `platform` 'twitter' | 'instagram' | 'facebook', required
      - `metrics` string[], required
      - `actions` string[], required
      - `max_comment_length` integer, required
      - `published` boolean, required
    - `limits` object, required
      - `per_target` integer, required
      - `armed_per_user` integer, required

## Other responses

- `400`: Bad request — invalid parameters
- `401`: Authentication required — provide X-API-Key or Bearer token
- `403`: Insufficient scope for this operation
- `404`: Post not found
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/sociahive/apis/sociahive-api.md) · [All operations](https://skmtc.dev/sociahive/apis/sociahive-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sociahive/apis/sociahive-api/revisions/791b8548d288?raw)