Write

Schedule post

Schedules a saved draft, including any media already stored on it by save_draft. scheduled_for is an ISO-8601 timestamp in the future and must include a timezone. destination optionally selects the personal profile or a company page from list_destinations. Media is not accepted here.

post/schedule_post

Request

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

Request body

idstring required

Post id returned by save_draft.

scheduled_forstring required

Future ISO-8601 time with a timezone, for example 2026-09-28T15:00:00Z.

destinationstring

Where to post: an id from list_destinations. Each destination has a network (linkedin today). "personal" (the default on a personal draft) is the personal LinkedIn profile; a company page is identified by its id from list_destinations (usually the organization URN). On schedule_post and publish_now, leaving it out keeps a company destination already saved on the draft, and "personal" switches to the profile.

Response

Success. JSON object; never contains LinkedIn tokens.

object required

Changes

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