action dev_post_api_display_ads {
  label: "display ads"
  description: "This endpoint allows the client to create a new display ad."
  provider: dev
  method: POST
  path: "/api/display_ads"
  encoding: json
  input: {
    type: "object"
    required: ["body_markdown", "name", "placement_area"]
    properties: {
      approved: {
        type: "boolean"
        description: "Ad must be both published and approved to be in rotation"
      }
      body_markdown: {
        type: "string"
        description: "The text (in markdown) of the ad (required)"
      }
      creator_id: {
        type: "integer"
        description: "Identifies the user who created the ad."
      }
      display_to: {
        type: "string"
        description: "Potentially limits visitors to whom the ad is visible"
        enum: ["all", "logged_in", "logged_out"]
      }
      name: {
        type: "string"
        description: "For internal use, helps distinguish ads from one another"
      }
      organization_id: {
        type: "integer"
        description: "Identifies the organization to which the ad belongs"
      }
      placement_area: {
        type: "string"
        description: "Identifies which area of site layout the ad can appear in"
        enum: ["sidebar_left", "sidebar_left_2", "sidebar_right", "post_sidebar", "post_comments"]
      }
      published: {
        type: "boolean"
        description: "Ad must be both published and approved to be in rotation"
      }
      tag_list: {
        type: "string"
        description: "Tags on which this ad can be displayed (blank is all/any tags)"
      }
      type_of: {
        type: "string"
        description: "Types of the billboards:\nin_house (created by admins),\ncommunity (created by an entity, appears on entity's content),\nexternal ( created by an entity, or a non-entity, can appear everywhere)\n"
        enum: ["in_house", "community", "external"]
      }
    }
  }
  output: {
    type: "object"
    additionalProperties: true
  }
}