Schedules

Validate Schedule

Dry-run a schedule request.

Same checks as POST /v1/pins/validate plus run_at. Nothing is stored.

post/v1/schedules/validate

Request

  • Base URL: https://api.pinbridge.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.pinbridge.io/v1/schedules/validate
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Headers

x-api-keystring nullable
authorizationstring nullable

Request body

account_idstring uuid required

Pinterest account ID to publish with

run_atstring date-time required

When to publish this pin (ISO 8601 timestamp)

board_idstring required

Pinterest board ID

titlestring required

Pin title

descriptionstring nullable

Pin description

cover_image_urlstring uri nullable

Optional public cover image URL for scheduled video pins

cover_image_asset_idstring uuid nullable

Optional uploaded image asset ID used as a video cover image

link_urlstring uri nullable

Destination URL for the pin

image_urlstring uri nullable

Public URL of the image to pin

asset_idstring uuid nullable

Uploaded PinBridge asset ID to use for the scheduled image or video

Response

Validation outcome; nothing is written.

validboolean required

True when no check failed; nothing was written

dry_runtrue
resolvedobject nullable

The payload PinBridge would publish after resolving assets and boards

existing_pin_idstring uuid nullable

Set when the idempotency key already matches a pin in this workspace

headroomobject nullable

Current PinBridge quota and Pinterest rate headroom

Changes

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