---
title: "List destinations"
method: POST
path: "/list_destinations"
tags: ["Read"]
---

# List destinations

`POST /list_destinations`

## Request

- Base URL: `https://pdb.postpen.ai/functions/v1/agent-api`
- URL: `https://pdb.postpen.ai/functions/v1/agent-api/list_destinations`
- Auth: HTTP bearer

Lists the destinations this account may post to. Each has an id, a network (linkedin today; more networks later), a type, and a name: the LinkedIn personal profile (id "personal") and each connected company page allowed by the plan. The ids are the values the destination parameter of the other tools accepts. Never returns LinkedIn tokens.

## Request body

- object

## Response `200`

Success. JSON object; never contains LinkedIn tokens.

- object

## Other responses

- `400`: Invalid input, or a confirm: true guard was not met.
- `401`: Missing or invalid API key.
- `402`: Plan limit reached (for example the Free plan's monthly post cap).
- `403`: Destination not allowed for this account or plan.

---

[API](https://skmtc.dev/postpen/apis/postpen-agent-api.md) · [All operations](https://skmtc.dev/postpen/apis/postpen-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/postpen/apis/postpen-agent-api/revisions/2b07a2e1bfe7?raw)