openapi: 3.2.0
info:
  version: 1.0.0
  title: Paperform Translations API
  contact:
    name: Paperform API Support
    url: https://paperform.co
    email: support@paperform.co
servers:
- url: https://api.paperform.co/v1
security:
- bearerAuth: []
tags:
- name: Translations
paths:
  /translations:
    get:
      parameters:
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/skip'
      - $ref: '#/components/parameters/afterId'
      - $ref: '#/components/parameters/beforeId'
      - $ref: '#/components/parameters/beforeDate'
      - $ref: '#/components/parameters/afterDate'
      - $ref: '#/components/parameters/sort'
      description: 'This endpoint returns a list of translations that are accessible by the authorized user.

        Please note that this feature is exclusively available as part of the Business API.'
      operationId: listTranslations
      tags:
      - Translations
      responses:
        '200':
          description: Successfully returned a list of translations
          content:
            application/json:
              schema:
                type: object
                allOf:
                - properties:
                    status:
                      type: string
                      enum:
                      - ok
                    results:
                      type: object
                      properties:
                        translations:
                          type: array
                          items:
                            $ref: '#/components/schemas/Translation'
                - $ref: '#/components/schemas/Pagination'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/Throttled'
        5XX:
          $ref: '#/components/responses/Unexpected'
      summary: List translations
      x-summary-source: derived
    post:
      description: 'This endpoint creates a translation.

        Please note that this feature is exclusively available as part of the Business API.'
      operationId: createTranslation
      tags:
      - Translations
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Translation'
              required:
              - title
      responses:
        '200':
          description: 'Successfully created a translation with the provided values

            '
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                    - ok
                  results:
                    type: object
                    properties:
                      translation:
                        $ref: '#/components/schemas/Translation'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/Validation'
        '429':
          $ref: '#/components/responses/Throttled'
        5XX:
          $ref: '#/components/responses/Unexpected'
      summary: Create translation
      x-summary-source: derived
  /translations/{id}:
    get:
      parameters:
      - $ref: '#/components/parameters/translationID'
      description: 'This endpoint returns a translation by ID.

        Please note that this feature is exclusively available as part of the Business API.'
      operationId: getTranslation
      tags:
      - Translations
      responses:
        '200':
          description: Successfully returned a list translation
          content:
            application/json:
              schema:
                type: object
                allOf:
                - properties:
                    status:
                      type: string
                      enum:
                      - ok
                    results:
                      type: object
                      properties:
                        translation:
                          $ref: '#/components/schemas/Translation'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/Throttled'
        5XX:
          $ref: '#/components/responses/Unexpected'
      summary: Get translation
      x-summary-source: derived
    put:
      parameters:
      - $ref: '#/components/parameters/translationID'
      description: 'This endpoint updates a translation.

        Please note that this feature is exclusively available as part of the Business API.'
      operationId: updateTranslation
      tags:
      - Translations
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Translation'
      responses:
        '200':
          description: 'Successfully updated a translation with the provided values

            '
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                    - ok
                  results:
                    type: object
                    properties:
                      translation:
                        $ref: '#/components/schemas/Translation'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/Validation'
        '429':
          $ref: '#/components/responses/Throttled'
        5XX:
          $ref: '#/components/responses/Unexpected'
      summary: Update translation
      x-summary-source: derived
    delete:
      parameters:
      - $ref: '#/components/parameters/translationID'
      description: 'This endpoint deletes a specific translation by ID.

        Please note that this feature is exclusively available as part of the Business API.'
      operationId: deleteTranslation
      tags:
      - Translations
      responses:
        '200':
          description: 'Successfully deleted a single translation that matched the provided ID

            '
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                    - ok
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/Throttled'
        5XX:
          $ref: '#/components/responses/Unexpected'
      summary: Delete translation
      x-summary-source: derived
components:
  responses:
    Throttled:
      description: Too Many Requests
      content:
        text/html:
          schema:
            type: string
            enum:
            - Too many requests.
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            type: object
            allOf:
            - $ref: '#/components/schemas/Error'
            - properties:
                error_type:
                  type: string
                  enum:
                  - authentication
                  description: Token not provided for not valid.
    Forbidden:
      description: Not Permitted
      content:
        application/json:
          schema:
            type: object
            allOf:
            - $ref: '#/components/schemas/Error'
            - properties:
                error_type:
                  type: string
                  enum:
                  - permission
                  description: Not permitted to access requested resource.
    Validation:
      description: Validation Error
      content:
        application/json:
          schema:
            type: object
            allOf:
            - $ref: '#/components/schemas/Error'
            - properties:
                error_type:
                  type: string
                  enum:
                  - validation
                  description: Invalid parameters provided.
    BadRequest:
      description: Invalid Request
      content:
        application/json:
          schema:
            type: object
            allOf:
            - $ref: '#/components/schemas/Error'
            - properties:
                error_type:
                  type: string
                  enum:
                  - validation
                  description: Invalid parameters provided.
    Unexpected:
      description: Unexpected Error
      content:
        application/json:
          schema:
            type: object
            allOf:
            - $ref: '#/components/schemas/Error'
            - properties:
                error_type:
                  type: string
                  enum:
                  - server_error
                  description: An unexpected error.
    NotFound:
      description: Not Found
      content:
        application/json:
          schema:
            type: object
            allOf:
            - $ref: '#/components/schemas/Error'
            - properties:
                error_type:
                  type: string
                  enum:
                  - not_found
                  description: The requested resource was not found.
  schemas:
    Translation:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: The unique identifier of the translation.
          example: 5d40fdaf174b4c0007043072
          readOnly: true
        title:
          type: string
          description: The title of the translation.
          example: My German Translation
        language:
          $ref: '#/components/schemas/Language'
        mapping:
          type: object
          description: The mapping for translations.
          example:
            submitting: Submitting...
        subsets:
          type: object
          description: The subsets for the translation.
        rtl:
          type: boolean
          default: false
          description: Whether the translation is right-to-left.
          example: false
        created_at:
          type: string
          format: date-time
          description: A formatted date-time string in your account timezone indicating the time the translation was created.
          readOnly: true
          example: '2019-04-14T09:00:00.000Z'
        updated_at:
          type: string
          format: date-time
          description: A formatted date-time string in your account timezone indicating the time the translation was last updated.
          readOnly: true
          example: '2019-04-14T09:00:00.000Z'
        account_timezone:
          type: string
          description: The timezone of your account.
          readOnly: true
          example: America/Los_Angeles
        created_at_utc:
          type: string
          format: date-time
          description: A formatted date-time string in UTC timezone indicating the time the translation was created.
          readOnly: true
          example: '2019-04-14T09:00:00.000Z'
        updated_at_utc:
          type: string
          format: date-time
          description: A formatted date-time string in UTC timezone indicating the time the translation was last updated.
          readOnly: true
          example: '2019-04-14T09:00:00.000Z'
    Pagination:
      type: object
      properties:
        total:
          type: integer
          description: The total number of items.
          readOnly: true
          example: 57
        has_more:
          description: Whether there are more items.
          type: boolean
          example: true
          readOnly: true
        limit:
          description: The limit of items per page.
          type: integer
          example: 20
          default: 20
        skip:
          description: The number of items to skip.
          type: integer
          default: 0
          example: 0
    Error:
      type: object
      properties:
        status:
          type: string
          enum:
          - error
          example: error
        message:
          type: string
          description: An error message.
          example: Invalid request
        details:
          type: array
          description: Suggested actions to resolve the error.
          items:
            type: string
    Language:
      type: string
      example: German
      enum:
      - Abkhazian
      - Afar
      - Afrikaans
      - Akan
      - Albanian
      - Amharic
      - Arabic
      - Aragonese
      - Armenian
      - Assamese
      - Avaric
      - Avestan
      - Aymara
      - Azerbaijani
      - Bambara
      - Bashkir
      - Basque
      - Belarusian
      - Bengali
      - Bihari languages
      - Bislama
      - Bosnian
      - Breton
      - Bulgarian
      - Burmese
      - Catalan, Valencian
      - Central Khmer
      - Chamorro
      - Chechen
      - Chichewa, Chewa, Nyanja
      - Chinese
      - Church Slavonic, Old Bulgarian, Old Church Slavonic
      - Chuvash
      - Cornish
      - Corsican
      - Cree
      - Croatian
      - Czech
      - Danish
      - Divehi, Dhivehi, Maldivian
      - Dutch, Flemish
      - Dzongkha
      - English
      - Esperanto
      - Estonian
      - Ewe
      - Faroese
      - Fijian
      - Finnish
      - French
      - Fulah
      - Gaelic, Scottish Gaelic
      - Galician
      - Ganda
      - Georgian
      - German
      - Gikuyu, Kikuyu
      - Greek (Modern)
      - Greenlandic, Kalaallisut
      - Guarani
      - Gujarati
      - Haitian, Haitian Creole
      - Hausa
      - Hebrew
      - Herero
      - Hindi
      - Hiri Motu
      - Hungarian
      - Icelandic
      - Ido
      - Igbo
      - Indonesian
      - Interlingua (International Auxiliary Language Association)
      - Interlingue
      - Inuktitut
      - Inupiaq
      - Irish
      - Italian
      - Japanese
      - Javanese
      - Kannada
      - Kanuri
      - Kashmiri
      - Kazakh
      - Kinyarwanda
      - Komi
      - Kongo
      - Korean
      - Kwanyama, Kuanyama
      - Kurdish
      - Kyrgyz
      - Lao
      - Latin
      - Latvian
      - Letzeburgesch, Luxembourgish
      - Limburgish, Limburgan, Limburger
      - Lingala
      - Lithuanian
      - Luba-Katanga
      - Macedonian
      - Malagasy
      - Malay
      - Malayalam
      - Maltese
      - Manx
      - Maori
      - Marathi
      - Marshallese
      - Moldovan, Moldavian, Romanian
      - Mongolian
      - Nauru
      - Navajo, Navaho
      - Northern Ndebele
      - Ndonga
      - Nepali
      - Northern Sami
      - Norwegian
      - Norwegian Bokmål
      - Norwegian Nynorsk
      - Nuosu, Sichuan Yi
      - Occitan (post 1500)
      - Ojibwa
      - Oriya
      - Oromo
      - Ossetian, Ossetic
      - Pali
      - Panjabi, Punjabi
      - Pashto, Pushto
      - Persian
      - Polish
      - Portuguese
      - Quechua
      - Romansh
      - Rundi
      - Russian
      - Samoan
      - Sango
      - Sanskrit
      - Sardinian
      - Serbian
      - Shona
      - Sindhi
      - Sinhala, Sinhalese
      - Slovak
      - Slovenian
      - Somali
      - Sotho, Southern
      - South Ndebele
      - Spanish, Castilian
      - Sundanese
      - Swahili
      - Swati
      - Swedish
      - Tagalog
      - Tahitian
      - Tajik
      - Tamil
      - Tatar
      - Telugu
      - Thai
      - Tibetan
      - Tigrinya
      - Tonga (Tonga Islands)
      - Tsonga
      - Tswana
      - Turkish
      - Turkmen
      - Twi
      - Uighur, Uyghur
      - Ukrainian
      - Urdu
      - Uzbek
      - Venda
      - Vietnamese
      - Volap_k
      - Walloon
      - Welsh
      - Western Frisian
      - Wolof
      - Xhosa
      - Yiddish
      - Yoruba
      - Zhuang, Chuang
      - Zulu
  parameters:
    beforeDate:
      in: query
      name: before_date
      schema:
        type: string
        format: date-time
      description: Return results created on or after this date-time (UTC). Overwritten by `before_id`.
      example: '2019-06-11T20:36:29Z'
    afterDate:
      in: query
      name: after_date
      schema:
        type: string
        format: date-time
      description: Return results created before this date (UTC). Overwritten by `after_id`.
      example: '2019-06-11T20:36:29Z'
    skip:
      in: query
      name: skip
      schema:
        type: integer
        default: 0
      description: Number of results to skip in the result set.
    sort:
      in: query
      name: sort
      schema:
        type: string
        enum:
        - ASC
        - DESC
        default: DESC
      description: The direction to sort in. Results are sorted by `created_at`, and defaults to `"DESC"`.
      example: ASC
    limit:
      in: query
      name: limit
      schema:
        type: integer
        maximum: 100
        default: 20
      description: The number or results to return.
    afterId:
      in: query
      name: after_id
      schema:
        type: string
      description: Return results after the provided ID.
      example: 5d40fdaf174b4c0007043072
    beforeId:
      in: query
      name: before_id
      schema:
        type: string
      description: Return results before the provided ID.
      example: 5d40fdaf174b4c0007043072
    translationID:
      in: path
      required: true
      name: id
      schema:
        type: string
      description: The ID of the translation to get results for.
      example: 5d40fdaf174b4c0007043072
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
x-readme:
  explorer-enabled: true
  proxy-enabled: true