Postiz

Ask agent 'postiz' a question. Agent description: Agent that helps schedule and list social media posts for users

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.

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

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)

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

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

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.

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.

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.

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.

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.

Upload a remote image or video into the media library from a public URL. Use this before scheduling a post when the user provides an external media URL (not already hosted on our domain), so the attachment passes the upload-domain validation. Returns the hosted media { id, path } to use as an attachment, or { error } on failure.

Sometimes when we want to generate videos we might need to get some additional information like voice_id, etc

Check the status of a video generation started with 'generateVideoTool', using the jobId it returned. Generating a video takes a few minutes: while the status is "pending", wait about 30 seconds and call again. When the status is "completed" the result contains the hosted video url, which can be used as a post attachment. When the status is "failed" the result contains the error message.