action dev_put_api_display_ads_id {
  label: "display ads"
  description: "This endpoint allows the client to update the attributes of a single display ad, via its id."
  provider: dev
  method: PUT
  path: "/api/display_ads/{id}"
  encoding: json
  input: {
    type: "object"
    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"]
      }
      id: {
        type: "integer"
        format: "int32"
      }
      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, required for 'community' type ads"
      }
      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)"
      }
    }
    required: ["body_markdown", "id", "name", "placement_area"]
    additionalProperties: false
  }
  output: {
    type: "object"
    additionalProperties: true
  }
}