imageat Social API

openapi: 3.2.0
info:
  title: imageat Social API
  version: 1.1.0
  description: OpenAI-compatible text and agent APIs, image and video generation, and posting to connected social accounts.
servers:
- url: https://imageat.com/api/v1
security:
- bearerAuth: []
tags:
- name: Social
paths:
  /social/accounts:
    get:
      operationId: listSocialAccounts
      summary: Social accounts connected in Social Hub and whether each can post now
      responses:
        '200':
          description: '{ accounts: [{ id, platform, name, handle, status, can_publish, reason }], plan, connect_url }'
      tags:
      - Social
  /social/posts:
    get:
      operationId: listSocialPosts
      parameters:
      - name: status
        in: query
        schema:
          type: string
          enum:
          - draft
          - scheduled
          - publishing
          - published
          - partially_published
          - failed
          - cancelled
      - name: limit
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 20
      responses:
        '200':
          description: Posts
          newest first: null
      tags:
      - Social
      summary: List social posts
      x-summary-source: derived
    post:
      operationId: createSocialPost
      summary: Draft, schedule or publish an image or video to connected accounts (no credits…
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SocialPostRequest'
      responses:
        '201':
          description: '{ post: { id, status, scheduled_at, media, destinations } }'
        '402':
          description: 'code plan_required: the plan does not cover posting or that account'
        '429':
          description: More than 60 posts in the last hour
      tags:
      - Social
  /social/posts/{id}:
    parameters:
    - name: id
      in: path
      required: true
      schema:
        type: string
        format: uuid
    get:
      operationId: getSocialPost
      responses:
        '200':
          description: The post with each destination's status and published_url
      tags:
      - Social
      summary: Get social post
      x-summary-source: derived
    delete:
      operationId: cancelSocialPost
      responses:
        '200':
          description: Cancelled; destinations already published stay published
        '409':
          description: The post has already started publishing
      tags:
      - Social
      summary: Cancel social post
      x-summary-source: derived
  /social/autopilots:
    get:
      operationId: listSocialAutopilots
      responses:
        '200':
          description: Weekly posting schedules set up in Social Hub
      tags:
      - Social
      summary: List social autopilots
      x-summary-source: derived
  /social/autopilots/{id}/queue:
    parameters:
    - name: id
      in: path
      required: true
      schema:
        type: string
        format: uuid
    post:
      operationId: queueOnSocialAutopilot
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - items
              properties:
                items:
                  type: array
                  minItems: 1
                  maxItems: 30
                  items:
                    type: object
                    properties:
                      caption:
                        type: string
                      generation_id:
                        type: string
                      media_url:
                        type: string
                        format: uri
                      alt_text:
                        type: string
                        maxLength: 300
      responses:
        '201':
          description: '{ results: [{ ok, post_id, scheduled_at } | { ok: false, error }] }'
      tags:
      - Social
      summary: Queue on social autopilot
      x-summary-source: derived
components:
  schemas:
    SocialPostRequest:
      type: object
      required:
      - account_ids
      properties:
        account_ids:
          type: array
          minItems: 1
          maxItems: 10
          items:
            type: string
        caption:
          type: string
        captions:
          type: object
          additionalProperties:
            type: string
          description: Per-account captions keyed by account id
        remind_account_ids:
          type: array
          items:
            type: string
          description: Subset of account_ids to remind the user about (email at the scheduled time) instead of posting, for platforms where can_publish is false
        generation_id:
          type: string
          description: A generation on your account to post
        media_url:
          type: string
          format: uri
          description: such JPEG, PNG, WebP or MP4 (up to 100 MB)
        alt_text:
          type: string
          maxLength: 300
        mode:
          type: string
          enum:
          - draft
          - schedule
          - publish
          default: draft
        scheduled_at:
          type: string
          format: date-time
        timezone:
          type: string
          description: IANA zone
          e.g. Europe/Istanbul: null
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer