---
title: "POST v1-documentTemplates-documentTemplateRID--file"
url: "https://devportal.jilson.dev/apis/document-generator-pkce-flow-1/versions/c7bf5731-4982-4310-bcfe-512415c7d543/paths/v1-documentTemplates-documentTemplateRID--file/post"
---

> Full API specification: https://devportal.jilson.dev/apis/document-generator-pkce-flow-1/versions/c7bf5731-4982-4310-bcfe-512415c7d543.md

# /v1/documentTemplates/{documentTemplateRID}/file

`POST` `/v1/documentTemplates/{documentTemplateRID}/file`

## Path parameters

- `documentTemplateRID` (string, required)

## Request body

Content types: `application/json-patch+json`, `application/json`, `text/json`, `application/*+json`

## Responses

- `204` - No Content
- `400` - Bad Request
- `401` - Unauthorized
- `404` - Not Found
- `500` - Server Error

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Document Generator API
  version: "1.0"
paths:
  /v1/documentTemplates/{documentTemplateRID}/file:
    post:
      tags:
        - DocumentTemplates
      parameters:
        - name: documentTemplateRID
          in: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json-patch+json:
            schema:
              $ref: "#/components/schemas/UploadedFileItem"
          application/json:
            schema:
              $ref: "#/components/schemas/UploadedFileItem"
          text/json:
            schema:
              $ref: "#/components/schemas/UploadedFileItem"
          application/*+json:
            schema:
              $ref: "#/components/schemas/UploadedFileItem"
      responses:
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProblemDetails"
        "401":
          description: Unauthorized
        "404":
          description: Not Found
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProblemDetails"
        "500":
          description: Server Error
security:
  - https://auth.sharefiletest.io:
      - docgen:all.full
      - docgen:doctemplate.packaging
      - docgen:doctemplate.template-provider
      - docgen:doctemplate.permanentdelete
components:
  schemas:
    UploadedFileItem:
      required:
        - fileId
        - fileName
      type: object
      properties:
        fileName:
          type: string
        fileId:
          type: string
        overwrite:
          type: boolean
        isSystemFile:
          type: boolean
        shouldAppendVersion:
          type: boolean
      additionalProperties: false
    ProblemDetails:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
      additionalProperties: {}
  securitySchemes:
    https://auth.sharefiletest.io:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://auth.sharefiletest.io/connect/authorize
          tokenUrl: https://auth.sharefiletest.io/connect/token
          scopes:
            docgen:all.full: Full access to Doc Gen APIs.
            docgen:doctemplate.packaging: Doc Template Packaging APIs Access
            docgen:doctemplate.template-provider: Document Templates full access to template provider
            docgen:doctemplate.permanentdelete: Access to permanently delete document template and metadata
```