Postiz

Generate image to use in a post, in case the user specified a platform that requires attachment and attachment was not provided, ask if they want to generate a picture of a video.

generateImageTool

Generate video to use in a post, in case the user specified a platform that requires attachment and attachment was not provided, ask if they want to generate a picture of a video. In many cases 'videoFunctionTool' will need to be called first, to get things like voice id Generating takes a few minutes, so this only starts the generation and returns a jobId: poll 'videoStatusTool' with it until the status is "completed" to get the video url. Here are the type of video that can be generated: -Image Text Slides -Seedance 2.0 (Audio + Video)

generateVideoTool

Everytime we want to schedule a social media post, we need to understand the schema of the integration. This tool helps us get the schema of the integration. Sometimes we might get a schema back the requires some id, for that, you can get information from 'tools' And use the triggerTool function.

integrationSchema

This tool lists the available groups (customers). Use a group id with the integrationList tool to filter the integrations belonging to that group

groupList

This tool list available integrations to schedule posts to. Optionally pass a group id (from the groupList tool) to only list integrations belonging to that group

integrationList

List the organization's posts scheduled to be published between two dates (the same data as the "List Posts" API endpoint). Returns every post in the window whatever its state (scheduled, draft, published, errored). "startDate" and "endDate" are required (UTC) - to list all upcoming posts, pass a wide window (for example from now to a year ahead). Each item has an "id", its publish date, state, content, channel and current provider settings. Posts cannot be deleted through the Postiz tools - if the user wants to delete a post, tell them to do it themselves in the Postiz app; never offer to delete a post.

postsListTool

All the options to generate videos, some tools might require another call to generateVideoFunction

generateVideoOptions

Use this when the user wants to create a draft, scheduled, or immediate social media post on their connected channels, based on the integrationSchema tool. Examples of the input shape: A single LinkedIn post with one comment - socialPost array length will be one - postsAndComments array length will be two (one for the post, one for the comment) 20 Facebook posts each on individual days without comments - socialPost array length will be 20 - postsAndComments array length will be one Do not use this to update or delete existing posts. If validation fails, the result contains output.errors describing what to fix; the call can be retried with corrected parameters.

integrationSchedulePostTool

Use this to call a provider helper function (a methodName from the integrationSchema callable tools) that fetches provider-specific data needed for settings, like ids or search results. Some helper functions require values provided by the user, like a word to search for. methodName is required [input:callable-tools]. If provider auth is expired, this tool may refresh the stored integration token; if refresh fails, it marks the channel as needing reconnect and notifies the organization.

triggerTool

Update the provider settings of an existing post (scheduled or draft) that was NOT published yet. Only the settings change - the content and the publish date stay exactly as they are. Find the post first (list your posts) and pass its "id" here. The settings are merged into the existing ones, so only pass the keys you want to change; anything you don't pass stays as it is. This relies on the integrationSchema tool [input:settings] to know which keys exist for the platform. If validation fails, the result contains output.errors describing what to fix; the call can be retried with corrected parameters.

postSettingsTool