# YALG Developer Docs

> Build integrations with the YALG public API.

## Docs

- [Batch create anecdotes from Excel file](https://docs.yalg.ai/api-reference/anecdotes/batch-create-anecdotes-from-excel-file.md): Import multiple anecdotes from an Excel file (.xlsx, .xls). Expected columns: TITRE (title), ANGLE (LinkedIn angle), ANECDOTE (content - required). When autoFill is enabled, AI will generate missing details like mood, lesson learned, tags, etc.
- [Create a new anecdote](https://docs.yalg.ai/api-reference/anecdotes/create-a-new-anecdote.md): Creates a new personal anecdote with content, categorization, and metadata. When autoFill is enabled, AI will generate missing details.
- [Create anecdote from audio](https://docs.yalg.ai/api-reference/anecdotes/create-anecdote-from-audio.md): Processes an audio file to extract and create an anecdote using AI transcription and content analysis. When autoFill is enabled, AI will generate additional details.
- [Delete all anecdotes for the current user](https://docs.yalg.ai/api-reference/anecdotes/delete-all-anecdotes-for-the-current-user.md): Soft deletes all anecdotes owned by the authenticated user
- [Delete an anecdote](https://docs.yalg.ai/api-reference/anecdotes/delete-an-anecdote.md): Soft deletes an anecdote by setting isActive to false
- [Export anecdotes as CSV](https://docs.yalg.ai/api-reference/anecdotes/export-anecdotes-as-csv.md): Exports all user anecdotes as a CSV file with comprehensive data including content, metadata, and usage statistics
- [Export anecdotes as voice ZIP](https://docs.yalg.ai/api-reference/anecdotes/export-anecdotes-as-voice-zip.md): Exports all user anecdotes as audio files in a ZIP archive using text-to-speech conversion
- [Generate post from anecdote](https://docs.yalg.ai/api-reference/anecdotes/generate-post-from-anecdote.md): Generates a LinkedIn post from an anecdote using AI, with status set to DRAFTED
- [Generate post from anecdote using agentic pipeline](https://docs.yalg.ai/api-reference/anecdotes/generate-post-from-anecdote-using-agentic-pipeline.md): Creates a post generation job that runs through 8 AI agents for optimal quality. Returns a job that can be tracked and validated.
- [Generate post from anecdote using agentic pipeline and run immediately](https://docs.yalg.ai/api-reference/anecdotes/generate-post-from-anecdote-using-agentic-pipeline-and-run-immediately.md): Creates and runs a post generation job through 8 AI agents. Returns the completed job with all artifacts.
- [Get a specific anecdote](https://docs.yalg.ai/api-reference/anecdotes/get-a-specific-anecdote.md): Retrieves a single anecdote by its ID, including author information and related posts
- [Get all anecdotes](https://docs.yalg.ai/api-reference/anecdotes/get-all-anecdotes.md): Retrieves all active anecdotes with pagination support
- [Get anecdote statistics](https://docs.yalg.ai/api-reference/anecdotes/get-anecdote-statistics.md): Retrieves comprehensive statistics about anecdotes including usage, story types, and moods
- [Get anecdotes by mood](https://docs.yalg.ai/api-reference/anecdotes/get-anecdotes-by-mood.md): Retrieves anecdotes filtered by mood/tone
- [Get anecdotes by story type](https://docs.yalg.ai/api-reference/anecdotes/get-anecdotes-by-story-type.md): Retrieves anecdotes filtered by story type (professional stories, personal stories, lesson learned)
- [Get audio file for a voice anecdote](https://docs.yalg.ai/api-reference/anecdotes/get-audio-file-for-a-voice-anecdote.md): Streams the audio file for a voice anecdote as binary data. Only works for anecdotes with type "voice" and existing audio files.
- [Get random anecdote](https://docs.yalg.ai/api-reference/anecdotes/get-random-anecdote.md): Retrieves a random anecdote, optionally filtered by story type
- [Get unused anecdotes](https://docs.yalg.ai/api-reference/anecdotes/get-unused-anecdotes.md): Retrieves anecdotes that have not been used in any posts yet, ordered by priority
- [Search anecdotes](https://docs.yalg.ai/api-reference/anecdotes/search-anecdotes.md): Search for anecdotes by content, title, or lesson learned
- [Toggle favorite status](https://docs.yalg.ai/api-reference/anecdotes/toggle-favorite-status.md): Toggles the favorite status of an anecdote
- [Update an anecdote](https://docs.yalg.ai/api-reference/anecdotes/update-an-anecdote.md): Updates an existing anecdote with new content, metadata, or usage statistics
- [Create a B-roll job from a validated script](https://docs.yalg.ai/api-reference/b-roll-generation/create-a-b-roll-job-from-a-validated-script.md): Create a B-roll job from a validated script. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Create a B-roll job from a validated short](https://docs.yalg.ai/api-reference/b-roll-generation/create-a-b-roll-job-from-a-validated-short.md): Create a B-roll job from a validated short. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Delete a B-roll job](https://docs.yalg.ai/api-reference/b-roll-generation/delete-a-b-roll-job.md): Delete a B-roll job. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get a B-roll job by ID](https://docs.yalg.ai/api-reference/b-roll-generation/get-a-b-roll-job-by-id.md): Get a B-roll job by ID. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get all B-roll jobs](https://docs.yalg.ai/api-reference/b-roll-generation/get-all-b-roll-jobs.md): Get all B-roll jobs. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get all scenes for a B-roll job](https://docs.yalg.ai/api-reference/b-roll-generation/get-all-scenes-for-a-b-roll-job.md): Get all scenes for a B-roll job. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get rendering progress for a B-roll job](https://docs.yalg.ai/api-reference/b-roll-generation/get-rendering-progress-for-a-b-roll-job.md): Get rendering progress for a B-roll job. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get the storyboard for a B-roll job](https://docs.yalg.ai/api-reference/b-roll-generation/get-the-storyboard-for-a-b-roll-job.md): Get the storyboard for a B-roll job. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Re-render a completed or failed job with fresh component selection](https://docs.yalg.ai/api-reference/b-roll-generation/re-render-a-completed-or-failed-job-with-fresh-component-selection.md): Re-render a completed or failed job with fresh component selection. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Regenerate a specific B-roll scene](https://docs.yalg.ai/api-reference/b-roll-generation/regenerate-a-specific-b-roll-scene.md): Regenerate a specific B-roll scene. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Retry rendering for a failed job](https://docs.yalg.ai/api-reference/b-roll-generation/retry-rendering-for-a-failed-job.md): Retry rendering for a failed job. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Start B-roll generation (AI analysis)](https://docs.yalg.ai/api-reference/b-roll-generation/start-b-roll-generation-ai-analysis.md): Start B-roll generation (AI analysis). Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Start rendering all B-roll scenes](https://docs.yalg.ai/api-reference/b-roll-generation/start-rendering-all-b-roll-scenes.md): Start rendering all B-roll scenes. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Update the storyboard before rendering](https://docs.yalg.ai/api-reference/b-roll-generation/update-the-storyboard-before-rendering.md): Update the storyboard before rendering. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Analyze and store the user website context](https://docs.yalg.ai/api-reference/blog/analyze-and-store-the-user-website-context.md): Analyze and store the user website context. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Create blog article](https://docs.yalg.ai/api-reference/blog/create-blog-article.md): Create blog article. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Create blog fuel anecdote](https://docs.yalg.ai/api-reference/blog/create-blog-fuel-anecdote.md): Create blog fuel anecdote. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Delete blog fuel anecdote](https://docs.yalg.ai/api-reference/blog/delete-blog-fuel-anecdote.md): Delete blog fuel anecdote. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Delete imported SEO keyword](https://docs.yalg.ai/api-reference/blog/delete-imported-seo-keyword.md): Delete imported SEO keyword. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Export blog article markdown](https://docs.yalg.ai/api-reference/blog/export-blog-article-markdown.md): Export blog article markdown. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get analyzed blog site profile](https://docs.yalg.ai/api-reference/blog/get-analyzed-blog-site-profile.md): Get analyzed blog site profile. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get blog article](https://docs.yalg.ai/api-reference/blog/get-blog-article.md): Get blog article. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get blog autopilot settings](https://docs.yalg.ai/api-reference/blog/get-blog-autopilot-settings.md): Get blog autopilot settings. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Import SEO keywords from xlsx, xls, or csv](https://docs.yalg.ai/api-reference/blog/import-seo-keywords-from-xlsx-xls-or-csv.md): Import SEO keywords from xlsx, xls, or csv. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [List blog articles](https://docs.yalg.ai/api-reference/blog/list-blog-articles.md): List blog articles. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [List blog fuel anecdotes](https://docs.yalg.ai/api-reference/blog/list-blog-fuel-anecdotes.md): List blog fuel anecdotes. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [List imported SEO keywords](https://docs.yalg.ai/api-reference/blog/list-imported-seo-keywords.md): List imported SEO keywords. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Regenerate blog article](https://docs.yalg.ai/api-reference/blog/regenerate-blog-article.md): Regenerate blog article. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Reject blog article](https://docs.yalg.ai/api-reference/blog/reject-blog-article.md): Reject blog article. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Run blog autopilot manually](https://docs.yalg.ai/api-reference/blog/run-blog-autopilot-manually.md): Run blog autopilot manually. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Start blog article generation](https://docs.yalg.ai/api-reference/blog/start-blog-article-generation.md): Start blog article generation. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Update blog article](https://docs.yalg.ai/api-reference/blog/update-blog-article.md): Update blog article. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Update blog article status](https://docs.yalg.ai/api-reference/blog/update-blog-article-status.md): Update blog article status. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Update blog autopilot settings](https://docs.yalg.ai/api-reference/blog/update-blog-autopilot-settings.md): Update blog autopilot settings. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Update blog fuel anecdote](https://docs.yalg.ai/api-reference/blog/update-blog-fuel-anecdote.md): Update blog fuel anecdote. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Validate blog article](https://docs.yalg.ai/api-reference/blog/validate-blog-article.md): Validate blog article. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Create a new carousel generation job from a post](https://docs.yalg.ai/api-reference/carousel-generation/create-a-new-carousel-generation-job-from-a-post.md): Create a new carousel generation job from a post. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Create and immediately run a carousel generation job from a post](https://docs.yalg.ai/api-reference/carousel-generation/create-and-immediately-run-a-carousel-generation-job-from-a-post.md): Create and immediately run a carousel generation job from a post. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get a carousel generation job by ID](https://docs.yalg.ai/api-reference/carousel-generation/get-a-carousel-generation-job-by-id.md): Get a carousel generation job by ID. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get a carousel generation job by its resulting carousel ID](https://docs.yalg.ai/api-reference/carousel-generation/get-a-carousel-generation-job-by-its-resulting-carousel-id.md): Get a carousel generation job by its resulting carousel ID. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get all carousel generation jobs for current user](https://docs.yalg.ai/api-reference/carousel-generation/get-all-carousel-generation-jobs-for-current-user.md): Get all carousel generation jobs for current user. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Regenerate a carousel generation job](https://docs.yalg.ai/api-reference/carousel-generation/regenerate-a-carousel-generation-job.md): Regenerate a carousel generation job. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Retry a failed carousel generation job](https://docs.yalg.ai/api-reference/carousel-generation/retry-a-failed-carousel-generation-job.md): Retry a failed carousel generation job. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Run the pipeline for a job (synchronously)](https://docs.yalg.ai/api-reference/carousel-generation/run-the-pipeline-for-a-job-synchronously.md): Run the pipeline for a job (synchronously). Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Validate a carousel generation job and generate images](https://docs.yalg.ai/api-reference/carousel-generation/validate-a-carousel-generation-job-and-generate-images.md): Validate a carousel generation job and generate images. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Validate with default template (no body required)](https://docs.yalg.ai/api-reference/carousel-generation/validate-with-default-template-no-body-required.md): Validate with default template (no body required). Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Create a new carousel template](https://docs.yalg.ai/api-reference/carousel/create-a-new-carousel-template.md): Create a new carousel template. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Delete a carousel generation](https://docs.yalg.ai/api-reference/carousel/delete-a-carousel-generation.md): Delete a carousel generation. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Delete a carousel template](https://docs.yalg.ai/api-reference/carousel/delete-a-carousel-template.md): Delete a carousel template. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Delete background image from template](https://docs.yalg.ai/api-reference/carousel/delete-background-image-from-template.md): Delete background image from template. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Delete custom layout and revert to default templates](https://docs.yalg.ai/api-reference/carousel/delete-custom-layout-and-revert-to-default-templates.md): Delete custom layout and revert to default templates. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Delete profile image from template](https://docs.yalg.ai/api-reference/carousel/delete-profile-image-from-template.md): Delete profile image from template. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Generate a carousel from a LinkedIn post](https://docs.yalg.ai/api-reference/carousel/generate-a-carousel-from-a-linkedin-post.md): Generate a carousel from a LinkedIn post. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Generate a carousel from raw content](https://docs.yalg.ai/api-reference/carousel/generate-a-carousel-from-raw-content.md): Generate a carousel from raw content. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Generate a live preview from template config (without saving)](https://docs.yalg.ai/api-reference/carousel/generate-a-live-preview-from-template-config-without-saving.md): Generate a live preview from template config (without saving). Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get a preview image of a saved template](https://docs.yalg.ai/api-reference/carousel/get-a-preview-image-of-a-saved-template.md): Get a preview image of a saved template. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get a specific carousel generation](https://docs.yalg.ai/api-reference/carousel/get-a-specific-carousel-generation.md): Get a specific carousel generation. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get a specific carousel template](https://docs.yalg.ai/api-reference/carousel/get-a-specific-carousel-template.md): Get a specific carousel template. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get all carousel generations for the current user](https://docs.yalg.ai/api-reference/carousel/get-all-carousel-generations-for-the-current-user.md): Get all carousel generations for the current user. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get all carousel templates for the current user](https://docs.yalg.ai/api-reference/carousel/get-all-carousel-templates-for-the-current-user.md): Get all carousel templates for the current user. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get download URL for carousel images (ZIP)](https://docs.yalg.ai/api-reference/carousel/get-download-url-for-carousel-images-zip.md): Get download URL for carousel images (ZIP). Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get download URL for carousel PDF](https://docs.yalg.ai/api-reference/carousel/get-download-url-for-carousel-pdf.md): Get download URL for carousel PDF. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Update a carousel template](https://docs.yalg.ai/api-reference/carousel/update-a-carousel-template.md): Update a carousel template. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Upload a custom layout through the frontend contract](https://docs.yalg.ai/api-reference/carousel/upload-a-custom-layout-through-the-frontend-contract.md): Upload a custom layout through the frontend contract. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Upload a custom layout (ZIP file with .hbs templates)](https://docs.yalg.ai/api-reference/carousel/upload-a-custom-layout-zip-file-with-hbs-templates.md): Upload a ZIP file containing custom Handlebars templates for this carousel template.      **Required files in ZIP:** - `intro.hbs` - Intro slide template - `content.hbs` - Content slide template   - `outro.hbs` - Outro slide template
- [Upload background image for template](https://docs.yalg.ai/api-reference/carousel/upload-background-image-for-template.md): Upload background image for template. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Upload profile image for template](https://docs.yalg.ai/api-reference/carousel/upload-profile-image-for-template.md): Upload profile image for template. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Delete a component](https://docs.yalg.ai/api-reference/components/delete-a-component.md): Delete a component. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Duplicate a component](https://docs.yalg.ai/api-reference/components/duplicate-a-component.md): Duplicate a component. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Generate a new component](https://docs.yalg.ai/api-reference/components/generate-a-new-component.md): Generate a new component using AI based on user prompt
- [Get component details](https://docs.yalg.ai/api-reference/components/get-component-details.md): Retrieves full details of a specific component
- [Get system templates](https://docs.yalg.ai/api-reference/components/get-system-templates.md): Retrieves all system template components
- [List all components](https://docs.yalg.ai/api-reference/components/list-all-components.md): Retrieves all components for the current user with optional filters
- [Regenerate a component](https://docs.yalg.ai/api-reference/components/regenerate-a-component.md): Regenerate the component code using AI with an optional new prompt
- [Update a component](https://docs.yalg.ai/api-reference/components/update-a-component.md): Update component metadata (name, description, tags, etc.)
- [Update component code](https://docs.yalg.ai/api-reference/components/update-component-code.md): Update the source code of a component (triggers re-validation)
- [Validate component code](https://docs.yalg.ai/api-reference/components/validate-component-code.md): Validate the current source code without updating
- [Create a new post generation job from an anecdote](https://docs.yalg.ai/api-reference/post-generation/create-a-new-post-generation-job-from-an-anecdote.md): Create a new post generation job from an anecdote. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get a post generation job by ID](https://docs.yalg.ai/api-reference/post-generation/get-a-post-generation-job-by-id.md): Get a post generation job by ID. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get all post generation jobs for current user](https://docs.yalg.ai/api-reference/post-generation/get-all-post-generation-jobs-for-current-user.md): Get all post generation jobs for current user. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Regenerate a post generation job](https://docs.yalg.ai/api-reference/post-generation/regenerate-a-post-generation-job.md): Regenerate a post generation job. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Reject a post generation job](https://docs.yalg.ai/api-reference/post-generation/reject-a-post-generation-job.md): Reject a post generation job. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Run the pipeline for a job (synchronously)](https://docs.yalg.ai/api-reference/post-generation/run-the-pipeline-for-a-job-synchronously.md): Run the pipeline for a job (synchronously). Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Validate a post generation job and create the post](https://docs.yalg.ai/api-reference/post-generation/validate-a-post-generation-job-and-create-the-post.md): Validate a post generation job and create the post. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Create a new post](https://docs.yalg.ai/api-reference/posts/create-a-new-post.md): Creates a new post with optional content and anecdote associations. The post is created in draft status by default.
- [Delete a post](https://docs.yalg.ai/api-reference/posts/delete-a-post.md): Soft deletes a post by setting isActive to false
- [Delete carousel from a post](https://docs.yalg.ai/api-reference/posts/delete-carousel-from-a-post.md): Remove the carousel PDF from an existing post and delete the file from disk
- [Delete image from a post](https://docs.yalg.ai/api-reference/posts/delete-image-from-a-post.md): Remove the image from an existing post and delete the file from disk
- [Delete video from a post](https://docs.yalg.ai/api-reference/posts/delete-video-from-a-post.md): Remove the video from an existing post and delete the file from disk
- [Get a specific post](https://docs.yalg.ai/api-reference/posts/get-a-specific-post.md): Retrieves a single post by its ID, including author and anecdote information
- [Get all posts](https://docs.yalg.ai/api-reference/posts/get-all-posts.md): Retrieves all active posts with pagination, filtering, and sorting support
- [Get carousel preview image](https://docs.yalg.ai/api-reference/posts/get-carousel-preview-image.md): Retrieve the first slide (intro) of the carousel as a PNG preview image
- [Get post carousel](https://docs.yalg.ai/api-reference/posts/get-post-carousel.md): Retrieve the carousel PDF file associated with a post
- [Get post image](https://docs.yalg.ai/api-reference/posts/get-post-image.md): Retrieve the image file associated with a post
- [Get post video](https://docs.yalg.ai/api-reference/posts/get-post-video.md): Retrieve the video file associated with a post
- [Get posts by anecdote](https://docs.yalg.ai/api-reference/posts/get-posts-by-anecdote.md): Retrieves all posts associated with a specific anecdote with pagination support
- [Get upcoming scheduled posts](https://docs.yalg.ai/api-reference/posts/get-upcoming-scheduled-posts.md): Retrieves posts that are scheduled to be published in the future
- [Increment post comments](https://docs.yalg.ai/api-reference/posts/increment-post-comments.md): Increases the comment count of a post by 1
- [Increment post likes](https://docs.yalg.ai/api-reference/posts/increment-post-likes.md): Increment post likes. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Increment post shares](https://docs.yalg.ai/api-reference/posts/increment-post-shares.md): Increases the share count of a post by 1
- [Mark post as published manually](https://docs.yalg.ai/api-reference/posts/mark-post-as-published-manually.md): Changes post status to PUBLISHED without actually publishing to LinkedIn. Useful if the post was published manually on LinkedIn.
- [Publish post to LinkedIn](https://docs.yalg.ai/api-reference/posts/publish-post-to-linkedin.md): Publishes the post directly to LinkedIn using the integrated LinkedIn service and sends an email notification
- [Regenerate post tags](https://docs.yalg.ai/api-reference/posts/regenerate-post-tags.md): Uses AI to regenerate tags for the post based on its content
- [Schedule a new post](https://docs.yalg.ai/api-reference/posts/schedule-a-new-post.md): Creates a scheduled post based on an anecdote for a specific date and time. The post content will be generated later by AI.
- [Search posts by content](https://docs.yalg.ai/api-reference/posts/search-posts-by-content.md): Search for posts containing specific text in their content
- [Update a post](https://docs.yalg.ai/api-reference/posts/update-a-post.md): Updates an existing post with new content, media, or engagement metrics
- [Upload a carousel (PDF) to a post](https://docs.yalg.ai/api-reference/posts/upload-a-carousel-pdf-to-a-post.md): Upload a PDF document to an existing post for LinkedIn carousel display
- [Upload a video to a post](https://docs.yalg.ai/api-reference/posts/upload-a-video-to-a-post.md): Upload a video to a post. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Upload an image to a post](https://docs.yalg.ai/api-reference/posts/upload-an-image-to-a-post.md): Upload an image to a post. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get developer API quota and usage](https://docs.yalg.ai/api-reference/public-v1/get-developer-api-quota-and-usage.md): Get developer API quota and usage. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get the authenticated API owner profile](https://docs.yalg.ai/api-reference/public-v1/get-the-authenticated-api-owner-profile.md): Get the authenticated API owner profile. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Create a new script job](https://docs.yalg.ai/api-reference/script-jobs/create-a-new-script-job.md): Create a new script job. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Delete a script job](https://docs.yalg.ai/api-reference/script-jobs/delete-a-script-job.md): Delete a script job. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Export script as plain text for teleprompter](https://docs.yalg.ai/api-reference/script-jobs/export-script-as-plain-text-for-teleprompter.md): Export script as plain text for teleprompter. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Export script job as PDF](https://docs.yalg.ai/api-reference/script-jobs/export-script-job-as-pdf.md): Export script job as PDF. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get a script job by ID](https://docs.yalg.ai/api-reference/script-jobs/get-a-script-job-by-id.md): Get a script job by ID. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get all script jobs](https://docs.yalg.ai/api-reference/script-jobs/get-all-script-jobs.md): Get all script jobs. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get thumbnail generation status](https://docs.yalg.ai/api-reference/script-jobs/get-thumbnail-generation-status.md): Get thumbnail generation status. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get thumbnail Master Prompt preview with auto-detected style](https://docs.yalg.ai/api-reference/script-jobs/get-thumbnail-master-prompt-preview-with-auto-detected-style.md): Get thumbnail Master Prompt preview with auto-detected style. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Regenerate a script job](https://docs.yalg.ai/api-reference/script-jobs/regenerate-a-script-job.md): Regenerate a script job. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Regenerate a single thumbnail by index](https://docs.yalg.ai/api-reference/script-jobs/regenerate-a-single-thumbnail-by-index.md): Regenerate a single thumbnail by index. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Regenerate thumbnail for a script job](https://docs.yalg.ai/api-reference/script-jobs/regenerate-thumbnail-for-a-script-job.md): Regenerate thumbnail for a script job. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Reject a script job](https://docs.yalg.ai/api-reference/script-jobs/reject-a-script-job.md): Reject a script job. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Start generation for all script jobs in backlog (CREATED status)](https://docs.yalg.ai/api-reference/script-jobs/start-generation-for-all-script-jobs-in-backlog-created-status.md): Start generation for all script jobs in backlog (CREATED status). Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Update a script job](https://docs.yalg.ai/api-reference/script-jobs/update-a-script-job.md): Update a script job. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Update script job status (for Kanban drag-and-drop)](https://docs.yalg.ai/api-reference/script-jobs/update-script-job-status-for-kanban-drag-and-drop.md): Update script job status (for Kanban drag-and-drop). Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Upload user photo for thumbnail generation](https://docs.yalg.ai/api-reference/script-jobs/upload-user-photo-for-thumbnail-generation.md): Upload user photo for thumbnail generation. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Validate a script job](https://docs.yalg.ai/api-reference/script-jobs/validate-a-script-job.md): Validate a script job. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Create a new standalone short](https://docs.yalg.ai/api-reference/shorts/create-a-new-standalone-short.md): Create a new standalone short. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Create a short from an existing script job](https://docs.yalg.ai/api-reference/shorts/create-a-short-from-an-existing-script-job.md): Create a short from an existing script job. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Delete a short](https://docs.yalg.ai/api-reference/shorts/delete-a-short.md): Delete a short. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get a short by ID](https://docs.yalg.ai/api-reference/shorts/get-a-short-by-id.md): Get a short by ID. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get all shorts](https://docs.yalg.ai/api-reference/shorts/get-all-shorts.md): Get all shorts. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get shorts statistics](https://docs.yalg.ai/api-reference/shorts/get-shorts-statistics.md): Get shorts statistics. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get thumbnail generation status](https://docs.yalg.ai/api-reference/shorts/get-thumbnail-generation-status.md): Get thumbnail generation status. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Regenerate a short](https://docs.yalg.ai/api-reference/shorts/regenerate-a-short.md): Regenerate a short. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Regenerate a single thumbnail by index](https://docs.yalg.ai/api-reference/shorts/regenerate-a-single-thumbnail-by-index.md): Regenerate a single thumbnail by index. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Regenerate thumbnail for a short](https://docs.yalg.ai/api-reference/shorts/regenerate-thumbnail-for-a-short.md): Regenerate thumbnail for a short. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Reject a short](https://docs.yalg.ai/api-reference/shorts/reject-a-short.md): Reject a short. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Start generation for all shorts in backlog](https://docs.yalg.ai/api-reference/shorts/start-generation-for-all-shorts-in-backlog.md): Batch operation to start AI generation for all shorts with status CREATED
- [Update a short](https://docs.yalg.ai/api-reference/shorts/update-a-short.md): Update a short. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Update short status (for Kanban drag-and-drop)](https://docs.yalg.ai/api-reference/shorts/update-short-status-for-kanban-drag-and-drop.md): Update short status (for Kanban drag-and-drop). Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Upload user photo for thumbnail generation](https://docs.yalg.ai/api-reference/shorts/upload-user-photo-for-thumbnail-generation.md): Upload user photo for thumbnail generation. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Validate a short](https://docs.yalg.ai/api-reference/shorts/validate-a-short.md): Validate a short. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get content awaiting validation](https://docs.yalg.ai/api-reference/statistics/get-content-awaiting-validation.md): Retrieves all content items (scripts, carousels, shorts) that are awaiting user validation
- [Get dashboard metrics](https://docs.yalg.ai/api-reference/statistics/get-dashboard-metrics.md): Retrieves key performance metrics for the dashboard including posts, engagement, comments, and impressions with month-over-month comparisons
- [Get overview statistics](https://docs.yalg.ai/api-reference/statistics/get-overview-statistics.md): Retrieves comprehensive overview statistics including anecdotes, posts, and content breakdowns
- [Get top performing posts](https://docs.yalg.ai/api-reference/statistics/get-top-performing-posts.md): Retrieves posts ranked by engagement performance for the dashboard activity feed. Posts are sorted by engagement score (likes + comments×3 + shares×5 + impressions×0.1) with highest engagement first.
- [Create a new theme](https://docs.yalg.ai/api-reference/user-themes/create-a-new-theme.md): Creates a new theme for the current user
- [Delete a theme](https://docs.yalg.ai/api-reference/user-themes/delete-a-theme.md): Delete a theme. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Duplicate a theme](https://docs.yalg.ai/api-reference/user-themes/duplicate-a-theme.md): Duplicate a theme. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Export theme as JSON](https://docs.yalg.ai/api-reference/user-themes/export-theme-as-json.md): Exports a theme configuration as JSON for sharing or backup
- [Get a specific theme](https://docs.yalg.ai/api-reference/user-themes/get-a-specific-theme.md): Get a specific theme. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Get all user themes](https://docs.yalg.ai/api-reference/user-themes/get-all-user-themes.md): Retrieves all themes for the current user
- [Get default theme](https://docs.yalg.ai/api-reference/user-themes/get-default-theme.md): Retrieves the default theme for the current user, creating one if none exists
- [Import theme from JSON](https://docs.yalg.ai/api-reference/user-themes/import-theme-from-json.md): Import theme from JSON. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Set theme as default](https://docs.yalg.ai/api-reference/user-themes/set-theme-as-default.md): Sets a theme as the default for the current user
- [Update a theme](https://docs.yalg.ai/api-reference/user-themes/update-a-theme.md): Update a theme. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Create a new YouTube video suggestion](https://docs.yalg.ai/api-reference/youtube-suggestions/create-a-new-youtube-video-suggestion.md): Manually create a YouTube video idea suggestion
- [Delete a suggestion](https://docs.yalg.ai/api-reference/youtube-suggestions/delete-a-suggestion.md): Delete a suggestion. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Generate YouTube video suggestions using AI](https://docs.yalg.ai/api-reference/youtube-suggestions/generate-youtube-video-suggestions-using-ai.md): Uses AI to generate multiple video ideas based on a topic and preferences
- [Get a specific suggestion](https://docs.yalg.ai/api-reference/youtube-suggestions/get-a-specific-suggestion.md): Retrieves a single YouTube suggestion by ID
- [Get all YouTube suggestions](https://docs.yalg.ai/api-reference/youtube-suggestions/get-all-youtube-suggestions.md): Retrieves all suggestions with pagination and optional status filter
- [Get suggestion statistics](https://docs.yalg.ai/api-reference/youtube-suggestions/get-suggestion-statistics.md): Retrieves statistics about YouTube suggestions
- [Update a suggestion](https://docs.yalg.ai/api-reference/youtube-suggestions/update-a-suggestion.md): Update a suggestion. Requests are scoped to the authenticated API key owner; cross-owner resource IDs return 404.
- [Update suggestion status](https://docs.yalg.ai/api-reference/youtube-suggestions/update-suggestion-status.md): Updates the status of a YouTube suggestion (approve, reject, mark as used)
- [Authentication](https://docs.yalg.ai/authentication.md): Authenticate YALG Developer API requests with x-api-key.
- [API keys](https://docs.yalg.ai/concepts/api-keys.md): Manage YALG API key lifecycle, storage, rotation, and revocation.
- [Errors](https://docs.yalg.ai/concepts/errors.md): Understand standard YALG error responses and common HTTP statuses.
- [Pagination](https://docs.yalg.ai/concepts/pagination.md): Use page and limit query parameters on list endpoints.
- [Rate limits and quotas](https://docs.yalg.ai/concepts/rate-limits.md): Handle YALG monthly quotas, per-minute limits, and limit headers.
- [Resource scoping](https://docs.yalg.ai/concepts/scoping.md): Understand how YALG scopes API requests to the API key owner.
- [Analytics](https://docs.yalg.ai/guides/analytics.md): Read YALG dashboard and content performance data.
- [Anecdotes](https://docs.yalg.ai/guides/anecdotes.md): Create and manage source stories for YALG content generation.
- [Post generation](https://docs.yalg.ai/guides/post-generation.md): Generate LinkedIn-ready post drafts from anecdotes.
- [Posts](https://docs.yalg.ai/guides/posts.md): Create, schedule, publish, and manage YALG posts through the API.
- [Creative workflows](https://docs.yalg.ai/guides/workflows.md): Integrate scripts, shorts, carousels, b-roll, and component workflows.
- [YALG Developer Docs](https://docs.yalg.ai/index.md): Integrate YALG content workflows into your own product.
- [Quickstart](https://docs.yalg.ai/quickstart.md): Create an API key and make your first YALG API request.