generated: '2026-09-28'
method: derived
generator: derive-vocabulary.py
source: openapi/_original/posteahora-api-openapi.yml
vocabulary:
  name: PosteAhora Domain Vocabulary
  description: 'Terms declared by PosteAhora''s own API contract: its resource groups, objects and enumerations, with the contract''s definitions.
    Derived, not authored.'
  version: '2026-09-28'
  terms:
  - term: Error
    definition: 'Object declared by the contract with fields: error.'
    tags:
    - Object
    source: openapi/_original/posteahora-api-openapi.yml#/components/schemas/Error
  - term: Account
    definition: 'Object declared by the contract with fields: id, platform, platform_username, platform_account_id, is_connected, requires_reauth,
      profile_image_url, connected_at.'
    tags:
    - Object
    source: openapi/_original/posteahora-api-openapi.yml#/components/schemas/Account
  - term: Workspace
    definition: 'Object declared by the contract with fields: id, name, isPersonal, role, active.'
    tags:
    - Object
    source: openapi/_original/posteahora-api-openapi.yml#/components/schemas/Workspace
  - term: IdeaInput
    definition: 'Object declared by the contract with fields: title, caption, tags, mediaUrls, mediaType, status.'
    tags:
    - Object
    source: openapi/_original/posteahora-api-openapi.yml#/components/schemas/IdeaInput
  - term: AccountMapping
    definition: 'Object declared by the contract with fields: platform, accountId.'
    tags:
    - Object
    source: openapi/_original/posteahora-api-openapi.yml#/components/schemas/AccountMapping
  - term: CreatePostRequest
    definition: 'Object declared by the contract with fields: title, caption, accountMappings, platforms, accountId, mediaUrls, mediaType, postType,
      hashtags, platformCaptions, platformOptions, status. (1 more)'
    tags:
    - Object
    source: openapi/_original/posteahora-api-openapi.yml#/components/schemas/CreatePostRequest
  - term: UpdatePostRequest
    definition: Edit a draft or scheduled post. Only sent fields are touched.
    tags:
    - Object
    source: openapi/_original/posteahora-api-openapi.yml#/components/schemas/UpdatePostRequest
  - term: CreatePostResult
    definition: 'Object declared by the contract with fields: postIds, status, dispatchDeferred.'
    tags:
    - Object
    source: openapi/_original/posteahora-api-openapi.yml#/components/schemas/CreatePostResult
  - term: PlatformResult
    definition: 'Object declared by the contract with fields: platform, success, error, remote_post_id, remote_publish_id, remote_permalink.'
    tags:
    - Object
    source: openapi/_original/posteahora-api-openapi.yml#/components/schemas/PlatformResult
  - term: Post
    definition: 'Object declared by the contract with fields: id, title, caption, platforms, status, scheduled_at, published_at, media_urls, media_type,
      connected_account_id, platform_results, created_at.'
    tags:
    - Object
    source: openapi/_original/posteahora-api-openapi.yml#/components/schemas/Post
  - term: AnalyticsResult
    definition: 'Object declared by the contract with fields: period, summary, posts.'
    tags:
    - Object
    source: openapi/_original/posteahora-api-openapi.yml#/components/schemas/AnalyticsResult
  - term: PlatformOptions
    definition: Per-network settings, keyed by platform id.
    tags:
    - Object
    source: openapi/_original/posteahora-api-openapi.yml#/components/schemas/PlatformOptions
  - term: YouTubeOptions
    definition: The video description is the post caption (platformCaptions.youtube, ≤5000 chars). The video title is the required `title` field.
      There is no "Shorts" flag — a vertical clip ≤3 min is auto-classified as a Short.
    tags:
    - Object
    source: openapi/_original/posteahora-api-openapi.yml#/components/schemas/YouTubeOptions
  - term: TikTokOptions
    definition: 'Object declared by the contract with fields: privacyLevel, disableComment, brandContentToggle, brandOrganicToggle, isAigc, postMode,
      disableDuet, disableStitch, videoCoverTimestampMs, autoAddMusic, photoCoverIndex, photoTitle.'
    tags:
    - Object
    source: openapi/_original/posteahora-api-openapi.yml#/components/schemas/TikTokOptions
  - term: InstagramOptions
    definition: Set postType "reel" (top level) for a Reel, "story" for a Story.
    tags:
    - Object
    source: openapi/_original/posteahora-api-openapi.yml#/components/schemas/InstagramOptions
  - term: ThreadsOptions
    definition: 'Object declared by the contract with fields: replyControl, topic, altText, linkAttachment, quotePostId, locationId, allowlistedCountryCodes,
      chainItems.'
    tags:
    - Object
    source: openapi/_original/posteahora-api-openapi.yml#/components/schemas/ThreadsOptions
  - term: BlueskyOptions
    definition: 'Object declared by the contract with fields: langs.'
    tags:
    - Object
    source: openapi/_original/posteahora-api-openapi.yml#/components/schemas/BlueskyOptions
  - term: MastodonOptions
    definition: 'Object declared by the contract with fields: visibility, spoilerText, sensitive, language.'
    tags:
    - Object
    source: openapi/_original/posteahora-api-openapi.yml#/components/schemas/MastodonOptions
  - term: TelegramOptions
    definition: 'Object declared by the contract with fields: disableNotification, protectContent.'
    tags:
    - Object
    source: openapi/_original/posteahora-api-openapi.yml#/components/schemas/TelegramOptions
  - term: PinterestOptions
    definition: boardId is REQUIRED and validated on create (400 without it). A Pin needs at least one image; 2–5 images make a carousel.
    tags:
    - Object
    source: openapi/_original/posteahora-api-openapi.yml#/components/schemas/PinterestOptions
  - term: PinterestBoard
    definition: 'Object declared by the contract with fields: id, name, privacy, pinCount.'
    tags:
    - Object
    source: openapi/_original/posteahora-api-openapi.yml#/components/schemas/PinterestBoard
  - term: DiscordOptions
    definition: 'Object declared by the contract with fields: channelId.'
    tags:
    - Object
    source: openapi/_original/posteahora-api-openapi.yml#/components/schemas/DiscordOptions