postnitro_check_status
ChatGPTCheck the generation status and processing logs for a post. When AI image generation was requested (generateImages), a GENERATE_IMAGES step appears in the logs — status COMPLETED with a count, or FAILED with a skip reason (the overall post can still be COMPLETED, since images are best-effort).
postnitro_create_brand
ChatGPTCreate a new brand kit (the logo, name, and handle stamped onto generated carousels). All seven fields are required. The new brand's ID is returned — use it as a brandId in generate/import or save it via postnitro_set_defaults. Note: plans cap the number of brands; exceeding it returns an error.
postnitro_create_scheduled_post
ChatGPTCreate a scheduled post or draft for LinkedIn, Instagram, TikTok, Threads, Facebook (Pages), and/or Pinterest (boards). Workflow: 1. postnitro_list_social_accounts → pick account IDs for selectedAccounts 2. (optional) attach a designId — a carousel you created with PostNitro. Use the design's ID (the 'designId' field returned by postnitro_get_output / postnitro_generate_and_wait), NOT the generation embedPostId. 3. provide a caption via postContent and/or a designId (a post needs at least one) Rules enforced by the API (surfaced as error messages here): - scheduledAt must be a future ISO-8601 datetime. - A post must have either a designId or non-empty postContent. designId may be null only for DRAFT. - Per-platform *PostSettings are conditionally required based on the selected accounts' platforms and whether a designId is set (see each field's description). LinkedIn, Facebook, and Pinterest require a designId when SCHEDULED. - postSettings (video render settings) applies when any postType resolves to 'reel'. You may omit it: the API fills the duration and audio from the attached design's own settings, falling back to 30 seconds with no audio.
postnitro_delete_audio
ChatGPTPermanently delete an audio file from the workspace, including the stored file. This cannot be undone — confirm with the user first. An audio file still referenced by a scheduled post is refused (the reel would lose its soundtrack at publish time); remove it from those posts first. Videos already rendered to MP4 keep their audio, since the track is baked into the file.
postnitro_delete_scheduled_post
ChatGPTDelete a scheduled post (or draft) and all of its related content. This action cannot be undone.
postnitro_disconnect_social_account
ChatGPTDisconnect (delete) a connected social account. This also removes it from every scheduled post it was attached to. This action cannot be undone.
postnitro_generate_and_schedule
ChatGPTConvenience tool: generates a post with AI (postType 'CAROUSEL' by default, 'IMAGE' for a single-image post, or 'VIDEO' for a video), waits for it to finish, then creates a scheduled post that attaches the resulting design. May take 30-180 seconds (longer for a rendered video). templateId, brandId, presetId, and responseType are optional if saved via postnitro_set_defaults. The design that gets attached is the completed carousel's design ID (result.designId from the generation output) — NOT the generation job ID. You normally don't set designId; it's resolved automatically. Pass designId only to attach a pre-existing design instead of the freshly generated one. If scheduling fails after the carousel is already generated (e.g. an invalid platform-settings combination), this tool returns the generated designId so you can fix the inputs and retry with postnitro_create_scheduled_post — WITHOUT regenerating (which would burn credits again). Provide the scheduling fields (status, scheduledAt, selectedAccounts, captions, and any required per-platform settings) just as you would for postnitro_create_scheduled_post.
postnitro_generate_and_wait
ChatGPTConvenience tool: generates a carousel with AI, polls until completion, and returns the final output. May take 30-180 seconds. For a single-image post instead of a carousel, use postnitro_generate_image_and_wait. templateId, brandId, presetId, and responseType are optional if you've saved defaults via postnitro_set_defaults.
postnitro_generate_carousel
ChatGPTGenerate a carousel post using PostNitro's AI engine. Returns an embedPostId to track progress. For a single-image post instead of a carousel, use postnitro_generate_image. templateId, brandId, presetId, and responseType are optional if you've saved defaults via postnitro_set_defaults. Otherwise provide them here (use the list tools to find valid IDs). Use postnitro_check_status to monitor, then postnitro_get_output to retrieve. Or use postnitro_generate_and_wait for one step.
postnitro_generate_image
ChatGPTGenerate a single-image post (postType IMAGE) using PostNitro's AI engine. Returns an embedPostId to track progress. The content is AI-generated from your aiGeneration prompt — you do NOT provide slides. (To supply your own image content instead, use postnitro_import_image.) templateId, brandId, presetId, and responseType are optional if you've saved defaults via postnitro_set_defaults. Otherwise provide them here (use the list tools to find valid IDs). Use postnitro_check_status to monitor, then postnitro_get_output to retrieve. Or use postnitro_generate_image_and_wait for one step.
postnitro_generate_image_and_wait
ChatGPTConvenience tool: AI-generates a single-image post (postType IMAGE), polls until completion, and returns the final output. May take 30-180 seconds. The content is AI-generated from your aiGeneration prompt — you do NOT provide slides. (To supply your own image content instead, use postnitro_import_image_and_wait.) templateId, brandId, presetId, and responseType are optional if you've saved defaults via postnitro_set_defaults.
postnitro_generate_video
ChatGPTGenerate a video post (postType VIDEO) using PostNitro's AI engine. Returns an embedPostId to track progress. The content is AI-generated from your aiGeneration prompt — you do NOT provide slides. Each slide the AI writes becomes a scene in the video. (To supply your own scene content instead, use postnitro_import_video.) Output: 'DESIGN' (default) creates the design without rendering; 'MP4' renders the video file and requires videoSettings (duration, optional audio track). templateId, brandId, presetId, and responseType are optional if you've saved defaults via postnitro_set_defaults. Otherwise provide them here (use the list tools to find valid IDs). Use postnitro_check_status to monitor, then postnitro_get_output to retrieve. Or use postnitro_generate_video_and_wait for one step.
postnitro_generate_video_and_wait
ChatGPTConvenience tool: AI-generates a video post (postType VIDEO), polls until completion, and returns the final output. Rendering a video takes longer than a carousel — typically 15-45 seconds when responseType is 'MP4', and longer for designs with animations or GIFs (which use the enhanced renderer). The content is AI-generated from your aiGeneration prompt — you do NOT provide slides. (To supply your own scene content instead, use postnitro_import_video_and_wait.) Output: 'DESIGN' (default) creates the design without rendering; 'MP4' renders the video file and requires videoSettings. templateId, brandId, presetId, and responseType are optional if you've saved defaults via postnitro_set_defaults.
postnitro_get_brand
ChatGPTFetch a single brand kit by ID, including its display settings (showName, showHandle, showImage, isCompanyDetail).
postnitro_get_defaults
ChatGPTRetrieve your saved default templateId, brandId, presetId, and responseType. Returns null if no defaults are saved.
postnitro_get_import_template
ChatGPTReturns the exact slide structure and rules for the import tools. Call this BEFORE using postnitro_import_carousel, postnitro_import_and_wait, or the video import tools to understand the required format — video posts use this same slide array, one slide per scene.
postnitro_get_output
ChatGPTRetrieve the generated output for a completed post. Always returns the design's designId (the value to pass when scheduling — postnitro_create_scheduled_post / postnitro_generate_and_schedule) and an editorUrl deep link to open it in the editor. For PDF/PNG/MP4 output it also returns the rendered file(s) as public URLs (data, mimeType, outputType) — a single URL for PDF and MP4, one per page for PNG; for DESIGN output there is no rendered file, so those fields are omitted.
postnitro_get_post
ChatGPTRead a post made through the API by its embedPostId: its design in the shape the import tools take (slides, or one slide object for an IMAGE), with its brand. Use it to see what a post says before editing it. Free.
postnitro_get_scheduled_post
ChatGPTFetch a single scheduled post by ID, with its captions, selected social accounts, platform settings, attached design details, and publishing status.
postnitro_get_social_account
ChatGPTFetch a single connected social account by ID, including its scheduled-post usage broken down by status (PENDING, PUBLISHED, etc.) and token expiry.
postnitro_import_and_schedule
ChatGPTConvenience tool: creates a post from YOUR OWN content (import), waits for it to finish, then creates a scheduled post that attaches the resulting design. May take 15-60 seconds. Set postType to 'CAROUSEL' (default) or 'VIDEO' and provide a 'slides' ARRAY, or 'IMAGE' and provide a single 'slide' OBJECT — this mirrors postnitro_import_carousel / postnitro_import_video / postnitro_import_image. IMPORTANT: Call postnitro_get_import_template FIRST to see the exact slide structure and rules. templateId, brandId, and responseType are optional if saved via postnitro_set_defaults. The design attached is the imported design's ID (result.designId), resolved automatically. Pass designId only to attach a pre-existing design instead of the freshly imported one. If scheduling fails after the design was already created (e.g. an invalid platform-settings combination), this tool returns the created designId so you can fix the inputs and retry with postnitro_create_scheduled_post — WITHOUT re-importing. Provide the scheduling fields (status, scheduledAt, selectedAccounts, captions, and any required per-platform settings) just as you would for postnitro_create_scheduled_post.
postnitro_import_and_wait
ChatGPTConvenience tool: imports custom slide content, polls until completion, and returns the final output. May take 15-60 seconds. IMPORTANT: Call postnitro_get_import_template FIRST to see the exact slide structure and rules. templateId, brandId, and responseType are optional if you've saved defaults via postnitro_set_defaults. Strict rules: 1. First slide MUST be type "starting_slide" (exactly 1) 2. Middle slides MUST be type "body_slide" (at least 1) 3. Last slide MUST be type "ending_slide" (exactly 1) 4. Infographic columnCount must not exceed 3 5. When columnDisplay is "cycle", data in FIRST column only 6. layoutType "infographic" replaces the image field
postnitro_import_carousel
ChatGPTCreate a carousel by importing your own slide content. IMPORTANT: Call postnitro_get_import_template FIRST to see the exact slide structure and rules. templateId, brandId, and responseType are optional if you've saved defaults via postnitro_set_defaults. Strict rules (violations will cause errors): 1. First slide MUST be type "starting_slide" (exactly 1) 2. Middle slides MUST be type "body_slide" (at least 1) 3. Last slide MUST be type "ending_slide" (exactly 1) 4. Infographic columnCount must not exceed 3 5. When columnDisplay is "cycle", put ALL data in the FIRST columnData entry only 6. Setting layoutType "infographic" replaces the image field Minimal example: slides: [ { type: "starting_slide", heading: "Welcome!", description: "Intro", cta_button: "Swipe →" }, { type: "body_slide", heading: "Key Point", description: "Details here" }, { type: "ending_slide", heading: "Thanks!", cta_button: "Learn More" } ]
postnitro_import_image
ChatGPTCreate a single-image post (postType IMAGE) from one slide of your own content. Returns an embedPostId to track progress. Unlike a carousel, an image post is ONE slide — pass slide as a single object, NOT an array, with no slide type. Only heading is required. An infographic layout IS supported: set layoutType 'infographic' + layoutConfig on the slide (same shape as carousel infographics). templateId, brandId, and responseType are optional if you've saved defaults via postnitro_set_defaults. Use postnitro_check_status to monitor, then postnitro_get_output to retrieve. Or use postnitro_import_image_and_wait for one step.
postnitro_import_image_and_wait
ChatGPTConvenience tool: creates a single-image post (postType IMAGE) from one slide, polls until completion, and returns the final output. May take 15-60 seconds. Pass slide as a single object, NOT an array, with no slide type. Only heading is required. An infographic layout IS supported: set layoutType 'infographic' + layoutConfig on the slide (same shape as carousel infographics). templateId, brandId, and responseType are optional if you've saved defaults via postnitro_set_defaults.
postnitro_import_video
ChatGPTCreate a video post (postType VIDEO) from your own scene content. Returns an embedPostId to track progress. Scenes use the SAME slide array as a carousel: exactly 1 starting_slide, at least 1 body_slide, exactly 1 ending_slide — each slide becomes a scene. Infographic layouts work as they do on carousel slides. Output: 'DESIGN' (default) creates the design without rendering; 'MP4' renders the video file and requires videoSettings (duration, optional audio track). templateId, brandId, and responseType are optional if you've saved defaults via postnitro_set_defaults. Use postnitro_check_status to monitor, then postnitro_get_output to retrieve. Or use postnitro_import_video_and_wait for one step.
postnitro_import_video_and_wait
ChatGPTConvenience tool: creates a video post (postType VIDEO) from your own scenes, polls until completion, and returns the final output. Rendering a video takes longer than a carousel — typically 15-45 seconds when responseType is 'MP4', and longer for designs with animations or GIFs (which use the enhanced renderer). Scenes use the SAME slide array as a carousel: exactly 1 starting_slide, at least 1 body_slide, exactly 1 ending_slide — each slide becomes a scene. Output: 'DESIGN' (default) creates the design without rendering; 'MP4' renders the video file and requires videoSettings. templateId, brandId, and responseType are optional if you've saved defaults via postnitro_set_defaults.
postnitro_list_ai_presets
ChatGPTList available AI configuration presets. Returns preset IDs with platform, tone, audience, language, slide count, and model. Use postnitro_set_defaults to save your preferred presetId for future calls.
postnitro_list_audio
ChatGPTList the audio files in your workspace, newest first. Call this to resolve an audioId — the ID a video post needs in videoSettings.audioId, or a scheduled reel in postSettings.audioId. Those fields take an ID, never a URL. Audio is uploaded in the PostNitro app; this API lists and deletes but does not upload. An empty list means the workspace has no audio yet — ask the user to upload some in the app, and create the video without audio in the meantime. When several files match what the user described, show the candidates (name, duration) and let them choose rather than guessing.
postnitro_list_brands
ChatGPTList available brand configurations. Returns brand IDs, names, handles, and display settings. Use postnitro_set_defaults to save your preferred brandId for future calls.
postnitro_list_motion_sequences
ChatGPTList the workspace's saved motion sequences: one slide's animations, saved in the editor's Your sequences. Pass an id as videoSettings.sequenceId to put it on every slide. An empty list means none are saved.
postnitro_list_motion_styles
ChatGPTList the motion styles a video can take: the 14 built-in ones, then the workspace's saved styles (made in the editor's Your styles). Pass an id as videoSettings.motionStyle.
postnitro_list_scheduled_posts
ChatGPTList scheduled posts and drafts whose scheduled time falls within a date range. Returns each post with its captions, selected social accounts, and attached design details. Optionally narrow the results to specific social accounts with socialAccountIds — useful for "what's scheduled on my LinkedIn next week". The filter applies to POSTS, not to the accounts within them: a post targeting both LinkedIn and Instagram is returned when you filter by either, and its accounts array still lists every account it targets.
postnitro_list_social_accounts
ChatGPTList the connected social accounts in your workspace, grouped by platform (linkedin, instagram, tiktok, threads, facebook, pinterest). These account IDs are what you pass as selectedAccounts when creating a scheduled post. Facebook accounts are Pages (accountType 'page'). Pinterest accounts are boards (accountType 'board') — each board is its own connected account. All six platform arrays are always present (empty when none connected).
postnitro_list_templates
ChatGPTList available carousel templates. Returns template IDs, names, and dimensions. Use postnitro_set_defaults to save your preferred templateId for future calls.
postnitro_set_defaults
ChatGPTSave default templateId, brandId, presetId, and responseType so you don't have to provide them every time. These defaults persist across sessions. Any generate/import tool will automatically use them when those parameters are not explicitly provided. Typical first-time setup workflow: 1. Call postnitro_list_templates → pick a template 2. Call postnitro_list_brands → pick a brand 3. Call postnitro_list_ai_presets → pick a preset 4. Call postnitro_set_defaults with the chosen IDs 5. From now on, just call generate/import without specifying IDs
postnitro_update_brand
ChatGPTUpdate an existing brand kit. All seven fields are required by the API. name, handle, and image are only overwritten when a non-empty value is sent; the boolean display flags (isCompanyDetail, showName, showHandle, showImage) are always applied. Tip: call postnitro_get_brand first to read current values, then send them back with your changes.
postnitro_update_scheduled_post
ChatGPTUpdate an existing scheduled post or draft. The body and validation mirror postnitro_create_scheduled_post exactly. The update REPLACES the post's captions and selected accounts with what you send — send the full intended state, not just changed fields. Tip: call postnitro_get_scheduled_post first to read the current values.
postnitro_check_status
Claudepostnitro_create_brand
Claudepostnitro_create_scheduled_post
Claudepostnitro_delete_audio
Claudepostnitro_delete_scheduled_post
Claudepostnitro_disconnect_social_account
Claudepostnitro_generate_and_schedule
Claudepostnitro_generate_and_wait
Claudepostnitro_generate_carousel
Claudepostnitro_generate_image
Claudepostnitro_generate_image_and_wait
Claudepostnitro_generate_video
Claudepostnitro_generate_video_and_wait
Claudepostnitro_get_brand
Claudepostnitro_get_defaults
Claudepostnitro_get_import_template
Claudepostnitro_get_output
Claudepostnitro_get_scheduled_post
Claudepostnitro_get_social_account
Claudepostnitro_import_and_schedule
Claudepostnitro_import_and_wait
Claudepostnitro_import_carousel
Claudepostnitro_import_image
Claudepostnitro_import_image_and_wait
Claudepostnitro_import_video
Claudepostnitro_import_video_and_wait
Claudepostnitro_list_ai_presets
Claudepostnitro_list_audio
Claudepostnitro_list_brands
Claudepostnitro_list_scheduled_posts
Claudepostnitro_list_social_accounts
Claudepostnitro_list_templates
Claudepostnitro_set_defaults
Claudepostnitro_update_brand
Claudepostnitro_update_scheduled_post
Claude