openapi: 3.0.3
info:
  title: Flowdock Push API
  version: "1.0"
  x-status: discontinued
  x-deprecated-by-vendor: true
  x-shutdown-date: "2023-08-15"
  description: |
    The Flowdock Push API was the legacy "post-only" integration surface for
    sending content into a Flow's Team Inbox or Chat using a per-flow API
    token (no user authentication). It was deprecated in favor of the
    Messages endpoint of the REST API and was retired with the rest of
    Flowdock on August 15, 2023.

    Reconstructed from the historical https://github.com/flowdock/api-docs
    repository (docs/push.md, docs/team-inbox.md, docs/chat.md).
servers:
  - url: https://api.flowdock.com
    description: Historical production base URL (offline since 2023-08-15)
tags:
  - name: Team Inbox
    description: Mail-like messages posted into a flow's team inbox.
  - name: Chat
    description: Chat-style messages posted as an external user.
paths:
  /v1/messages/team_inbox/{flow_api_token}:
    post:
      tags: [Team Inbox]
      summary: Push Team Inbox Message
      operationId: pushTeamInbox
      description: Send a mail-like message into a flow's team inbox using its API token.
      parameters:
        - name: flow_api_token
          in: path
          required: true
          schema: { type: string }
      requestBody:
        required: true
        content:
          application/json:
            schema: { $ref: "#/components/schemas/TeamInboxMessage" }
          application/x-www-form-urlencoded:
            schema: { $ref: "#/components/schemas/TeamInboxMessage" }
      responses:
        "200":
          description: Message accepted.
          content:
            application/json:
              schema: { type: object }
  /v1/messages/chat/{flow_api_token}:
    post:
      tags: [Chat]
      summary: Push Chat Message
      operationId: pushChat
      description: Post a chat message to a flow as an "external user".
      parameters:
        - name: flow_api_token
          in: path
          required: true
          schema: { type: string }
      requestBody:
        required: true
        content:
          application/json:
            schema: { $ref: "#/components/schemas/ChatMessage" }
          application/x-www-form-urlencoded:
            schema: { $ref: "#/components/schemas/ChatMessage" }
      responses:
        "200":
          description: Message accepted.
          content:
            application/json:
              schema: { type: object }
components:
  schemas:
    TeamInboxMessage:
      type: object
      required: [source, from_address, subject, content]
      properties:
        source:
          type: string
          description: Human readable identifier of the application that uses the Push API.
        from_address:
          type: string
          format: email
        subject: { type: string }
        content:
          type: string
          description: HTML body of the inbox message.
        from_name: { type: string }
        reply_to: { type: string, format: email }
        project: { type: string }
        format: { type: string, enum: [html] }
        link: { type: string, format: uri }
        tags:
          oneOf:
            - type: array
              items: { type: string }
            - type: string
    ChatMessage:
      type: object
      required: [content, external_user_name]
      properties:
        content:
          type: string
          maxLength: 8096
        external_user_name: { type: string }
        tags:
          oneOf:
            - type: array
              items: { type: string }
            - type: string
        message_id:
          type: integer
          description: ID of the parent message when sending a comment.