Obtener una cuenta

Una cuenta conectada, los ajustes que admite una publicación en ella y, en Pinterest, sus tableros.

GEThttps://antwork.io/api/v1/accounts/{id}Permisoread

Petición

curl https://antwork.io/api/v1/accounts/acc_pinterest \
  -H "Authorization: Bearer $ANTWORK_API_KEY"

La cuenta tal como la lista GET /api/v1/accounts, más settings, los campos por publicación que admite su plataforma. Requiere el permiso read.

Respuesta

200 OK

{
  "object": "account",
  "id": "acc_pinterest",
  "workspaceId": "ws_...",
  "platform": "pinterest",
  "name": "Antwork",
  "handle": "antwork",
  "accountType": "business",
  "active": true,
  "tokenHealth": "healthy",
  "connectedAt": "2026-01-05T09:00:00.000Z",
  "settings": [
    {
      "key": "pinTitle",
      "label": "Pin title",
      "type": "text",
      "maxLength": 100,
      "placeholder": "Optional"
    },
    {
      "key": "link",
      "label": "Destination link",
      "type": "url",
      "maxLength": 2048,
      "placeholder": "https://…"
    }
  ],
  "boards": [
    { "id": "1234567890", "name": "Product updates" }
  ]
}

En Pinterest, boards es la lista de tableros de la cuenta en este momento. Un pin va a un tablero, y de aquí sale su id. Si Pinterest rechaza la consulta, boards es null y boardsError dice por qué; reconnect: true significa que hay que volver a conectar la cuenta en Antwork.

Una cuenta que no existe o no es tuya responde 404 con account_not_found.