Get the current Pinterest account's basic info (username, id, account type). Safe read. Use to confirm the credentials point at the intended account before any write.

List the account's boards, paginated. Safe read. Use before creating a pin to find the board_id you want to pin to — the create-pin call needs it.

Fetch one board's details by id. Safe read.

List pins on the account, optionally scoped to a single board via board_id. Safe read.

Fetch one pin's details by id. Safe read.

Engagement metrics for one of our own pins (impressions, saves, pin clicks, outbound clicks, video views). Safe read. This is the native Etsy-driver measurement — outbound clicks on a pin whose link points at an Etsy listing are the traffic-lever signal.

Create a new Pinterest board on the account. Live, immediately visible on the profile if privacy=PUBLIC. Requires agent_id (must hold 'social') and task_id (task must be cleared for the with_nate brand — Done and carrying an approved output).

Publish a real, immediately-live pin to one of our boards. Requires agent_id (must hold 'social') and task_id (task must be cleared for the with_nate brand). No draft state — once this returns success, the pin is on the account. image_url must be a PUBLIC http(s) URL that Pinterest can fetch server-side; a local file path will NOT work. The 'link' field is the destination URL when someone clicks the pin (e.g. the Etsy listing URL) — put it there, not in the description, or click-through analytics count nothing.