postpeer 0.1.0__py3-none-any.whl

postpeer/_generated/pydantic_gen.py

@@ -0,0 +1,2061 @@
+# This file is auto-generated by @hey-api/openapi-python
+
+from datetime import date, datetime
+from enum import Enum
+from typing import Annotated, Any, Optional, Union
+
+from pydantic import AnyUrl, BaseModel, ConfigDict, EmailStr, Field, RootModel
+
+
+class Platform(str, Enum):
+    TWITTER = "twitter"
+    INSTAGRAM = "instagram"
+    YOUTUBE = "youtube"
+    TIKTOK = "tiktok"
+    PINTEREST = "pinterest"
+    LINKEDIN = "linkedin"
+    BLUESKY = "bluesky"
+    FACEBOOK = "facebook"
+    THREADS = "threads"
+    GOOGLEBUSINESS = "googlebusiness"
+
+
+class Status(str, Enum):
+    DRAFT = "draft"
+    PENDING = "pending"
+    SCHEDULED = "scheduled"
+    PUBLISHING = "publishing"
+    PUBLISHED = "published"
+    FAILED = "failed"
+    PARTIAL = "partial"
+
+
+class SortOrder(str, Enum):
+    ASC = "asc"
+    DESC = "desc"
+
+
+class ErrorResponse(BaseModel):
+    success: bool
+    message: str
+
+
+class TwitterConfigurationsReplySettings(str, Enum):
+    FOLLOWING = "following"
+    MENTIONED_USERS = "mentionedUsers"
+    SUBSCRIBERS = "subscribers"
+    VERIFIED = "verified"
+
+
+class TwitterConfigurationsThreadItemsMediaItemsType(str, Enum):
+    IMAGE = "image"
+    VIDEO = "video"
+    GIF = "gif"
+    DOCUMENT = "document"
+
+
+class TwitterConfigurationsThreadItemsMediaItems(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+    type: TwitterConfigurationsThreadItemsMediaItemsType
+    url: AnyUrl
+    thumbnail: Optional[AnyUrl] = Field(default=None, description="Thumbnail image URL for video items. Supported on YouTube regular videos (not Shorts). JPEG, PNG, or GIF, max 2 MB, min 640 px wide.")
+
+
+class TwitterConfigurationsThreadItems(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    content: str = Field(..., description="Text of this thread tweet (max 280 chars)")
+    media_items: Optional[list[TwitterConfigurationsThreadItemsMediaItems]] = Field(default=None, alias="mediaItems")
+
+
+class TwitterConfigurationsPoll(BaseModel):
+    """Cannot be combined with media or threadItems."""
+
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    options: Annotated[list[str], Field(min_length=2, max_length=4)] = Field(..., description="2–4 poll options.")
+    duration_minutes: Annotated[float, Field(ge=5, le=10080)] = Field(..., alias="durationMinutes", description="Poll duration in minutes (5 min – 7 days).")
+
+
+class TwitterConfigurations(BaseModel):
+    """Pass this object in platformSpecificData when posting to Twitter/X, including Community post options."""
+
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    community_id: Optional[str] = Field(default=None, alias="communityId", description="Community ID to publish this post into.")
+    share_with_followers: Optional[bool] = Field(default=None, alias="shareWithFollowers", description="When posting to a Community, also share the post with followers.")
+    reply_to_tweet_id: Optional[str] = Field(default=None, alias="replyToTweetId", description="Tweet ID to reply to.")
+    reply_settings: Optional[TwitterConfigurationsReplySettings] = Field(default=None, alias="replySettings")
+    thread_items: Optional[list[TwitterConfigurationsThreadItems]] = Field(default=None, alias="threadItems", description="Additional tweets to chain as a thread. The root tweet uses post.content.")
+    poll: Optional[TwitterConfigurationsPoll] = Field(default=None, description="Cannot be combined with media or threadItems.")
+
+
+class YouTubeConfigurationsVisibility(str, Enum):
+    """Who can see the video. Defaults to "public". Scheduled posts upload as private and flip to this value at publish time."""
+
+    PUBLIC = "public"
+    PRIVATE = "private"
+    UNLISTED = "unlisted"
+
+
+class YouTubeConfigurations(BaseModel):
+    """Pass this object in platformSpecificData when posting to YouTube."""
+
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    title: Optional[Annotated[str, Field(max_length=100)]] = Field(default=None, description='Video title (max 100 chars, no < or >). Defaults to first 100 chars of content, or "Untitled Video".')
+    tags: Optional[list[str]] = Field(default=None, description="Video tags. Total characters across all tags must be ≤500.")
+    visibility: Optional[YouTubeConfigurationsVisibility] = Field(default=None, description='Who can see the video. Defaults to "public". Scheduled posts upload as private and flip to this value at publish time.')
+    made_for_kids: Optional[bool] = Field(default=None, alias="madeForKids", description="COPPA compliance flag. Setting to true permanently disables comments, notification bell, personalized ads, end screens, and cards on the video. Defaults to false.")
+    contains_synthetic_media: Optional[bool] = Field(default=None, alias="containsSyntheticMedia", description="AI-generated content disclosure. YouTube is increasingly enforcing this requirement. Defaults to false.")
+    category_id: Optional[str] = Field(default=None, alias="categoryId", description='YouTube category ID. Defaults to "22" (People & Blogs). Common values: "1" Film & Animation, "10" Music, "20" Gaming, "22" People & Blogs, "27" Education, "28" Science & Technology.')
+    first_comment: Optional[Annotated[str, Field(max_length=10000)]] = Field(default=None, alias="firstComment", description="Auto-posted comment after the video goes live. Max 10,000 characters. For publishNow posts: posted immediately after upload. For scheduled posts: posted when the video becomes public.")
+
+
+class TikTokConfigurationsPrivacyLevel(str, Enum):
+    """Who can see this post. Defaults to "PUBLIC_TO_EVERYONE"."""
+
+    PUBLIC_TO_EVERYONE = "PUBLIC_TO_EVERYONE"
+    MUTUAL_FOLLOW_FRIENDS = "MUTUAL_FOLLOW_FRIENDS"
+    FOLLOWER_OF_CREATOR = "FOLLOWER_OF_CREATOR"
+    SELF_ONLY = "SELF_ONLY"
+
+
+class TikTokConfigurations(BaseModel):
+    """Pass this object in platformSpecificData when posting to TikTok."""
+
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    privacy_level: Optional[TikTokConfigurationsPrivacyLevel] = Field(default=None, alias="privacyLevel", description='Who can see this post. Defaults to "PUBLIC_TO_EVERYONE".')
+    disable_comment: Optional[bool] = Field(default=None, alias="disableComment", description="Disable comments on this post. Defaults to false.")
+    disable_duet: Optional[bool] = Field(default=None, alias="disableDuet", description="Disable duet for this video. Videos only. Defaults to false.")
+    disable_stitch: Optional[bool] = Field(default=None, alias="disableStitch", description="Disable stitch for this video. Videos only. Defaults to false.")
+    brand_content_toggle: Optional[bool] = Field(default=None, alias="brandContentToggle", description="Mark as branded content (paid partnership). Defaults to false.")
+    brand_organic_toggle: Optional[bool] = Field(default=None, alias="brandOrganicToggle", description="Mark as organic brand promotion. Defaults to false.")
+    is_aigc: Optional[bool] = Field(default=None, alias="isAigc", description="AI-generated content disclosure. Videos only. Defaults to false.")
+    video_cover_timestamp_ms: Optional[Annotated[float, Field(ge=0)]] = Field(default=None, alias="videoCoverTimestampMs", description="Timestamp in milliseconds to use as the video cover frame. Videos only.")
+    auto_add_music: Optional[bool] = Field(default=None, alias="autoAddMusic", description="Automatically add background music to photo carousels. Photo posts only. Defaults to true.")
+    photo_cover_index: Optional[Annotated[float, Field(ge=0)]] = Field(default=None, alias="photoCoverIndex", description="0-indexed position of the cover image in a photo carousel. Photo posts only. Defaults to 0.")
+    description: Optional[Annotated[str, Field(max_length=4000)]] = Field(default=None, description="Separate description for a TikTok photo or carousel post. Max 4,000 characters. When omitted, the post content is also used as the description. Photo posts only.")
+    draft: Optional[bool] = Field(default=None, description="When true, sends content to the creator's TikTok inbox as a draft. Defaults to false (publishes immediately via DIRECT_POST).")
+
+
+class PinterestConfigurations(BaseModel):
+    """Pass this object in platformSpecificData when posting to Pinterest."""
+
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    board_id: str = Field(..., alias="boardId", description="Target board ID. Retrieve available boards via GET /v1/pinterest/boards.")
+    title: Optional[Annotated[str, Field(max_length=100)]] = Field(default=None, description="Pin title. Max 100 characters. Defaults to first line of content.")
+    link: Optional[AnyUrl] = Field(default=None, description="HTTPS destination URL when the pin is clicked. Important for driving traffic.")
+    alt_text: Optional[Annotated[str, Field(max_length=500)]] = Field(default=None, alias="altText", description="Accessible image description. Max 500 characters.")
+    dominant_color: Optional[str] = Field(default=None, alias="dominantColor", description='Hex color for the loading placeholder (e.g. "#6E7874").')
+    cover_image_url: Optional[AnyUrl] = Field(default=None, alias="coverImageUrl", description="Custom cover image URL for video pins.")
+
+
+class LinkedInConfigurationsVisibility(str, Enum):
+    """Post visibility. "PUBLIC" = visible to everyone, "CONNECTIONS" = visible to connections only. Defaults to "PUBLIC"."""
+
+    PUBLIC = "PUBLIC"
+    CONNECTIONS = "CONNECTIONS"
+
+
+class LinkedInConfigurations(BaseModel):
+    """Pass this object in platformSpecificData when posting to LinkedIn."""
+
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    visibility: Optional[LinkedInConfigurationsVisibility] = Field(default=None, description='Post visibility. "PUBLIC" = visible to everyone, "CONNECTIONS" = visible to connections only. Defaults to "PUBLIC".')
+    article_url: Optional[AnyUrl] = Field(default=None, alias="articleUrl", description="URL for an article/link post. When provided, the post becomes a link share with a preview card.")
+    article_title: Optional[Annotated[str, Field(max_length=400)]] = Field(default=None, alias="articleTitle", description="Title for the article preview card. Max 400 characters.")
+    article_description: Optional[Annotated[str, Field(max_length=400)]] = Field(default=None, alias="articleDescription", description="Description for the article preview card. Max 400 characters.")
+    document_title: Optional[Annotated[str, Field(max_length=200)]] = Field(default=None, alias="documentTitle", description="Title shown on the document card when posting a PDF. Required by LinkedIn when a document media item is included.")
+
+
+class BlueskyConfigurations(BaseModel):
+    """Pass this object in platformSpecificData when posting to Bluesky."""
+
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    langs: Optional[list[str]] = Field(default=None, description='BCP-47 language tags for the post (e.g. ["en"], ["en-US", "es"]). Defaults to ["en"].')
+    alt_text: Optional[list[str]] = Field(default=None, alias="altText", description="Alt text for each image, in the same order as mediaItems. Strongly encouraged for accessibility.")
+
+
+class FacebookConfigurations(BaseModel):
+    """Pass this object in platformSpecificData when posting to Facebook Pages."""
+
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    link: Optional[AnyUrl] = Field(default=None, description="When provided on a text-only post, Facebook renders a link preview card from this URL's Open Graph tags. Ignored when mediaItems are attached.")
+    published: Optional[bool] = Field(default=None, description="When false, the post is created on the Page in unpublished/draft state — useful for staging or scheduling via Facebook's own composer. Defaults to true.")
+    video_thumbnail_url: Optional[AnyUrl] = Field(default=None, alias="videoThumbnailUrl", description="Video posts only. Public URL of an image Facebook will use as the video's cover/thumbnail. Applied as a follow-up call after publish — if the upload fails, the post still succeeds (Facebook just auto-picks a frame). Ignored when no video is attached.")
+
+
+class InstagramConfigurations(BaseModel):
+    """Pass this object in platformSpecificData when posting to Instagram Business accounts. All fields are optional and apply to Reels/video posts; image posts ignore them."""
+
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    share_to_feed: Optional[bool] = Field(default=None, alias="shareToFeed", description="Reels-only. When true (default), the Reel also appears in the account's main feed grid. Set false to publish to Reels only.")
+    cover_url: Optional[AnyUrl] = Field(default=None, alias="coverUrl", description="Video-only. Public URL of an image Instagram will use as the cover frame for the Reel/video post. Ignored for image posts.")
+    thumb_offset: Optional[Annotated[int, Field(ge=0)]] = Field(default=None, alias="thumbOffset", description="Video-only. Timestamp in milliseconds Instagram extracts as the cover frame. Ignored when coverUrl is set or for image posts.")
+
+
+class ThreadsConfigurationsReplyControl(str, Enum):
+    """Who can reply to this thread. Defaults to "everyone" when omitted."""
+
+    EVERYONE = "everyone"
+    ACCOUNTS_YOU_FOLLOW = "accounts_you_follow"
+    MENTIONED_ONLY = "mentioned_only"
+
+
+class ThreadsConfigurations(BaseModel):
+    """Pass this object in platformSpecificData when posting to Threads."""
+
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    reply_control: Optional[ThreadsConfigurationsReplyControl] = Field(default=None, alias="replyControl", description='Who can reply to this thread. Defaults to "everyone" when omitted.')
+    alt_text: Optional[list[str]] = Field(default=None, alias="altText", description="Alt text for each image, in the same order as mediaItems. Strongly encouraged for accessibility.")
+
+
+class GoogleBusinessConfigurationsTopicType(str, Enum):
+    """Post type. Defaults to STANDARD. Use EVENT for event posts, OFFER for promotional offer posts."""
+
+    STANDARD = "STANDARD"
+    EVENT = "EVENT"
+    OFFER = "OFFER"
+
+
+class GoogleBusinessConfigurationsCallToActionType(str, Enum):
+    """Call-to-action button shown on the post."""
+
+    BOOK = "BOOK"
+    ORDER = "ORDER"
+    SHOP = "SHOP"
+    LEARN_MORE = "LEARN_MORE"
+    SIGN_UP = "SIGN_UP"
+    CALL = "CALL"
+    GET_OFFER = "GET_OFFER"
+
+
+class GoogleBusinessConfigurations(BaseModel):
+    """Pass this object in platformSpecificData when posting to Google Business Profile. Posts appear on Google Search and Maps."""
+
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    topic_type: Optional[GoogleBusinessConfigurationsTopicType] = Field(default=None, alias="topicType", description="Post type. Defaults to STANDARD. Use EVENT for event posts, OFFER for promotional offer posts.")
+    call_to_action_type: Optional[GoogleBusinessConfigurationsCallToActionType] = Field(default=None, alias="callToActionType", description="Call-to-action button shown on the post.")
+    call_to_action_url: Optional[AnyUrl] = Field(default=None, alias="callToActionUrl", description="URL for the call-to-action. Required for all CTA types except CALL.")
+    event_title: Optional[str] = Field(default=None, alias="eventTitle", description="Event title. Required when topicType is EVENT.")
+    event_start_date: Optional[str] = Field(default=None, alias="eventStartDate", description="Event start date in YYYY-MM-DD format. Required when topicType is EVENT.")
+    event_start_time: Optional[str] = Field(default=None, alias="eventStartTime", description="Event start time in HH:MM (24-hour) format. Required when topicType is EVENT.")
+    event_end_date: Optional[str] = Field(default=None, alias="eventEndDate", description="Event end date in YYYY-MM-DD format. Required when topicType is EVENT.")
+    event_end_time: Optional[str] = Field(default=None, alias="eventEndTime", description="Event end time in HH:MM (24-hour) format. Required when topicType is EVENT.")
+    offer_coupon_code: Optional[str] = Field(default=None, alias="offerCouponCode", description="Coupon code for OFFER posts.")
+    offer_redeem_online_url: Optional[AnyUrl] = Field(default=None, alias="offerRedeemOnlineUrl", description="Online redemption URL for OFFER posts.")
+    offer_terms_conditions: Optional[str] = Field(default=None, alias="offerTermsConditions", description="Terms and conditions text for OFFER posts.")
+
+
+class PostPayloadMediaItemsType(str, Enum):
+    IMAGE = "image"
+    VIDEO = "video"
+    GIF = "gif"
+    DOCUMENT = "document"
+
+
+class PostPayloadMediaItems(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+    type: PostPayloadMediaItemsType
+    url: AnyUrl
+    thumbnail: Optional[AnyUrl] = Field(default=None, description="Thumbnail image URL for video items. Supported on YouTube regular videos (not Shorts). JPEG, PNG, or GIF, max 2 MB, min 640 px wide.")
+
+
+class PostPayloadPlatformsPlatform(str, Enum):
+    TWITTER = "twitter"
+
+
+class PostPayloadPlatforms(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    platform: PostPayloadPlatformsPlatform
+    account_id: str = Field(..., alias="accountId", description="Integration._id — find yours via GET /connect/integrations")
+    content: Optional[str] = Field(default=None, description="Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.")
+    platform_specific_data: Optional[TwitterConfigurations] = Field(default=None, alias="platformSpecificData")
+
+
+class PostPayloadPlatformsPlatform_(str, Enum):
+    INSTAGRAM = "instagram"
+
+
+class PostPayloadPlatforms_(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    platform: PostPayloadPlatformsPlatform_
+    account_id: str = Field(..., alias="accountId", description="Integration._id — find yours via GET /connect/integrations")
+    content: Optional[str] = Field(default=None, description="Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.")
+    platform_specific_data: Optional[InstagramConfigurations] = Field(default=None, alias="platformSpecificData")
+
+
+class PostPayloadPlatformsPlatform_2(str, Enum):
+    YOUTUBE = "youtube"
+
+
+class PostPayloadPlatforms_2(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    platform: PostPayloadPlatformsPlatform_2
+    account_id: str = Field(..., alias="accountId", description="Integration._id — find yours via GET /connect/integrations")
+    content: Optional[str] = Field(default=None, description="Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.")
+    platform_specific_data: Optional[YouTubeConfigurations] = Field(default=None, alias="platformSpecificData")
+
+
+class PostPayloadPlatformsPlatform_3(str, Enum):
+    TIKTOK = "tiktok"
+
+
+class PostPayloadPlatforms_3(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    platform: PostPayloadPlatformsPlatform_3
+    account_id: str = Field(..., alias="accountId", description="Integration._id — find yours via GET /connect/integrations")
+    content: Optional[str] = Field(default=None, description="Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.")
+    platform_specific_data: Optional[TikTokConfigurations] = Field(default=None, alias="platformSpecificData")
+
+
+class PostPayloadPlatformsPlatform_4(str, Enum):
+    PINTEREST = "pinterest"
+
+
+class PostPayloadPlatforms_4(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    platform: PostPayloadPlatformsPlatform_4
+    account_id: str = Field(..., alias="accountId", description="Integration._id — find yours via GET /connect/integrations")
+    content: Optional[str] = Field(default=None, description="Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.")
+    platform_specific_data: Optional[PinterestConfigurations] = Field(default=None, alias="platformSpecificData")
+
+
+class PostPayloadPlatformsPlatform_5(str, Enum):
+    LINKEDIN = "linkedin"
+
+
+class PostPayloadPlatforms_5(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    platform: PostPayloadPlatformsPlatform_5
+    account_id: str = Field(..., alias="accountId", description="Integration._id — find yours via GET /connect/integrations")
+    content: Optional[str] = Field(default=None, description="Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.")
+    platform_specific_data: Optional[LinkedInConfigurations] = Field(default=None, alias="platformSpecificData")
+
+
+class PostPayloadPlatformsPlatform_6(str, Enum):
+    BLUESKY = "bluesky"
+
+
+class PostPayloadPlatforms_6(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    platform: PostPayloadPlatformsPlatform_6
+    account_id: str = Field(..., alias="accountId", description="Integration._id — find yours via GET /connect/integrations")
+    content: Optional[str] = Field(default=None, description="Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.")
+    platform_specific_data: Optional[BlueskyConfigurations] = Field(default=None, alias="platformSpecificData")
+
+
+class PostPayloadPlatformsPlatform_7(str, Enum):
+    FACEBOOK = "facebook"
+
+
+class PostPayloadPlatforms_7(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    platform: PostPayloadPlatformsPlatform_7
+    account_id: str = Field(..., alias="accountId", description="Integration._id — find yours via GET /connect/integrations")
+    content: Optional[str] = Field(default=None, description="Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.")
+    platform_specific_data: Optional[FacebookConfigurations] = Field(default=None, alias="platformSpecificData")
+
+
+class PostPayloadPlatformsPlatform_8(str, Enum):
+    THREADS = "threads"
+
+
+class PostPayloadPlatforms_8(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    platform: PostPayloadPlatformsPlatform_8
+    account_id: str = Field(..., alias="accountId", description="Integration._id — find yours via GET /connect/integrations")
+    content: Optional[str] = Field(default=None, description="Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.")
+    platform_specific_data: Optional[ThreadsConfigurations] = Field(default=None, alias="platformSpecificData")
+
+
+class PostPayloadPlatformsPlatform_9(str, Enum):
+    GOOGLEBUSINESS = "googlebusiness"
+
+
+class PostPayloadPlatforms_9(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    platform: PostPayloadPlatformsPlatform_9
+    account_id: str = Field(..., alias="accountId", description="Integration._id — find yours via GET /connect/integrations")
+    content: Optional[str] = Field(default=None, description="Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.")
+    platform_specific_data: Optional[GoogleBusinessConfigurations] = Field(default=None, alias="platformSpecificData")
+
+
+class PostPayload(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    content: str = Field(..., description="Post text body")
+    media_items: Optional[list[PostPayloadMediaItems]] = Field(default=None, alias="mediaItems", description="Media attachments (images, videos, GIFs)")
+    platforms: Annotated[list[Union[PostPayloadPlatforms, PostPayloadPlatforms_, PostPayloadPlatforms_2, PostPayloadPlatforms_3, PostPayloadPlatforms_4, PostPayloadPlatforms_5, PostPayloadPlatforms_6, PostPayloadPlatforms_7, PostPayloadPlatforms_8, PostPayloadPlatforms_9]], Field(min_length=1)] = Field(..., description="Target platform accounts to publish to")
+    publish_now: Optional[bool] = Field(default=None, alias="publishNow", description="Publish immediately. Required when scheduledFor is omitted.")
+    scheduled_for: Optional[datetime] = Field(default=None, alias="scheduledFor", description="ISO 8601 datetime to schedule the post for future publishing")
+    timezone: Optional[str] = Field(default=None, description="IANA timezone for the scheduled time (e.g. America/New_York). Defaults to UTC.")
+
+
+class HealthCheckResponse(BaseModel):
+    """Default Response"""
+
+    ok: bool
+
+
+class HealthCheckAuthResponse(BaseModel):
+    """Default Response"""
+
+    ok: bool
+
+
+class GetLinkedInSelectionPath(BaseModel):
+    token: Annotated[str, Field(min_length=1)]
+
+
+class GetLinkedInSelectionPlatform(str, Enum):
+    LINKEDIN = "linkedin"
+
+
+class GetLinkedInSelectionAccountsType(str, Enum):
+    PERSON = "person"
+
+
+class GetLinkedInSelectionAccountsType_(str, Enum):
+    ORGANIZATION = "organization"
+
+
+class GetLinkedInSelectionAccounts(BaseModel):
+    id: str
+    type: Union[GetLinkedInSelectionAccountsType, GetLinkedInSelectionAccountsType_]
+    platform_user_id: str = Field(..., alias="platformUserId")
+    display_name: Optional[str] = Field(default=None, alias="displayName")
+    username: Optional[str] = None
+    image_url: Optional[AnyUrl] = Field(default=None, alias="imageUrl")
+
+
+class GetLinkedInSelectionResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    platform: GetLinkedInSelectionPlatform
+    expires_in_seconds: float = Field(..., alias="expiresInSeconds")
+    accounts: list[GetLinkedInSelectionAccounts]
+
+
+class SubmitLinkedInSelectionBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    selected_account_ids: Annotated[list[str], Field(min_length=1)] = Field(..., alias="selectedAccountIds")
+
+
+class SubmitLinkedInSelectionPath(BaseModel):
+    token: Annotated[str, Field(min_length=1)]
+
+
+class SubmitLinkedInSelectionPlatform(str, Enum):
+    LINKEDIN = "linkedin"
+
+
+class SubmitLinkedInSelectionIntegrationsPlatform(str, Enum):
+    TWITTER = "twitter"
+    INSTAGRAM = "instagram"
+    YOUTUBE = "youtube"
+    TIKTOK = "tiktok"
+    PINTEREST = "pinterest"
+    LINKEDIN = "linkedin"
+    BLUESKY = "bluesky"
+    FACEBOOK = "facebook"
+    THREADS = "threads"
+    GOOGLEBUSINESS = "googlebusiness"
+
+
+class SubmitLinkedInSelectionIntegrationsApp(BaseModel):
+    id: Optional[str] = None
+    name: Optional[str] = None
+    image_url: Optional[str] = Field(default=None, alias="imageUrl")
+
+
+class SubmitLinkedInSelectionIntegrations(BaseModel):
+    id: str = Field(..., description="Use this as accountId when creating posts")
+    platform: SubmitLinkedInSelectionIntegrationsPlatform
+    platform_user_id: Optional[str] = Field(default=None, alias="platformUserId", description="The user ID on the platform, or null if not yet retrieved")
+    username: Optional[str] = Field(default=None, description="The public username or handle, including @ for handle-based platforms")
+    display_name: Optional[str] = Field(default=None, alias="displayName", description="Human-readable display name of the connected account")
+    profile_url: Optional[AnyUrl] = Field(default=None, alias="profileUrl", description="Public profile/page URL for the connected account, when it can be derived")
+    image_url: Optional[AnyUrl] = Field(default=None, alias="imageUrl", description="Profile image URL for the connected account, or null if unavailable")
+    platform_metadata: Optional[dict[str, Any]] = Field(default=None, alias="platformMetadata", description="Provider-specific public metadata for this connected account.")
+    profile_id: Optional[str] = Field(default=None, alias="profileId", description="Profile this integration belongs to, or null if it was connected without a profile")
+    app_id: Optional[str] = Field(default=None, alias="appId", description="The OAuth app (customer's own OAuth app) this integration was connected under, or null if postpeer's system app was used.")
+    app: Optional[SubmitLinkedInSelectionIntegrationsApp] = Field(default=None, description="The OAuth app metadata for BYOK integrations, or null when postpeer system app was used.")
+    byok: bool = Field(..., description="True when this integration was connected under the customer's own OAuth app (Bring Your Own Keys), i.e. appId is set. False when postpeer's system app is used.")
+    created_at: datetime = Field(..., alias="createdAt")
+
+
+class SubmitLinkedInSelectionResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    platform: SubmitLinkedInSelectionPlatform
+    message: str
+    redirect_uri: Optional[str] = Field(default=None, alias="redirectUri")
+    integrations: list[SubmitLinkedInSelectionIntegrations]
+
+
+class GetOAuthUrlPlatform(str, Enum):
+    TWITTER = "twitter"
+    INSTAGRAM = "instagram"
+    YOUTUBE = "youtube"
+    TIKTOK = "tiktok"
+    PINTEREST = "pinterest"
+    LINKEDIN = "linkedin"
+    BLUESKY = "bluesky"
+    FACEBOOK = "facebook"
+    THREADS = "threads"
+    GOOGLEBUSINESS = "googlebusiness"
+
+
+class GetOAuthUrlPath(BaseModel):
+    platform: GetOAuthUrlPlatform
+
+
+class GetOAuthUrlQuery(BaseModel):
+    redirect_uri: Optional[AnyUrl] = Field(default=None, alias="redirectUri", description="Final URL to redirect to after the connection completes. In headless mode, this URL also receives selection status query parameters when customer-owned account selection is required.")
+    cancel_redirect_uri: Optional[AnyUrl] = Field(default=None, alias="cancelRedirectUri", description="URL to redirect to when the user cancels or denies the OAuth prompt. Falls back to redirectUri when omitted.")
+    headless: Optional[bool] = Field(default=False, description="When true, platforms that require account selection redirect back to redirectUri with a short-lived selectionToken so you can build your own selection UI. When false, PostPeer hosts the selection UI.")
+    profile_id: Optional[str] = Field(default=None, alias="profileId", description="Profile to associate the resulting integration with. Must belong to the same project. Omit to connect without a profile.")
+    app_id: Optional[str] = Field(default=None, alias="appId", description="Connect under your own OAuth app (Bring Your Own Keys). Pass the id of an OAuth app created via /v1/apps for this same platform. Omit to use postpeer's system app.")
+
+
+class GetOAuthUrlResponse(BaseModel):
+    """Default Response"""
+
+    url: str
+
+
+class ConnectBlueskyBody(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+    identifier: str = Field(..., description='Bluesky handle (e.g. "alice.bsky.social") or DID (e.g. "did:plc:abc123").')
+    password: str = Field(..., description="An app password generated at https://bsky.app/settings/app-passwords. Do NOT use the account password.")
+
+
+class ConnectBlueskyQuery(BaseModel):
+    redirect_uri: Optional[AnyUrl] = Field(default=None, alias="redirectUri", description="Final URL to redirect to after the connection completes. In headless mode, this URL also receives selection status query parameters when customer-owned account selection is required.")
+    cancel_redirect_uri: Optional[AnyUrl] = Field(default=None, alias="cancelRedirectUri", description="URL to redirect to when the user cancels or denies the OAuth prompt. Falls back to redirectUri when omitted.")
+    headless: Optional[bool] = Field(default=False, description="When true, platforms that require account selection redirect back to redirectUri with a short-lived selectionToken so you can build your own selection UI. When false, PostPeer hosts the selection UI.")
+    profile_id: Optional[str] = Field(default=None, alias="profileId", description="Profile to associate the resulting integration with. Must belong to the same project. Omit to connect without a profile.")
+    app_id: Optional[str] = Field(default=None, alias="appId", description="Connect under your own OAuth app (Bring Your Own Keys). Pass the id of an OAuth app created via /v1/apps for this same platform. Omit to use postpeer's system app.")
+
+
+class ListIntegrationsPlatform(str, Enum):
+    TWITTER = "twitter"
+    INSTAGRAM = "instagram"
+    YOUTUBE = "youtube"
+    TIKTOK = "tiktok"
+    PINTEREST = "pinterest"
+    LINKEDIN = "linkedin"
+    BLUESKY = "bluesky"
+    FACEBOOK = "facebook"
+    THREADS = "threads"
+    GOOGLEBUSINESS = "googlebusiness"
+
+
+class ListIntegrationsQuery(BaseModel):
+    platform: Optional[ListIntegrationsPlatform] = None
+    profile_id: Optional[str] = Field(default=None, alias="profileId", description='Filter to integrations belonging to this profile. Pass "null" (literal string) to filter to integrations with no profile.')
+    q: Optional[str] = Field(default=None, description="Case-insensitive search across the connected account name (displayName), username, and platform user ID.")
+    limit: Optional[Annotated[int, Field(ge=1, le=100)]] = Field(default=20, description="Page size (max 100)")
+    offset: Optional[Annotated[int, Field(ge=0)]] = Field(default=0, description="Number of integrations to skip")
+    sort: Optional[SortOrder] = None
+
+
+class ListIntegrationsIntegrationsPlatform(str, Enum):
+    TWITTER = "twitter"
+    INSTAGRAM = "instagram"
+    YOUTUBE = "youtube"
+    TIKTOK = "tiktok"
+    PINTEREST = "pinterest"
+    LINKEDIN = "linkedin"
+    BLUESKY = "bluesky"
+    FACEBOOK = "facebook"
+    THREADS = "threads"
+    GOOGLEBUSINESS = "googlebusiness"
+
+
+class ListIntegrationsIntegrationsApp(BaseModel):
+    id: Optional[str] = None
+    name: Optional[str] = None
+    image_url: Optional[str] = Field(default=None, alias="imageUrl")
+
+
+class ListIntegrationsIntegrations(BaseModel):
+    id: str = Field(..., description="Use this as accountId when creating posts")
+    platform: ListIntegrationsIntegrationsPlatform
+    platform_user_id: Optional[str] = Field(default=None, alias="platformUserId", description="The user ID on the platform, or null if not yet retrieved")
+    username: Optional[str] = Field(default=None, description="The public username or handle, including @ for handle-based platforms")
+    display_name: Optional[str] = Field(default=None, alias="displayName", description="Human-readable display name of the connected account")
+    profile_url: Optional[AnyUrl] = Field(default=None, alias="profileUrl", description="Public profile/page URL for the connected account, when it can be derived")
+    image_url: Optional[AnyUrl] = Field(default=None, alias="imageUrl", description="Profile image URL for the connected account, or null if unavailable")
+    platform_metadata: Optional[dict[str, Any]] = Field(default=None, alias="platformMetadata", description="Provider-specific public metadata for this connected account.")
+    profile_id: Optional[str] = Field(default=None, alias="profileId", description="Profile this integration belongs to, or null if it was connected without a profile")
+    app_id: Optional[str] = Field(default=None, alias="appId", description="The OAuth app (customer's own OAuth app) this integration was connected under, or null if postpeer's system app was used.")
+    app: Optional[ListIntegrationsIntegrationsApp] = Field(default=None, description="The OAuth app metadata for BYOK integrations, or null when postpeer system app was used.")
+    byok: bool = Field(..., description="True when this integration was connected under the customer's own OAuth app (Bring Your Own Keys), i.e. appId is set. False when postpeer's system app is used.")
+    created_at: datetime = Field(..., alias="createdAt")
+
+
+class ListIntegrationsResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    total: Annotated[int, Field(ge=0)] = Field(..., description="Total matched integrations across all pages")
+    integrations: list[ListIntegrationsIntegrations]
+
+
+class DisconnectIntegrationPath(BaseModel):
+    id: str = Field(..., description="Integration ID to disconnect")
+
+
+class DisconnectIntegrationResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    message: str
+
+
+class ListProfilesQuery(BaseModel):
+    page: Optional[Annotated[int, Field(ge=1)]] = 1
+    limit: Optional[Annotated[int, Field(ge=1, le=100)]] = 50
+    name: Optional[Annotated[str, Field(min_length=1, max_length=200)]] = Field(default=None, description="Case-insensitive substring match on profile name")
+
+
+class ListProfilesProfiles(BaseModel):
+    id: str
+    name: str
+    description: Optional[str] = None
+    integration_count: Annotated[int, Field(ge=0)] = Field(..., alias="integrationCount", description="Number of active integrations bound to this profile")
+    created_at: datetime = Field(..., alias="createdAt")
+    updated_at: datetime = Field(..., alias="updatedAt")
+
+
+class ListProfilesResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    total: Annotated[int, Field(ge=0)]
+    page: Annotated[int, Field(ge=1)]
+    limit: Annotated[int, Field(ge=1)]
+    profiles: list[ListProfilesProfiles]
+
+
+class CreateProfileBody(BaseModel):
+    name: Annotated[str, Field(min_length=1, max_length=200)] = Field(..., description='Profile name (e.g. "Acme Co", "Personal Brand")')
+    description: Optional[Annotated[str, Field(max_length=1000)]] = Field(default=None, description="Optional description of what this profile is for")
+
+
+class CreateProfileProfile(BaseModel):
+    id: str
+    name: str
+    description: Optional[str] = None
+    integration_count: Annotated[int, Field(ge=0)] = Field(..., alias="integrationCount", description="Number of active integrations bound to this profile")
+    created_at: datetime = Field(..., alias="createdAt")
+    updated_at: datetime = Field(..., alias="updatedAt")
+
+
+class CreateProfileResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    profile: CreateProfileProfile
+
+
+class DeleteProfilePath(BaseModel):
+    id: str = Field(..., description="Profile ID")
+
+
+class DeleteProfileResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    message: str
+
+
+class GetProfilePath(BaseModel):
+    id: str = Field(..., description="Profile ID")
+
+
+class GetProfileProfile(BaseModel):
+    id: str
+    name: str
+    description: Optional[str] = None
+    integration_count: Annotated[int, Field(ge=0)] = Field(..., alias="integrationCount", description="Number of active integrations bound to this profile")
+    created_at: datetime = Field(..., alias="createdAt")
+    updated_at: datetime = Field(..., alias="updatedAt")
+
+
+class GetProfileResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    profile: GetProfileProfile
+
+
+class UpdateProfileBody(BaseModel):
+    name: Optional[Annotated[str, Field(min_length=1, max_length=200)]] = None
+    description: Optional[Annotated[str, Field(max_length=1000)]] = None
+
+
+class UpdateProfilePath(BaseModel):
+    id: str = Field(..., description="Profile ID")
+
+
+class UpdateProfileProfile(BaseModel):
+    id: str
+    name: str
+    description: Optional[str] = None
+    integration_count: Annotated[int, Field(ge=0)] = Field(..., alias="integrationCount", description="Number of active integrations bound to this profile")
+    created_at: datetime = Field(..., alias="createdAt")
+    updated_at: datetime = Field(..., alias="updatedAt")
+
+
+class UpdateProfileResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    profile: UpdateProfileProfile
+
+
+class ListAppsPlatform(str, Enum):
+    TWITTER = "twitter"
+    INSTAGRAM = "instagram"
+    YOUTUBE = "youtube"
+    TIKTOK = "tiktok"
+    PINTEREST = "pinterest"
+    LINKEDIN = "linkedin"
+    BLUESKY = "bluesky"
+    FACEBOOK = "facebook"
+    THREADS = "threads"
+    GOOGLEBUSINESS = "googlebusiness"
+
+
+class ListAppsQuery(BaseModel):
+    platform: Optional[ListAppsPlatform] = None
+    page: Optional[Annotated[int, Field(ge=1)]] = 1
+    limit: Optional[Annotated[int, Field(ge=1, le=100)]] = 50
+    name: Optional[Annotated[str, Field(min_length=1, max_length=200)]] = Field(default=None, description="Case-insensitive substring match on app name")
+
+
+class ListAppsAppsPlatform(str, Enum):
+    TWITTER = "twitter"
+    INSTAGRAM = "instagram"
+    YOUTUBE = "youtube"
+    TIKTOK = "tiktok"
+    PINTEREST = "pinterest"
+    LINKEDIN = "linkedin"
+    BLUESKY = "bluesky"
+    FACEBOOK = "facebook"
+    THREADS = "threads"
+    GOOGLEBUSINESS = "googlebusiness"
+
+
+class ListAppsApps(BaseModel):
+    id: str = Field(..., description="Pass this as appId when connecting")
+    platform: ListAppsAppsPlatform
+    name: str
+    image_url: Optional[str] = Field(default=None, alias="imageUrl")
+    client_id: str = Field(..., alias="clientId", description="The OAuth app client id. The client secret is never returned.")
+    integration_count: Annotated[int, Field(ge=0)] = Field(..., alias="integrationCount", description="Number of active integrations connected under this app")
+    created_at: datetime = Field(..., alias="createdAt")
+    updated_at: datetime = Field(..., alias="updatedAt")
+
+
+class ListAppsResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    total: Annotated[int, Field(ge=0)]
+    page: Annotated[int, Field(ge=1)]
+    limit: Annotated[int, Field(ge=1)]
+    apps: list[ListAppsApps]
+
+
+class CreateAppPlatform(str, Enum):
+    TWITTER = "twitter"
+    INSTAGRAM = "instagram"
+    YOUTUBE = "youtube"
+    TIKTOK = "tiktok"
+    PINTEREST = "pinterest"
+    LINKEDIN = "linkedin"
+    BLUESKY = "bluesky"
+    FACEBOOK = "facebook"
+    THREADS = "threads"
+    GOOGLEBUSINESS = "googlebusiness"
+
+
+class CreateAppBody(BaseModel):
+    platform: CreateAppPlatform
+    name: Annotated[str, Field(min_length=1, max_length=200)] = Field(..., description='A label for this app (e.g. "Acme Twitter OAuth App")')
+    client_id: Annotated[str, Field(min_length=1)] = Field(..., alias="clientId", description="The client id of your OAuth app for this platform")
+    client_secret: Annotated[str, Field(min_length=1)] = Field(..., alias="clientSecret", description="The client secret of your OAuth app. Stored encrypted.")
+    image_url: Optional[AnyUrl] = Field(default=None, alias="imageUrl", description="Optional icon URL for the app")
+
+
+class CreateAppAppPlatform(str, Enum):
+    TWITTER = "twitter"
+    INSTAGRAM = "instagram"
+    YOUTUBE = "youtube"
+    TIKTOK = "tiktok"
+    PINTEREST = "pinterest"
+    LINKEDIN = "linkedin"
+    BLUESKY = "bluesky"
+    FACEBOOK = "facebook"
+    THREADS = "threads"
+    GOOGLEBUSINESS = "googlebusiness"
+
+
+class CreateAppApp(BaseModel):
+    id: str = Field(..., description="Pass this as appId when connecting")
+    platform: CreateAppAppPlatform
+    name: str
+    image_url: Optional[str] = Field(default=None, alias="imageUrl")
+    client_id: str = Field(..., alias="clientId", description="The OAuth app client id. The client secret is never returned.")
+    integration_count: Annotated[int, Field(ge=0)] = Field(..., alias="integrationCount", description="Number of active integrations connected under this app")
+    created_at: datetime = Field(..., alias="createdAt")
+    updated_at: datetime = Field(..., alias="updatedAt")
+
+
+class CreateAppResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    app: CreateAppApp
+
+
+class DeleteAppPath(BaseModel):
+    id: str = Field(..., description="OAuth app ID")
+
+
+class DeleteAppResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    message: str
+
+
+class GetAppPath(BaseModel):
+    id: str = Field(..., description="OAuth app ID")
+
+
+class GetAppAppPlatform(str, Enum):
+    TWITTER = "twitter"
+    INSTAGRAM = "instagram"
+    YOUTUBE = "youtube"
+    TIKTOK = "tiktok"
+    PINTEREST = "pinterest"
+    LINKEDIN = "linkedin"
+    BLUESKY = "bluesky"
+    FACEBOOK = "facebook"
+    THREADS = "threads"
+    GOOGLEBUSINESS = "googlebusiness"
+
+
+class GetAppApp(BaseModel):
+    id: str = Field(..., description="Pass this as appId when connecting")
+    platform: GetAppAppPlatform
+    name: str
+    image_url: Optional[str] = Field(default=None, alias="imageUrl")
+    client_id: str = Field(..., alias="clientId", description="The OAuth app client id. The client secret is never returned.")
+    integration_count: Annotated[int, Field(ge=0)] = Field(..., alias="integrationCount", description="Number of active integrations connected under this app")
+    created_at: datetime = Field(..., alias="createdAt")
+    updated_at: datetime = Field(..., alias="updatedAt")
+
+
+class GetAppResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    app: GetAppApp
+
+
+class UpdateAppBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    name: Optional[Annotated[str, Field(min_length=1, max_length=200)]] = None
+    image_url: Optional[str] = Field(default=None, alias="imageUrl")
+    client_secret: Optional[Annotated[str, Field(min_length=1)]] = Field(default=None, alias="clientSecret", description="Rotate the stored client secret. The clientId stays the same so existing tokens keep working — to switch to a different app, create a new OAuth app and reconnect.")
+
+
+class UpdateAppPath(BaseModel):
+    id: str = Field(..., description="OAuth app ID")
+
+
+class UpdateAppAppPlatform(str, Enum):
+    TWITTER = "twitter"
+    INSTAGRAM = "instagram"
+    YOUTUBE = "youtube"
+    TIKTOK = "tiktok"
+    PINTEREST = "pinterest"
+    LINKEDIN = "linkedin"
+    BLUESKY = "bluesky"
+    FACEBOOK = "facebook"
+    THREADS = "threads"
+    GOOGLEBUSINESS = "googlebusiness"
+
+
+class UpdateAppApp(BaseModel):
+    id: str = Field(..., description="Pass this as appId when connecting")
+    platform: UpdateAppAppPlatform
+    name: str
+    image_url: Optional[str] = Field(default=None, alias="imageUrl")
+    client_id: str = Field(..., alias="clientId", description="The OAuth app client id. The client secret is never returned.")
+    integration_count: Annotated[int, Field(ge=0)] = Field(..., alias="integrationCount", description="Number of active integrations connected under this app")
+    created_at: datetime = Field(..., alias="createdAt")
+    updated_at: datetime = Field(..., alias="updatedAt")
+
+
+class UpdateAppResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    app: UpdateAppApp
+
+
+class TestNotificationChannel(str, Enum):
+    WEBHOOK = "webhook"
+    EMAIL = "email"
+
+
+class TestNotificationWebhook(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+    url: AnyUrl = Field(..., description="HTTPS endpoint that receives PostPeer JSON payloads")
+
+
+class TestNotificationEmail(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+    recipients: Annotated[list[EmailStr], Field(min_length=1, max_length=10)]
+
+
+class TestNotificationBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    channel: TestNotificationChannel
+    profile_id: Optional[str] = Field(default=None, alias="profileId")
+    webhook: Optional[TestNotificationWebhook] = None
+    email: Optional[TestNotificationEmail] = None
+
+
+class TestNotificationResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    message: str
+
+
+class ListNotificationsNotificationsChannel(str, Enum):
+    WEBHOOK = "webhook"
+    EMAIL = "email"
+
+
+class ListNotificationsNotificationsEventTypes(str, Enum):
+    POST_SCHEDULED = "post.scheduled"
+    POST_PUBLISHED = "post.published"
+    POST_PARTIAL = "post.partial"
+    POST_FAILED = "post.failed"
+
+
+class ListNotificationsNotificationsWebhook(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+    url: AnyUrl
+    secret: str = Field(..., description="Webhook signing secret (masked in list responses)")
+
+
+class ListNotificationsNotificationsEmail(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+    recipients: Annotated[list[EmailStr], Field(min_length=1, max_length=10)]
+
+
+class ListNotificationsNotifications(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    id: str
+    channel: ListNotificationsNotificationsChannel
+    profile_id: Optional[str] = Field(default=None, alias="profileId")
+    event_types: list[ListNotificationsNotificationsEventTypes] = Field(..., alias="eventTypes")
+    only_scheduled_posts: bool = Field(..., alias="onlyScheduledPosts")
+    enabled: bool
+    webhook: Optional[ListNotificationsNotificationsWebhook] = None
+    email: Optional[ListNotificationsNotificationsEmail] = None
+    last_test_at: Optional[datetime] = Field(default=None, alias="lastTestAt")
+    last_test_status: Optional[str] = Field(default=None, alias="lastTestStatus")
+    created_at: datetime = Field(..., alias="createdAt")
+    updated_at: datetime = Field(..., alias="updatedAt")
+
+
+class ListNotificationsResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    notifications: list[ListNotificationsNotifications]
+
+
+class CreateNotificationChannel(str, Enum):
+    WEBHOOK = "webhook"
+    EMAIL = "email"
+
+
+class CreateNotificationEventTypes(str, Enum):
+    POST_SCHEDULED = "post.scheduled"
+    POST_PUBLISHED = "post.published"
+    POST_PARTIAL = "post.partial"
+    POST_FAILED = "post.failed"
+
+
+class CreateNotificationWebhook(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+    url: AnyUrl = Field(..., description="HTTPS endpoint that receives PostPeer JSON payloads")
+
+
+class CreateNotificationEmail(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+    recipients: Annotated[list[EmailStr], Field(min_length=1, max_length=10)]
+
+
+class CreateNotificationBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    channel: CreateNotificationChannel
+    profile_id: Optional[str] = Field(default=None, alias="profileId")
+    event_types: Annotated[list[CreateNotificationEventTypes], Field(min_length=1)] = Field(..., alias="eventTypes")
+    only_scheduled_posts: Optional[bool] = Field(default=False, alias="onlyScheduledPosts", description="When true, deliver matching notifications only for posts that were scheduled.")
+    enabled: Optional[bool] = True
+    webhook: Optional[CreateNotificationWebhook] = None
+    email: Optional[CreateNotificationEmail] = None
+
+
+class CreateNotificationNotificationChannel(str, Enum):
+    WEBHOOK = "webhook"
+    EMAIL = "email"
+
+
+class CreateNotificationNotificationEventTypes(str, Enum):
+    POST_SCHEDULED = "post.scheduled"
+    POST_PUBLISHED = "post.published"
+    POST_PARTIAL = "post.partial"
+    POST_FAILED = "post.failed"
+
+
+class CreateNotificationNotificationWebhook(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+    url: AnyUrl
+    secret: str = Field(..., description="Webhook signing secret (masked in list responses)")
+
+
+class CreateNotificationNotificationEmail(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+    recipients: Annotated[list[EmailStr], Field(min_length=1, max_length=10)]
+
+
+class CreateNotificationNotification(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    id: str
+    channel: CreateNotificationNotificationChannel
+    profile_id: Optional[str] = Field(default=None, alias="profileId")
+    event_types: list[CreateNotificationNotificationEventTypes] = Field(..., alias="eventTypes")
+    only_scheduled_posts: bool = Field(..., alias="onlyScheduledPosts")
+    enabled: bool
+    webhook: Optional[CreateNotificationNotificationWebhook] = None
+    email: Optional[CreateNotificationNotificationEmail] = None
+    last_test_at: Optional[datetime] = Field(default=None, alias="lastTestAt")
+    last_test_status: Optional[str] = Field(default=None, alias="lastTestStatus")
+    created_at: datetime = Field(..., alias="createdAt")
+    updated_at: datetime = Field(..., alias="updatedAt")
+
+
+class CreateNotificationResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    notification: CreateNotificationNotification
+
+
+class DeleteNotificationPath(BaseModel):
+    id: str = Field(..., description="Notification subscription ID")
+
+
+class DeleteNotificationResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    message: str
+
+
+class GetNotificationPath(BaseModel):
+    id: str = Field(..., description="Notification subscription ID")
+
+
+class GetNotificationNotificationChannel(str, Enum):
+    WEBHOOK = "webhook"
+    EMAIL = "email"
+
+
+class GetNotificationNotificationEventTypes(str, Enum):
+    POST_SCHEDULED = "post.scheduled"
+    POST_PUBLISHED = "post.published"
+    POST_PARTIAL = "post.partial"
+    POST_FAILED = "post.failed"
+
+
+class GetNotificationNotificationWebhook(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+    url: AnyUrl
+    secret: str = Field(..., description="Webhook signing secret (masked in list responses)")
+
+
+class GetNotificationNotificationEmail(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+    recipients: Annotated[list[EmailStr], Field(min_length=1, max_length=10)]
+
+
+class GetNotificationNotification(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    id: str
+    channel: GetNotificationNotificationChannel
+    profile_id: Optional[str] = Field(default=None, alias="profileId")
+    event_types: list[GetNotificationNotificationEventTypes] = Field(..., alias="eventTypes")
+    only_scheduled_posts: bool = Field(..., alias="onlyScheduledPosts")
+    enabled: bool
+    webhook: Optional[GetNotificationNotificationWebhook] = None
+    email: Optional[GetNotificationNotificationEmail] = None
+    last_test_at: Optional[datetime] = Field(default=None, alias="lastTestAt")
+    last_test_status: Optional[str] = Field(default=None, alias="lastTestStatus")
+    created_at: datetime = Field(..., alias="createdAt")
+    updated_at: datetime = Field(..., alias="updatedAt")
+
+
+class GetNotificationResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    notification: GetNotificationNotification
+
+
+class UpdateNotificationEventTypes(str, Enum):
+    POST_SCHEDULED = "post.scheduled"
+    POST_PUBLISHED = "post.published"
+    POST_PARTIAL = "post.partial"
+    POST_FAILED = "post.failed"
+
+
+class UpdateNotificationWebhook(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+    url: AnyUrl = Field(..., description="HTTPS endpoint that receives PostPeer JSON payloads")
+
+
+class UpdateNotificationEmail(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+    recipients: Annotated[list[EmailStr], Field(min_length=1, max_length=10)]
+
+
+class UpdateNotificationBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    profile_id: Optional[str] = Field(default=None, alias="profileId")
+    event_types: Optional[Annotated[list[UpdateNotificationEventTypes], Field(min_length=1)]] = Field(default=None, alias="eventTypes")
+    only_scheduled_posts: Optional[bool] = Field(default=None, alias="onlyScheduledPosts", description="When true, deliver matching notifications only for posts that were scheduled.")
+    enabled: Optional[bool] = None
+    webhook: Optional[UpdateNotificationWebhook] = None
+    email: Optional[UpdateNotificationEmail] = None
+
+
+class UpdateNotificationPath(BaseModel):
+    id: str = Field(..., description="Notification subscription ID")
+
+
+class UpdateNotificationNotificationChannel(str, Enum):
+    WEBHOOK = "webhook"
+    EMAIL = "email"
+
+
+class UpdateNotificationNotificationEventTypes(str, Enum):
+    POST_SCHEDULED = "post.scheduled"
+    POST_PUBLISHED = "post.published"
+    POST_PARTIAL = "post.partial"
+    POST_FAILED = "post.failed"
+
+
+class UpdateNotificationNotificationWebhook(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+    url: AnyUrl
+    secret: str = Field(..., description="Webhook signing secret (masked in list responses)")
+
+
+class UpdateNotificationNotificationEmail(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+    recipients: Annotated[list[EmailStr], Field(min_length=1, max_length=10)]
+
+
+class UpdateNotificationNotification(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    id: str
+    channel: UpdateNotificationNotificationChannel
+    profile_id: Optional[str] = Field(default=None, alias="profileId")
+    event_types: list[UpdateNotificationNotificationEventTypes] = Field(..., alias="eventTypes")
+    only_scheduled_posts: bool = Field(..., alias="onlyScheduledPosts")
+    enabled: bool
+    webhook: Optional[UpdateNotificationNotificationWebhook] = None
+    email: Optional[UpdateNotificationNotificationEmail] = None
+    last_test_at: Optional[datetime] = Field(default=None, alias="lastTestAt")
+    last_test_status: Optional[str] = Field(default=None, alias="lastTestStatus")
+    created_at: datetime = Field(..., alias="createdAt")
+    updated_at: datetime = Field(..., alias="updatedAt")
+
+
+class UpdateNotificationResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    notification: UpdateNotificationNotification
+
+
+class ListPlatformsPlatformsName(str, Enum):
+    TWITTER = "twitter"
+    INSTAGRAM = "instagram"
+    YOUTUBE = "youtube"
+    TIKTOK = "tiktok"
+    PINTEREST = "pinterest"
+    LINKEDIN = "linkedin"
+    BLUESKY = "bluesky"
+    FACEBOOK = "facebook"
+    THREADS = "threads"
+    GOOGLEBUSINESS = "googlebusiness"
+
+
+class ListPlatformsPlatformsStatus(str, Enum):
+    PROD = "prod"
+    BETA = "beta"
+    DEV = "dev"
+
+
+class ListPlatformsPlatforms(BaseModel):
+    name: ListPlatformsPlatformsName
+    status: ListPlatformsPlatformsStatus
+
+
+class ListPlatformsResponse(BaseModel):
+    """Default Response"""
+
+    platforms: list[ListPlatformsPlatforms]
+
+
+class ListPostsStatus(str, Enum):
+    DRAFT = "draft"
+    PENDING = "pending"
+    SCHEDULED = "scheduled"
+    PUBLISHING = "publishing"
+    PUBLISHED = "published"
+    FAILED = "failed"
+    PARTIAL = "partial"
+
+
+class ListPostsPlatform(str, Enum):
+    TWITTER = "twitter"
+    INSTAGRAM = "instagram"
+    YOUTUBE = "youtube"
+    TIKTOK = "tiktok"
+    PINTEREST = "pinterest"
+    LINKEDIN = "linkedin"
+    BLUESKY = "bluesky"
+    FACEBOOK = "facebook"
+    THREADS = "threads"
+    GOOGLEBUSINESS = "googlebusiness"
+
+
+class ListPostsQuery(BaseModel):
+    status: Optional[ListPostsStatus] = None
+    platform: Optional[list[ListPostsPlatform]] = Field(default=None, description="Filter by platform (repeatable — OR logic)")
+    profile_id: Optional[str] = Field(default=None, alias="profileId", description='Filter to posts targeting an integration bound to this profile. Pass "null" (literal string) to filter to posts whose integrations have no profile.')
+    created_after: Optional[datetime] = Field(default=None, alias="createdAfter", description="ISO 8601 lower bound on createdAt")
+    created_before: Optional[datetime] = Field(default=None, alias="createdBefore", description="ISO 8601 upper bound on createdAt")
+    scheduled_after: Optional[datetime] = Field(default=None, alias="scheduledAfter", description="ISO 8601 lower bound on scheduledFor")
+    scheduled_before: Optional[datetime] = Field(default=None, alias="scheduledBefore", description="ISO 8601 upper bound on scheduledFor")
+    limit: Optional[Annotated[int, Field(ge=1, le=100)]] = Field(default=20, description="Page size (max 100)")
+    offset: Optional[Annotated[int, Field(ge=0)]] = Field(default=0, description="Number of posts to skip")
+    sort: Optional[SortOrder] = None
+
+
+class ListPostsPostsStatus(str, Enum):
+    DRAFT = "draft"
+    PENDING = "pending"
+    SCHEDULED = "scheduled"
+    PUBLISHING = "publishing"
+    PUBLISHED = "published"
+    FAILED = "failed"
+    PARTIAL = "partial"
+
+
+class ListPostsPostsMediaItemsType(str, Enum):
+    IMAGE = "image"
+    VIDEO = "video"
+    GIF = "gif"
+
+
+class ListPostsPostsMediaItems(BaseModel):
+    type: ListPostsPostsMediaItemsType
+    url: str
+    filename: str
+    size: float
+    mime_type: str = Field(..., alias="mimeType")
+
+
+class ListPostsPostsPlatformsPlatform(str, Enum):
+    TWITTER = "twitter"
+    INSTAGRAM = "instagram"
+    YOUTUBE = "youtube"
+    TIKTOK = "tiktok"
+    PINTEREST = "pinterest"
+    LINKEDIN = "linkedin"
+    BLUESKY = "bluesky"
+    FACEBOOK = "facebook"
+    THREADS = "threads"
+    GOOGLEBUSINESS = "googlebusiness"
+
+
+class ListPostsPostsPlatformsStatus(str, Enum):
+    DRAFT = "draft"
+    PENDING = "pending"
+    SCHEDULED = "scheduled"
+    PUBLISHING = "publishing"
+    PUBLISHED = "published"
+    FAILED = "failed"
+    PARTIAL = "partial"
+
+
+class ListPostsPostsPlatforms(BaseModel):
+    platform: ListPostsPostsPlatformsPlatform
+    status: ListPostsPostsPlatformsStatus
+    content: Optional[str] = Field(default=None, description="Per-platform text override that was used for this platform. Null when the top-level `content` was used.")
+    platform_post_id: Optional[str] = Field(default=None, alias="platformPostId")
+    platform_post_url: Optional[str] = Field(default=None, alias="platformPostUrl", description="Direct URL to the published post")
+    published_at: Optional[datetime] = Field(default=None, alias="publishedAt")
+    error_message: Optional[str] = Field(default=None, alias="errorMessage")
+    warning_message: Optional[str] = Field(default=None, alias="warningMessage")
+
+
+class ListPostsPosts(BaseModel):
+    post_id: str = Field(..., alias="postId", description="MongoDB ObjectId of the Post document")
+    content: str
+    status: ListPostsPostsStatus
+    scheduled_for: Optional[datetime] = Field(default=None, alias="scheduledFor", description="ISO 8601 scheduled datetime")
+    timezone: str
+    media_items: list[ListPostsPostsMediaItems] = Field(..., alias="mediaItems")
+    platforms: list[ListPostsPostsPlatforms]
+    crossposting_enabled: bool = Field(..., alias="crosspostingEnabled")
+    raw_request_body: dict[str, Any] = Field(..., alias="rawRequestBody")
+    created_at: datetime = Field(..., alias="createdAt")
+    updated_at: datetime = Field(..., alias="updatedAt")
+
+
+class ListPostsResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    total: Annotated[int, Field(ge=0)] = Field(..., description="Total matched posts across all pages")
+    posts: list[ListPostsPosts]
+
+
+class CreatePostMediaItemsType(str, Enum):
+    IMAGE = "image"
+    VIDEO = "video"
+    GIF = "gif"
+    DOCUMENT = "document"
+
+
+class CreatePostMediaItems(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+    type: CreatePostMediaItemsType
+    url: AnyUrl
+    thumbnail: Optional[AnyUrl] = Field(default=None, description="Thumbnail image URL for video items. Supported on YouTube regular videos (not Shorts). JPEG, PNG, or GIF, max 2 MB, min 640 px wide.")
+
+
+class CreatePostPlatformsPlatform(str, Enum):
+    TWITTER = "twitter"
+
+
+class CreatePostPlatforms(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    platform: CreatePostPlatformsPlatform
+    account_id: str = Field(..., alias="accountId", description="Integration._id — find yours via GET /connect/integrations")
+    content: Optional[str] = Field(default=None, description="Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.")
+    platform_specific_data: Optional[TwitterConfigurations] = Field(default=None, alias="platformSpecificData")
+
+
+class CreatePostPlatformsPlatform_(str, Enum):
+    INSTAGRAM = "instagram"
+
+
+class CreatePostPlatforms_(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    platform: CreatePostPlatformsPlatform_
+    account_id: str = Field(..., alias="accountId", description="Integration._id — find yours via GET /connect/integrations")
+    content: Optional[str] = Field(default=None, description="Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.")
+    platform_specific_data: Optional[InstagramConfigurations] = Field(default=None, alias="platformSpecificData")
+
+
+class CreatePostPlatformsPlatform_2(str, Enum):
+    YOUTUBE = "youtube"
+
+
+class CreatePostPlatforms_2(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    platform: CreatePostPlatformsPlatform_2
+    account_id: str = Field(..., alias="accountId", description="Integration._id — find yours via GET /connect/integrations")
+    content: Optional[str] = Field(default=None, description="Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.")
+    platform_specific_data: Optional[YouTubeConfigurations] = Field(default=None, alias="platformSpecificData")
+
+
+class CreatePostPlatformsPlatform_3(str, Enum):
+    TIKTOK = "tiktok"
+
+
+class CreatePostPlatforms_3(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    platform: CreatePostPlatformsPlatform_3
+    account_id: str = Field(..., alias="accountId", description="Integration._id — find yours via GET /connect/integrations")
+    content: Optional[str] = Field(default=None, description="Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.")
+    platform_specific_data: Optional[TikTokConfigurations] = Field(default=None, alias="platformSpecificData")
+
+
+class CreatePostPlatformsPlatform_4(str, Enum):
+    PINTEREST = "pinterest"
+
+
+class CreatePostPlatforms_4(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    platform: CreatePostPlatformsPlatform_4
+    account_id: str = Field(..., alias="accountId", description="Integration._id — find yours via GET /connect/integrations")
+    content: Optional[str] = Field(default=None, description="Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.")
+    platform_specific_data: Optional[PinterestConfigurations] = Field(default=None, alias="platformSpecificData")
+
+
+class CreatePostPlatformsPlatform_5(str, Enum):
+    LINKEDIN = "linkedin"
+
+
+class CreatePostPlatforms_5(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    platform: CreatePostPlatformsPlatform_5
+    account_id: str = Field(..., alias="accountId", description="Integration._id — find yours via GET /connect/integrations")
+    content: Optional[str] = Field(default=None, description="Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.")
+    platform_specific_data: Optional[LinkedInConfigurations] = Field(default=None, alias="platformSpecificData")
+
+
+class CreatePostPlatformsPlatform_6(str, Enum):
+    BLUESKY = "bluesky"
+
+
+class CreatePostPlatforms_6(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    platform: CreatePostPlatformsPlatform_6
+    account_id: str = Field(..., alias="accountId", description="Integration._id — find yours via GET /connect/integrations")
+    content: Optional[str] = Field(default=None, description="Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.")
+    platform_specific_data: Optional[BlueskyConfigurations] = Field(default=None, alias="platformSpecificData")
+
+
+class CreatePostPlatformsPlatform_7(str, Enum):
+    FACEBOOK = "facebook"
+
+
+class CreatePostPlatforms_7(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    platform: CreatePostPlatformsPlatform_7
+    account_id: str = Field(..., alias="accountId", description="Integration._id — find yours via GET /connect/integrations")
+    content: Optional[str] = Field(default=None, description="Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.")
+    platform_specific_data: Optional[FacebookConfigurations] = Field(default=None, alias="platformSpecificData")
+
+
+class CreatePostPlatformsPlatform_8(str, Enum):
+    THREADS = "threads"
+
+
+class CreatePostPlatforms_8(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    platform: CreatePostPlatformsPlatform_8
+    account_id: str = Field(..., alias="accountId", description="Integration._id — find yours via GET /connect/integrations")
+    content: Optional[str] = Field(default=None, description="Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.")
+    platform_specific_data: Optional[ThreadsConfigurations] = Field(default=None, alias="platformSpecificData")
+
+
+class CreatePostPlatformsPlatform_9(str, Enum):
+    GOOGLEBUSINESS = "googlebusiness"
+
+
+class CreatePostPlatforms_9(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    platform: CreatePostPlatformsPlatform_9
+    account_id: str = Field(..., alias="accountId", description="Integration._id — find yours via GET /connect/integrations")
+    content: Optional[str] = Field(default=None, description="Optional per-platform text override. Use when you want to change the text for this platform because different platforms talk differently. When omitted, the top-level `content` is used.")
+    platform_specific_data: Optional[GoogleBusinessConfigurations] = Field(default=None, alias="platformSpecificData")
+
+
+class CreatePostBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    content: str = Field(..., description="Post text body")
+    media_items: Optional[list[CreatePostMediaItems]] = Field(default=None, alias="mediaItems", description="Media attachments (images, videos, GIFs)")
+    platforms: Annotated[list[Union[CreatePostPlatforms, CreatePostPlatforms_, CreatePostPlatforms_2, CreatePostPlatforms_3, CreatePostPlatforms_4, CreatePostPlatforms_5, CreatePostPlatforms_6, CreatePostPlatforms_7, CreatePostPlatforms_8, CreatePostPlatforms_9]], Field(min_length=1)] = Field(..., description="Target platform accounts to publish to")
+    publish_now: Optional[bool] = Field(default=None, alias="publishNow", description="Publish immediately. Required when scheduledFor is omitted.")
+    scheduled_for: Optional[datetime] = Field(default=None, alias="scheduledFor", description="ISO 8601 datetime to schedule the post for future publishing")
+    timezone: Optional[str] = Field(default=None, description="IANA timezone for the scheduled time (e.g. America/New_York). Defaults to UTC.")
+
+
+class CreatePostStatus(str, Enum):
+    DRAFT = "draft"
+    PENDING = "pending"
+    SCHEDULED = "scheduled"
+    PUBLISHING = "publishing"
+    PUBLISHED = "published"
+    FAILED = "failed"
+    PARTIAL = "partial"
+
+
+class CreatePostPlatformsPlatform_10(str, Enum):
+    TWITTER = "twitter"
+    INSTAGRAM = "instagram"
+    YOUTUBE = "youtube"
+    TIKTOK = "tiktok"
+    PINTEREST = "pinterest"
+    LINKEDIN = "linkedin"
+    BLUESKY = "bluesky"
+    FACEBOOK = "facebook"
+    THREADS = "threads"
+    GOOGLEBUSINESS = "googlebusiness"
+
+
+class CreatePostPlatforms_10(BaseModel):
+    platform: CreatePostPlatformsPlatform_10
+    success: bool = Field(..., description="For publish-now timeout fallback, true means the platform target was accepted and final status is still pending.")
+    platform_post_url: Optional[str] = Field(default=None, alias="platformPostUrl", description="Direct URL to the published post")
+    error: Optional[str] = Field(default=None, description="Error message when success is false")
+    warning_message: Optional[str] = Field(default=None, alias="warningMessage", description="Warning message when the post published but a non-critical follow-up action failed")
+
+
+class CreatePostResponse(BaseModel):
+    """Default Response"""
+
+    success: bool = Field(..., description="false only when every platform failed")
+    status: CreatePostStatus
+    scheduled_for: Optional[datetime] = Field(default=None, alias="scheduledFor", description="ISO 8601 datetime the post is scheduled for (only present for scheduled posts)")
+    post_id: str = Field(..., alias="postId", description="id of the saved Post document")
+    platforms: list[CreatePostPlatforms_10]
+
+
+class DeletePostPath(BaseModel):
+    post_id: str = Field(..., alias="postId", description="Post identifier")
+
+
+class DeletePostQuery(BaseModel):
+    delete_from_platforms: Optional[bool] = Field(default=False, alias="deleteFromPlatforms", description="When true, also delete supported published platform posts. Costs 1 credit per successful platform deletion.")
+
+
+class DeletePostPlatforms(BaseModel):
+    platform: str
+    integration_id: str = Field(..., alias="integrationId")
+    platform_post_id: Optional[str] = Field(default=None, alias="platformPostId")
+    status: str
+    success: bool
+    message: Optional[str] = None
+    error_message: Optional[str] = Field(default=None, alias="errorMessage")
+
+
+class DeletePostResponse(BaseModel):
+    """Default Response"""
+
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    success: bool
+    credits_charged: Optional[Annotated[int, Field(ge=0)]] = Field(default=None, alias="creditsCharged")
+    platforms: Optional[list[DeletePostPlatforms]] = None
+
+
+class GetPostPath(BaseModel):
+    post_id: str = Field(..., alias="postId", description="Post identifier")
+
+
+class GetPostPostStatus(str, Enum):
+    DRAFT = "draft"
+    PENDING = "pending"
+    SCHEDULED = "scheduled"
+    PUBLISHING = "publishing"
+    PUBLISHED = "published"
+    FAILED = "failed"
+    PARTIAL = "partial"
+
+
+class GetPostPostMediaItemsType(str, Enum):
+    IMAGE = "image"
+    VIDEO = "video"
+    GIF = "gif"
+
+
+class GetPostPostMediaItems(BaseModel):
+    type: GetPostPostMediaItemsType
+    url: str
+    filename: str
+    size: float
+    mime_type: str = Field(..., alias="mimeType")
+
+
+class GetPostPostPlatformsPlatform(str, Enum):
+    TWITTER = "twitter"
+    INSTAGRAM = "instagram"
+    YOUTUBE = "youtube"
+    TIKTOK = "tiktok"
+    PINTEREST = "pinterest"
+    LINKEDIN = "linkedin"
+    BLUESKY = "bluesky"
+    FACEBOOK = "facebook"
+    THREADS = "threads"
+    GOOGLEBUSINESS = "googlebusiness"
+
+
+class GetPostPostPlatformsStatus(str, Enum):
+    DRAFT = "draft"
+    PENDING = "pending"
+    SCHEDULED = "scheduled"
+    PUBLISHING = "publishing"
+    PUBLISHED = "published"
+    FAILED = "failed"
+    PARTIAL = "partial"
+
+
+class GetPostPostPlatforms(BaseModel):
+    platform: GetPostPostPlatformsPlatform
+    status: GetPostPostPlatformsStatus
+    content: Optional[str] = Field(default=None, description="Per-platform text override that was used for this platform. Null when the top-level `content` was used.")
+    platform_post_id: Optional[str] = Field(default=None, alias="platformPostId")
+    platform_post_url: Optional[str] = Field(default=None, alias="platformPostUrl", description="Direct URL to the published post")
+    published_at: Optional[datetime] = Field(default=None, alias="publishedAt")
+    error_message: Optional[str] = Field(default=None, alias="errorMessage")
+    warning_message: Optional[str] = Field(default=None, alias="warningMessage")
+
+
+class GetPostPost(BaseModel):
+    post_id: str = Field(..., alias="postId", description="MongoDB ObjectId of the Post document")
+    content: str
+    status: GetPostPostStatus
+    scheduled_for: Optional[datetime] = Field(default=None, alias="scheduledFor", description="ISO 8601 scheduled datetime")
+    timezone: str
+    media_items: list[GetPostPostMediaItems] = Field(..., alias="mediaItems")
+    platforms: list[GetPostPostPlatforms]
+    crossposting_enabled: bool = Field(..., alias="crosspostingEnabled")
+    raw_request_body: dict[str, Any] = Field(..., alias="rawRequestBody")
+    created_at: datetime = Field(..., alias="createdAt")
+    updated_at: datetime = Field(..., alias="updatedAt")
+
+
+class GetPostResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    post: GetPostPost
+
+
+class ListScheduledPostsQuery(BaseModel):
+    limit: Optional[Annotated[int, Field(ge=1, le=100)]] = Field(default=20, description="Page size (max 100)")
+    offset: Optional[Annotated[int, Field(ge=0)]] = Field(default=0, description="Number of scheduled posts to skip")
+    sort: Optional[SortOrder] = None
+
+
+class ListScheduledPostsPostsMediaItemsType(str, Enum):
+    IMAGE = "image"
+    VIDEO = "video"
+    GIF = "gif"
+    DOCUMENT = "document"
+
+
+class ListScheduledPostsPostsMediaItems(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+    type: ListScheduledPostsPostsMediaItemsType
+    url: AnyUrl
+    thumbnail: Optional[AnyUrl] = Field(default=None, description="Thumbnail image URL for video items. Supported on YouTube regular videos (not Shorts). JPEG, PNG, or GIF, max 2 MB, min 640 px wide.")
+
+
+class ListScheduledPostsPostsPlatformsPlatform(str, Enum):
+    TWITTER = "twitter"
+    INSTAGRAM = "instagram"
+    YOUTUBE = "youtube"
+    TIKTOK = "tiktok"
+    PINTEREST = "pinterest"
+    LINKEDIN = "linkedin"
+    BLUESKY = "bluesky"
+    FACEBOOK = "facebook"
+    THREADS = "threads"
+    GOOGLEBUSINESS = "googlebusiness"
+
+
+class ListScheduledPostsPostsPlatformsStatus(str, Enum):
+    DRAFT = "draft"
+    PENDING = "pending"
+    SCHEDULED = "scheduled"
+    PUBLISHING = "publishing"
+    PUBLISHED = "published"
+    FAILED = "failed"
+    PARTIAL = "partial"
+
+
+class ListScheduledPostsPostsPlatforms(BaseModel):
+    platform: ListScheduledPostsPostsPlatformsPlatform
+    status: ListScheduledPostsPostsPlatformsStatus
+
+
+class ListScheduledPostsPosts(BaseModel):
+    post_id: str = Field(..., alias="postId", description="MongoDB ObjectId of the Post document")
+    content: str = Field(..., description="Post text body")
+    scheduled_for: Optional[datetime] = Field(default=None, alias="scheduledFor", description="ISO 8601 scheduled datetime")
+    timezone: str = Field(..., description="IANA timezone for the scheduled time")
+    media_items: Optional[list[ListScheduledPostsPostsMediaItems]] = Field(default=None, alias="mediaItems", description="Media attachments")
+    platforms: list[ListScheduledPostsPostsPlatforms]
+    created_at: datetime = Field(..., alias="createdAt")
+
+
+class ListScheduledPostsResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    total: Annotated[int, Field(ge=0)] = Field(..., description="Total matched scheduled posts across all pages")
+    posts: list[ListScheduledPostsPosts]
+
+
+class CancelScheduledPostPath(BaseModel):
+    post_id: str = Field(..., alias="postId")
+
+
+class CancelScheduledPostResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    message: str
+
+
+class ReschedulePostBody(BaseModel):
+    scheduled_for: datetime = Field(..., alias="scheduledFor", description="New ISO 8601 datetime to schedule the post")
+    timezone: Optional[str] = Field(default=None, description="IANA timezone")
+
+
+class ReschedulePostPath(BaseModel):
+    post_id: str = Field(..., alias="postId")
+
+
+class ReschedulePostResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    message: str
+    scheduled_for: str = Field(..., alias="scheduledFor")
+
+
+class CreateMediaUploadBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    filename: Annotated[str, Field(min_length=1)]
+    mime_type: Annotated[str, Field(min_length=1)] = Field(..., alias="mimeType")
+
+
+class CreateMediaUploadData(BaseModel):
+    upload_url: str = Field(..., alias="uploadUrl")
+    public_url: str = Field(..., alias="publicUrl")
+
+
+class CreateMediaUploadResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    data: CreateMediaUploadData
+
+
+class GetAnalyticsSource(str, Enum):
+    """Where the result came from. "postpeer" = posts published via PostPeer (stored in our DB). "platform" = fetched directly from the connected platform account."""
+
+    POSTPEER = "postpeer"
+    PLATFORM = "platform"
+
+
+class GetAnalyticsSortBy(str, Enum):
+    """Sort results by this metric"""
+
+    DATE = "date"
+    LIKES = "likes"
+    COMMENTS = "comments"
+    IMPRESSIONS = "impressions"
+    VIEWS = "views"
+    SHARES = "shares"
+    SAVES = "saves"
+    CLICKS = "clicks"
+    ENGAGEMENT = "engagement"
+
+
+class GetAnalyticsQuery(BaseModel):
+    post_id: Optional[str] = Field(default=None, alias="postId", description="PostPeer post ID or external platform post ID (auto-resolved). When omitted, returns a paginated list of all published posts with analytics.")
+    platform: Optional[Platform] = None
+    account_id: Optional[str] = Field(default=None, alias="accountId", description="Integration ID. Required for external ID lookups and source=platform.")
+    source: Optional[GetAnalyticsSource] = Field(default=None, description='Where the result came from. "postpeer" = posts published via PostPeer (stored in our DB). "platform" = fetched directly from the connected platform account.')
+    from_date: Optional[date] = Field(default=None, alias="fromDate", description="Inclusive start date (YYYY-MM-DD). Defaults to 90 days ago.")
+    to_date: Optional[date] = Field(default=None, alias="toDate", description="Inclusive end date (YYYY-MM-DD). Defaults to today.")
+    sort_by: Optional[GetAnalyticsSortBy] = Field(default=None, alias="sortBy", description="Sort results by this metric")
+    order: Optional[SortOrder] = None
+    limit: Optional[Annotated[int, Field(ge=1, le=100)]] = Field(default=50, description="Page size (1-100)")
+    page: Optional[Annotated[int, Field(ge=1)]] = Field(default=1, description="Page number")
+
+
+class GetAnalyticsPostSource(str, Enum):
+    """Where the result came from. "postpeer" = posts published via PostPeer (stored in our DB). "platform" = fetched directly from the connected platform account."""
+
+    POSTPEER = "postpeer"
+    PLATFORM = "platform"
+
+
+class GetAnalyticsPostAggregated(BaseModel):
+    impressions: Optional[float] = None
+    reach: Optional[float] = None
+    likes: Optional[float] = None
+    comments: Optional[float] = None
+    shares: Optional[float] = None
+    saves: Optional[float] = None
+    clicks: Optional[float] = None
+    views: Optional[float] = None
+    engagement_rate: Optional[float] = Field(default=None, alias="engagementRate", description="Engagement rate (0-1). null when the platform does not report engagement.")
+
+
+class GetAnalyticsPostPlatformsMetrics(BaseModel):
+    impressions: Optional[float] = None
+    reach: Optional[float] = None
+    likes: Optional[float] = None
+    comments: Optional[float] = None
+    shares: Optional[float] = None
+    saves: Optional[float] = None
+    clicks: Optional[float] = None
+    views: Optional[float] = None
+    engagement_rate: Optional[float] = Field(default=None, alias="engagementRate", description="Engagement rate (0-1). null when the platform does not report engagement.")
+
+
+class GetAnalyticsPostPlatforms(BaseModel):
+    platform: Platform
+    platform_post_id: str = Field(..., alias="platformPostId", description="Native post ID on the platform")
+    platform_post_url: Optional[str] = Field(default=None, alias="platformPostUrl", description="Direct URL to the published post, if known")
+    metrics: GetAnalyticsPostPlatformsMetrics
+
+
+class GetAnalyticsPost(BaseModel):
+    source: GetAnalyticsPostSource = Field(..., description='Where the result came from. "postpeer" = posts published via PostPeer (stored in our DB). "platform" = fetched directly from the connected platform account.')
+    post_id: Optional[str] = Field(default=None, alias="postId", description="PostPeer post ID. null when source=platform (post fetched directly from the platform).")
+    content: Optional[str] = None
+    published_at: Optional[datetime] = Field(default=None, alias="publishedAt")
+    aggregated: GetAnalyticsPostAggregated
+    platforms: list[GetAnalyticsPostPlatforms]
+
+
+class GetAnalytics(BaseModel):
+    success: bool
+    post: GetAnalyticsPost
+
+
+class GetAnalyticsPostsSource(str, Enum):
+    """Where the result came from. "postpeer" = posts published via PostPeer (stored in our DB). "platform" = fetched directly from the connected platform account."""
+
+    POSTPEER = "postpeer"
+    PLATFORM = "platform"
+
+
+class GetAnalyticsPostsAggregated(BaseModel):
+    impressions: Optional[float] = None
+    reach: Optional[float] = None
+    likes: Optional[float] = None
+    comments: Optional[float] = None
+    shares: Optional[float] = None
+    saves: Optional[float] = None
+    clicks: Optional[float] = None
+    views: Optional[float] = None
+    engagement_rate: Optional[float] = Field(default=None, alias="engagementRate", description="Engagement rate (0-1). null when the platform does not report engagement.")
+
+
+class GetAnalyticsPostsPlatformsMetrics(BaseModel):
+    impressions: Optional[float] = None
+    reach: Optional[float] = None
+    likes: Optional[float] = None
+    comments: Optional[float] = None
+    shares: Optional[float] = None
+    saves: Optional[float] = None
+    clicks: Optional[float] = None
+    views: Optional[float] = None
+    engagement_rate: Optional[float] = Field(default=None, alias="engagementRate", description="Engagement rate (0-1). null when the platform does not report engagement.")
+
+
+class GetAnalyticsPostsPlatforms(BaseModel):
+    platform: Platform
+    platform_post_id: str = Field(..., alias="platformPostId", description="Native post ID on the platform")
+    platform_post_url: Optional[str] = Field(default=None, alias="platformPostUrl", description="Direct URL to the published post, if known")
+    metrics: GetAnalyticsPostsPlatformsMetrics
+
+
+class GetAnalyticsPosts(BaseModel):
+    source: GetAnalyticsPostsSource = Field(..., description='Where the result came from. "postpeer" = posts published via PostPeer (stored in our DB). "platform" = fetched directly from the connected platform account.')
+    post_id: Optional[str] = Field(default=None, alias="postId", description="PostPeer post ID. null when source=platform (post fetched directly from the platform).")
+    content: Optional[str] = None
+    published_at: Optional[datetime] = Field(default=None, alias="publishedAt")
+    aggregated: GetAnalyticsPostsAggregated
+    platforms: list[GetAnalyticsPostsPlatforms]
+
+
+class GetAnalytics_(BaseModel):
+    success: bool
+    total: Annotated[int, Field(ge=0)] = Field(..., description="Total matched posts across all pages")
+    page: Annotated[int, Field(ge=1)]
+    limit: Annotated[int, Field(ge=1)]
+    posts: list[GetAnalyticsPosts]
+
+
+class GetAnalyticsResponse(RootModel[Union[GetAnalytics, GetAnalytics_]]):
+    """Single-post response (when postId is supplied) or paginated list response."""
+
+    root: Union[GetAnalytics, GetAnalytics_] = Field(..., description="Single-post response (when postId is supplied) or paginated list response.")
+
+
+class GetUsageQuery(BaseModel):
+    profile_id: Optional[str] = Field(default=None, alias="profileId", description="Return usage for this profile only. Mutually exclusive with integrationId.")
+    integration_id: Optional[str] = Field(default=None, alias="integrationId", description="Return usage for this integration only. Mutually exclusive with profileId.")
+    from_: Optional[Annotated[str, Field(pattern=r"^\d{4}-(0[1-9]|1[0-2])$")]] = Field(default=None, alias="from", description="Inclusive start month (YYYY-MM). Filters the usage history array.")
+    to: Optional[Annotated[str, Field(pattern=r"^\d{4}-(0[1-9]|1[0-2])$")]] = Field(default=None, description="Inclusive end month (YYYY-MM). Filters the usage history array.")
+
+
+class GetUsageUsage(BaseModel):
+    year: int = Field(..., description="Calendar year")
+    month: Annotated[int, Field(ge=1, le=12)] = Field(..., description="Calendar month (1–12)")
+    count: Annotated[int, Field(ge=0)] = Field(..., description="Credits used this month")
+    platform: dict[str, int] = Field(..., description="Credits broken down by platform name")
+
+
+class GetUsageBalanceMonthly(BaseModel):
+    limit: int = Field(..., description="Total monthly credits included in your plan")
+    used: int = Field(..., description="Monthly credits used so far this billing cycle")
+    remaining: int = Field(..., description="Monthly credits still available this cycle")
+    cycle_start: datetime = Field(..., alias="cycleStart", description="Start of the current billing cycle")
+    cycle_end: datetime = Field(..., alias="cycleEnd", description="End of the current billing cycle — resets here")
+
+
+class GetUsageBalancePurchased(BaseModel):
+    total: int = Field(..., description="Total one-time credits purchased (never expire)")
+    used: int = Field(..., description="One-time credits consumed so far")
+    remaining: int = Field(..., description="One-time credits still available")
+
+
+class GetUsageBalance(BaseModel):
+    """Current credit balance. Only present on project-level requests (no profileId or integrationId filter)."""
+
+    monthly: GetUsageBalanceMonthly
+    purchased: GetUsageBalancePurchased
+
+
+class GetUsageResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    total_usage: Annotated[int, Field(ge=0)] = Field(..., alias="totalUsage", description="All-time credits used")
+    usage: list[GetUsageUsage] = Field(..., description="Monthly credit history, oldest first")
+    balance: Optional[GetUsageBalance] = Field(default=None, description="Current credit balance. Only present on project-level requests (no profileId or integrationId filter).")
+
+
+class GetPinterestBoardsQuery(BaseModel):
+    account_id: Optional[str] = Field(default=None, alias="accountId", description="Integration ID of the Pinterest account. If omitted, uses the first connected Pinterest account.")
+
+
+class GetPinterestBoardsBoards(BaseModel):
+    id: str
+    name: str
+    description: Optional[str] = None
+    privacy: str
+
+
+class GetPinterestBoardsResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    boards: list[GetPinterestBoardsBoards]
+
+
+class GetTikTokCreatorInfoQuery(BaseModel):
+    account_id: Optional[str] = Field(default=None, alias="accountId", description="Integration ID of the TikTok account. If omitted, uses the first connected TikTok account.")
+
+
+class GetTikTokCreatorInfoDataPrivacyLevelOptions(str, Enum):
+    PUBLIC_TO_EVERYONE = "PUBLIC_TO_EVERYONE"
+    MUTUAL_FOLLOW_FRIENDS = "MUTUAL_FOLLOW_FRIENDS"
+    FOLLOWER_OF_CREATOR = "FOLLOWER_OF_CREATOR"
+    SELF_ONLY = "SELF_ONLY"
+
+
+class GetTikTokCreatorInfoData(BaseModel):
+    creator_avatar_url: Union[str, Any] = Field(..., alias="creatorAvatarUrl", description="Profile avatar URL returned by TikTok.")
+    creator_username: Union[str, Any] = Field(..., alias="creatorUsername", description="Username (@handle) of the creator.")
+    creator_nickname: Union[str, Any] = Field(..., alias="creatorNickname", description="Display name of the creator.")
+    privacy_level_options: list[GetTikTokCreatorInfoDataPrivacyLevelOptions] = Field(..., alias="privacyLevelOptions", description="Privacy levels available to this creator. Your UX must restrict the privacy dropdown to these values.")
+    comment_disabled: bool = Field(..., alias="commentDisabled", description="If true, the creator has disabled comments in their app settings — grey out the Allow Comment toggle.")
+    duet_disabled: bool = Field(..., alias="duetDisabled", description="If true, the creator has disabled duet in their app settings — grey out the Allow Duet toggle.")
+    stitch_disabled: bool = Field(..., alias="stitchDisabled", description="If true, the creator has disabled stitch in their app settings — grey out the Allow Stitch toggle.")
+    max_video_post_duration_sec: float = Field(..., alias="maxVideoPostDurationSec", description="Maximum video duration (in seconds) this creator may post. Reject videos longer than this before upload.")
+
+
+class GetTikTokCreatorInfoResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    data: Optional[GetTikTokCreatorInfoData] = None
+    error: Optional[str] = None
+
+
+class AiWriteContentPlatforms(str, Enum):
+    TWITTER = "twitter"
+    INSTAGRAM = "instagram"
+    YOUTUBE = "youtube"
+    TIKTOK = "tiktok"
+    PINTEREST = "pinterest"
+    LINKEDIN = "linkedin"
+    BLUESKY = "bluesky"
+    FACEBOOK = "facebook"
+    THREADS = "threads"
+    GOOGLEBUSINESS = "googlebusiness"
+
+
+class AiWriteContentBody(BaseModel):
+    description: Annotated[str, Field(min_length=3, max_length=1500)] = Field(..., description="Free-form description of what the post should be about, in the creator's own words.")
+    platforms: Optional[list[AiWriteContentPlatforms]] = Field(default=None, description="Platforms this post will target. Used to fit the strictest character limit.")
+    existing_content: Optional[str] = Field(default=None, alias="existingContent", description="Optional existing draft to rewrite/improve rather than start from scratch.")
+
+
+class AiWriteContentResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    content: str
+    credits_charged: float = Field(..., alias="creditsCharged")
+
+
+class AiGenerateImageAspectRatio(str, Enum):
+    """Output aspect ratio. Defaults to square when omitted."""
+
+    SQUARE = "square"
+    VERTICAL = "vertical"
+    LANDSCAPE = "landscape"
+
+
+class AiGenerateImageStyle(str, Enum):
+    """Visual style preset. Adds style guidance to the prompt. Omit for the model to pick whatever fits the brief."""
+
+    PHOTO = "photo"
+    ILLUSTRATION = "illustration"
+    MINIMAL = "minimal"
+    VIBRANT = "vibrant"
+    CINEMATIC = "cinematic"
+    _3D_RENDER = "3d-render"
+    RETRO = "retro"
+    HAND_DRAWN = "hand-drawn"
+
+
+class AiGenerateImageBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+    description: Annotated[str, Field(min_length=3, max_length=1500)]
+    aspect_ratio: Optional[AiGenerateImageAspectRatio] = Field(default=None, alias="aspectRatio", description="Output aspect ratio. Defaults to square when omitted.")
+    style: Optional[AiGenerateImageStyle] = Field(default=None, description="Visual style preset. Adds style guidance to the prompt. Omit for the model to pick whatever fits the brief.")
+    reference_image_urls: Optional[Annotated[list[AnyUrl], Field(max_length=4)]] = Field(default=None, alias="referenceImageUrls", description='Reference images. Used as style/vibe inspiration ONLY. The model will not copy them. Useful for "match my brand look" or "same composition as this".')
+    asset_image_urls: Optional[Annotated[list[AnyUrl], Field(max_length=4)]] = Field(default=None, alias="assetImageUrls", description="Asset images that MUST appear in the generated image (e.g. a brand logo, a specific product photo). The model will place them faithfully according to the brief, without redrawing them.")
+    reference_image_url: Optional[AnyUrl] = Field(default=None, alias="referenceImageUrl", description="DEPRECATED: use referenceImageUrls instead. Still accepted for backwards compatibility.")
+
+
+class AiGenerateImageResponse(BaseModel):
+    """Default Response"""
+
+    success: bool
+    url: AnyUrl
+    mime_type: str = Field(..., alias="mimeType")
+    credits_charged: float = Field(..., alias="creditsCharged")