APIs.io Engineering Platform Cloudflare Images Variants API

openapi: 3.0.0
info:
  version: "1.0.0"
  x-release: v4
  title: APIs.io Engineering Platform Amazon API Gateway 2014 11 13 Cloudflare Images Variants API
  description: <fullname>Amazon API Gateway</fullname> <p>Amazon API Gateway helps developers deliver robust, secure, and scalable mobile and web application back ends. API Gateway allows developers to securely connect mobile and web applications to APIs that run on AWS Lambda, Amazon EC2, or other publicly addressable web services that are hosted outside of AWS.</p>
  x-logo:
    url: https://api.apis.guru/v2/cache/logo/https_twitter.com_awscloud_profile_image.png
    backgroundColor: '#FFFFFF'
  termsOfService: https://aws.amazon.com/service-terms/
  contact:
    name: Mike Ralphson
    email: mike.ralphson@gmail.com
    url: https://github.com/mermade/aws2openapi
    x-twitter: PermittedSoc
  license:
    name: Apache 2.0 License
    url: http://www.apache.org/licenses/
  x-providerName: amazonaws.com
  x-serviceName: apigateway
  x-origin:
  - contentType: application/json
    url: https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/apigateway-2015-07-09.normal.json
    converter:
      url: https://github.com/mermade/aws2openapi
    x-apisguru-driver: external
  x-apiClientRegistration:
    url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?nc2=h_ct
  x-apisguru-categories:
  - cloud
  x-preferred: true
servers:
- url: http://apigateway.{region}.amazonaws.com
  variables:
    region:
      description: The AWS region
      enum:
      - us-east-1
      - us-east-2
      - us-west-1
      - us-west-2
      - us-gov-west-1
      - us-gov-east-1
      - ca-central-1
      - eu-north-1
      - eu-west-1
      - eu-west-2
      - eu-west-3
      - eu-central-1
      - eu-south-1
      - af-south-1
      - ap-northeast-1
      - ap-northeast-2
      - ap-northeast-3
      - ap-southeast-1
      - ap-southeast-2
      - ap-east-1
      - ap-south-1
      - sa-east-1
      - me-south-1
      default: us-east-1
  description: The Amazon API Gateway multi-region endpoint
- url: https://apigateway.{region}.amazonaws.com
  variables:
    region:
      description: The AWS region
      enum:
      - us-east-1
      - us-east-2
      - us-west-1
      - us-west-2
      - us-gov-west-1
      - us-gov-east-1
      - ca-central-1
      - eu-north-1
      - eu-west-1
      - eu-west-2
      - eu-west-3
      - eu-central-1
      - eu-south-1
      - af-south-1
      - ap-northeast-1
      - ap-northeast-2
      - ap-northeast-3
      - ap-southeast-1
      - ap-southeast-2
      - ap-east-1
      - ap-south-1
      - sa-east-1
      - me-south-1
      default: us-east-1
  description: The Amazon API Gateway multi-region endpoint
- url: http://apigateway.{region}.amazonaws.com.cn
  variables:
    region:
      description: The AWS region
      enum:
      - cn-north-1
      - cn-northwest-1
      default: cn-north-1
  description: The Amazon API Gateway endpoint for China (Beijing) and China (Ningxia)
- url: https://apigateway.{region}.amazonaws.com.cn
  variables:
    region:
      description: The AWS region
      enum:
      - cn-north-1
      - cn-northwest-1
      default: cn-north-1
  description: The Amazon API Gateway endpoint for China (Beijing) and China (Ningxia)
security:
- hmac: []
tags:
- name: Cloudflare Images Variants
paths:
  /accounts/{account_id}/images/v1/variants:
    get:
      description: Lists existing variants.
      operationId: cloudflare-images-variants-list-variants
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/images_account_identifier'
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/images_image_variant_list_response'
                - $ref: '#/components/schemas/images_api-response-common-failure'
          description: List variants response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/images_image_variant_list_response'
          description: List variants response
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform List variants
      tags:
      - Cloudflare Images Variants
      x-api-token-group:
      - Images Read
      - Images Write
    post:
      description: Specify variants that allow you to resize images for different use cases.
      operationId: cloudflare-images-variants-create-a-variant
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/images_account_identifier'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/images_image_variant_definition'
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/images_image_variant_simple_response'
                - $ref: '#/components/schemas/images_api-response-common-failure'
          description: Create a variant response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/images_image_variant_simple_response'
          description: Create a variant response
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Create a variant
      tags:
      - Cloudflare Images Variants
      x-api-token-group:
      - Images Write
  /accounts/{account_id}/images/v1/variants/{variant_id}:
    delete:
      description: Deleting a variant purges the cache for all images associated with the variant.
      operationId: cloudflare-images-variants-delete-a-variant
      parameters:
      - in: path
        name: variant_id
        required: true
        schema:
          $ref: '#/components/schemas/images_image_variant_identifier'
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/images_account_identifier'
      requestBody:
        content:
          application/json: {}
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/images_deleted_response'
                - $ref: '#/components/schemas/images_api-response-common-failure'
          description: Delete a variant response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/images_deleted_response'
          description: Delete a variant response
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Delete a variant
      tags:
      - Cloudflare Images Variants
      x-api-token-group:
      - Images Write
    get:
      description: Fetch details for a single variant.
      operationId: cloudflare-images-variants-variant-details
      parameters:
      - in: path
        name: variant_id
        required: true
        schema:
          $ref: '#/components/schemas/images_image_variant_identifier'
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/images_account_identifier'
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/images_image_variant_simple_response'
                - $ref: '#/components/schemas/images_api-response-common-failure'
          description: Variant details response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/images_image_variant_simple_response'
          description: Variant details response
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Variant details
      tags:
      - Cloudflare Images Variants
      x-api-token-group:
      - Images Read
      - Images Write
    patch:
      description: Updating a variant purges the cache for all images associated with the variant.
      operationId: cloudflare-images-variants-update-a-variant
      parameters:
      - in: path
        name: variant_id
        required: true
        schema:
          $ref: '#/components/schemas/images_image_variant_identifier'
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/images_account_identifier'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/images_image_variant_patch_request'
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/images_image_variant_simple_response'
                - $ref: '#/components/schemas/images_api-response-common-failure'
          description: Update a variant response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/images_image_variant_simple_response'
          description: Update a variant response
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Update a variant
      tags:
      - Cloudflare Images Variants
      x-api-token-group:
      - Images Write
components:
  schemas:
    images_api-response-single:
      allOf:
      - $ref: '#/components/schemas/images_api-response-common'
      - properties:
          result:
            anyOf:
            - type: object
            - type: string
      type: object
    images_image_variant_width:
      description: Maximum width in image pixels.
      example: 1366
      minimum: 1
      type: number
    images_deleted_response:
      allOf:
      - $ref: '#/components/schemas/images_api-response-single'
      - properties:
          result:
            example: {}
            type: object
    images_api-response-common:
      properties:
        errors:
          $ref: '#/components/schemas/images_messages'
        messages:
          $ref: '#/components/schemas/images_messages'
        result:
          anyOf:
          - type: object
          - items: {}
            type: array
          - type: string
        success:
          description: Whether the API call was successful
          enum:
          - true
          example: true
          type: boolean
      required:
      - success
      - errors
      - messages
      - result
      type: object
    images_image_variant_height:
      description: Maximum height in image pixels.
      example: 768
      minimum: 1
      type: number
    images_image_variant_patch_request:
      properties:
        neverRequireSignedURLs:
          $ref: '#/components/schemas/images_image_variant_neverRequireSignedURLs'
        options:
          $ref: '#/components/schemas/images_image_variant_options'
      required:
      - options
      type: object
    images_image_variant_list_response:
      allOf:
      - $ref: '#/components/schemas/images_api-response-common'
      - properties:
          result:
            $ref: '#/components/schemas/images_image_variants_response'
    images_api-response-common-failure:
      properties:
        errors:
          allOf:
          - $ref: '#/components/schemas/images_messages'
          example:
          - code: 7003
            message: No route for the URI
          minLength: 1
        messages:
          allOf:
          - $ref: '#/components/schemas/images_messages'
          example: []
        result:
          enum:
          - null
          nullable: true
          type: object
        success:
          description: Whether the API call was successful
          enum:
          - false
          example: false
          type: boolean
      required:
      - success
      - errors
      - messages
      - result
      type: object
    images_image_variant_neverRequireSignedURLs:
      default: false
      description: Indicates whether the variant can access an image without a signature, regardless of image access control.
      example: true
      type: boolean
    images_image_variant_simple_response:
      allOf:
      - $ref: '#/components/schemas/images_api-response-single'
      - properties:
          result:
            $ref: '#/components/schemas/images_image_variant_response'
    images_image_variant_public_request:
      properties:
        hero:
          properties:
            id:
              $ref: '#/components/schemas/images_image_variant_identifier'
            neverRequireSignedURLs:
              $ref: '#/components/schemas/images_image_variant_neverRequireSignedURLs'
            options:
              $ref: '#/components/schemas/images_image_variant_options'
          required:
          - id
          - options
          type: object
      type: object
    images_image_variant_options:
      description: Allows you to define image resizing sizes for different use cases.
      properties:
        fit:
          $ref: '#/components/schemas/images_image_variant_fit'
        height:
          $ref: '#/components/schemas/images_image_variant_height'
        metadata:
          $ref: '#/components/schemas/images_image_variant_schemas_metadata'
        width:
          $ref: '#/components/schemas/images_image_variant_width'
      required:
      - fit
      - metadata
      - width
      - height
      type: object
    images_image_variants_response:
      properties:
        variants:
          $ref: '#/components/schemas/images_image_variant_public_request'
      type: object
    images_image_variant_response:
      properties:
        variant:
          $ref: '#/components/schemas/images_image_variant_definition'
      type: object
    images_image_variant_definition:
      properties:
        id:
          $ref: '#/components/schemas/images_image_variant_identifier'
        neverRequireSignedURLs:
          $ref: '#/components/schemas/images_image_variant_neverRequireSignedURLs'
        options:
          $ref: '#/components/schemas/images_image_variant_options'
      required:
      - id
      - options
      type: object
    images_image_variant_schemas_metadata:
      description: What EXIF data should be preserved in the output image.
      enum:
      - keep
      - copyright
      - none
      example: none
      type: string
    images_image_variant_fit:
      description: The fit property describes how the width and height dimensions should be interpreted.
      enum:
      - scale-down
      - contain
      - cover
      - crop
      - pad
      example: scale-down
      type: string
    images_image_variant_identifier:
      example: hero
      maxLength: 99
      pattern: ^[a-zA-Z0-9]$
      type: string
    images_account_identifier:
      description: Account identifier tag.
      example: 023e105f4ecef8ad9ca31a8372d0c353
      maxLength: 32
      readOnly: true
      type: string
    images_messages:
      example: []
      items:
        properties:
          code:
            minimum: 1000
            type: integer
          message:
            type: string
        required:
        - code
        - message
        type: object
        uniqueItems: true
      type: array
  securitySchemes:
    hmac:
      type: apiKey
      name: Authorization
      in: header
      description: Amazon Signature authorization v4
      x-amazon-apigateway-authtype: awsSigv4
externalDocs:
  description: Amazon Web Services documentation
  url: https://docs.aws.amazon.com/apigateway/
x-hasEquivalentPaths: true