> ## Documentation Index
> Fetch the complete documentation index at: https://docs.turbofiles.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a file



## OpenAPI

````yaml POST /v1/files
openapi: 3.1.0
info:
  title: TurboFiles API
  version: 0.1.0
  description: |
    TurboFiles is a high-performance file compression service that provides
    efficient compression for various file types through a simple REST API.
  contact:
    name: TurboFiles Support
    url: https://www.turbofiles.io/support
    email: support@turbofiles.io
servers:
  - url: https://api.turbofiles.io/
    description: Production API
security:
  - bearerAuth: []
paths:
  /v1/files:
    post:
      summary: Request a signed URL for file upload
      operationId: v1_files_create
      requestBody:
        required: true
        content:
          application/vnd.api+json:
            schema:
              type: object
              required:
                - data
              properties:
                data:
                  type: object
                  required:
                    - type
                    - attributes
                  properties:
                    type:
                      type: string
                      enum:
                        - files
                    attributes:
                      type: object
                      properties:
                        format:
                          type: string
                          enum:
                            - image/png
                            - image/jpeg
                            - image/webp
                            - image/svg+xml
                            - application/pdf
                        size:
                          type: integer
                          example: 504233
      responses:
        '201':
          description: Created successfully
          content:
            application/vnd.api+json:
              schema:
                type: object
                required:
                  - jsonapi
                  - data
                  - links
                properties:
                  jsonapi:
                    type: object
                    required:
                      - version
                    properties:
                      version:
                        type: string
                        example: '1.1'
                  data:
                    allOf:
                      - type: object
                        required:
                          - type
                          - id
                          - attributes
                        properties:
                          type:
                            type: string
                            enum:
                              - files
                          id:
                            type: string
                            example: 8fhd83jpk
                          attributes:
                            type: object
                            properties:
                              format:
                                type: string
                                enum:
                                  - image/png
                                  - image/jpeg
                                  - image/webp
                                  - image/gif
                                  - image/bmp
                                  - image/tiff
                                  - image/x-icon
                                  - image/avif
                                  - image/x-portable-anymap
                                  - image/x-tga
                                  - image/vnd.ms-dds
                                  - image/vnd.radiance
                                  - image/x-exr
                                  - image/x-farbfeld
                                  - image/qoi
                                  - image/svg+xml
                                  - video/mp4
                                  - video/webm
                                  - video/x-msvideo
                                  - video/quicktime
                                  - video/x-ms-wmv
                                  - video/x-flv
                                  - video/x-matroska
                                  - video/3gpp
                                  - video/mpeg
                                  - video/ogg
                                  - video/mp2t
                                  - video/x-m4v
                                  - video/dvd
                                  - video/x-f4v
                                  - audio/mpeg
                                  - audio/wav
                                  - audio/aac
                                  - audio/ogg
                                  - audio/opus
                                  - audio/flac
                                  - audio/mp4
                                  - audio/x-ms-wma
                                  - application/pdf
                              size:
                                type: integer
                                example: 504233
                              created_at:
                                type: string
                                format: date-time
                              updated_at:
                                type: string
                                format: date-time
                      - type: object
                        required:
                          - links
                        properties:
                          links:
                            type: object
                            required:
                              - self
                            properties:
                              self:
                                type: string
                                format: uri
                              upload:
                                type: string
                                format: uri
                              download:
                                type: string
                                format: uri
                  links:
                    type: object
                    properties:
                      self:
                        type: string
                        format: uri
                        description: Link to the current page of results
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >
        Authentication token must be provided in the Authorization header using
        the Bearer scheme.

        Example: Authorization: Bearer your-api-key-or-token

````