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

# Create an export template

> Saves an export setup (its kinds of record, columns, filters and options) as a template under a name unique in the organization.



## OpenAPI

````yaml /openapi/en.json post /api/v1/orgs/{orgId}/core/exports/templates
openapi: 3.1.0
info:
  title: Ready for Commerce API
  version: 1.0.0
  description: >-
    The reference of every operation of the Ready for Commerce API. Every
    operation is in beta until launch.
servers:
  - url: https://app.readyforcommerce.com
security:
  - apiKey: []
tags:
  - name: Credentials
    description: >-
      The credential that calls: its organization, its permissions, its limits
      and the calls it may still make.
  - name: Organization
    description: 'The organization''s settings: its name, slug and currency.'
  - name: Billing
    description: >-
      The organization's subscription and each module's bill and cap, and this
      month's usage against its free allowance.
  - name: Record types
    description: >-
      The kinds of record the credential may import or export, with each one's
      fields and options.
  - name: Imports
    description: >-
      Bring CSV or Excel files in: upload or fetch a file, inspect and check it,
      then start the import and read its results.
  - name: Files
    description: An uploaded file's status, until it is ready or rejected.
  - name: Exports
    description: Export the records a filter matches to CSV or Excel files, kept 14 days.
  - name: Export templates
    description: Saved export setups, by name, to run the same export again.
  - name: Jobs
    description: >-
      Long work runs as a job: follow its state and progress, read its messages,
      download its files or cancel it.
  - name: Search
    description: >-
      Find the organization's records by words, a typo included, grouped by
      kind.
  - name: Version history
    description: >-
      A record's versions, newest first: compare one with another and restore
      the record to it.
  - name: Incidents
    description: >-
      The organization's problems you may see: mark them read or unread, and
      resolve them.
  - name: Notifications
    description: >-
      Your notifications, newest first: mark one read or unread, or all of them
      read.
  - name: Saved views
    description: >-
      A table's search, filters, order and columns saved under a name, yours or
      shared with the organization, and the view each table opens with for you.
  - name: Store connections
    description: >-
      The organization's stores, connected with their pasted keys: list them,
      connect one, reconnect it with new keys or disconnect it.
  - name: Products
    description: >-
      The organization's products with their options, variants and prices: list
      them, read one, create one, change one's content, its prices or its
      status, duplicate one as a draft, or delete one.
paths:
  /api/v1/orgs/{orgId}/core/exports/templates:
    post:
      tags:
        - Export templates
      summary: Create an export template
      description: >-
        Saves an export setup (its kinds of record, columns, filters and
        options) as a template under a name unique in the organization.
      operationId: coreCreateExportTemplate
      parameters:
        - schema:
            type: string
            format: uuid
          in: path
          name: orgId
          required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateExportTemplateInput'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExportTemplate'
        default:
          description: >-
            An error, as `application/problem+json`: its `code` says what went
            wrong and `params` holds its values
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/Problem'
                  - properties:
                      code:
                        enum:
                          - core.template_name_taken
                          - core.idempotency_in_progress
                          - core.idempotency_mismatch
                          - core.bad_request
                          - core.invalid_credential
                          - core.forbidden
                          - core.module_not_enabled
                          - core.module_read_only
                          - core.not_found
                          - core.conflict
                          - core.org_deletion_scheduled
                          - core.payload_too_large
                          - core.unsupported_media_type
                          - core.validation_failed
                          - core.rate_limited
                          - core.surface_disabled
                          - core.internal
                          - core.unavailable
components:
  schemas:
    CreateExportTemplateInput:
      type: object
      properties:
        name:
          type: string
          minLength: 1
          maxLength: 100
        definition:
          $ref: '#/components/schemas/ExportDefinitionInput'
      required:
        - name
        - definition
    ExportTemplate:
      type: object
      properties:
        id:
          type: string
          format: uuid
        module:
          type: string
          enum:
            - core
            - integrations
            - catalog
            - pricing
        name:
          type: string
        definition:
          $ref: '#/components/schemas/ExportDefinition'
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
      required:
        - id
        - module
        - name
        - definition
        - createdAt
        - updatedAt
      additionalProperties: false
    Problem:
      type: object
      properties:
        type:
          type: string
          pattern: ^urn:rfc:problem:[\s\S]{0,}\.[\s\S]{0,}$
        status:
          type: integer
        title:
          type: string
        code:
          type: string
          pattern: ^[\s\S]{0,}\.[\s\S]{0,}$
        params:
          type: object
          propertyNames:
            type: string
          additionalProperties: {}
        requestId:
          type: string
        errors:
          type: array
          items:
            type: object
            properties:
              location:
                type: string
              pointer:
                type: string
              code:
                type: string
              params:
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
            required:
              - location
              - pointer
              - code
            additionalProperties: false
      required:
        - type
        - status
        - code
        - requestId
      additionalProperties: false
    ExportDefinitionInput:
      type: object
      properties:
        entities:
          minItems: 1
          type: array
          items:
            type: object
            properties:
              entity:
                type: string
              columns:
                minItems: 1
                type: array
                items:
                  type: string
              question:
                type: object
                properties:
                  search:
                    type: string
                  filter:
                    type: object
                    properties:
                      items:
                        maxItems: 100
                        type: array
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            op:
                              type: string
                            value: {}
                          required:
                            - field
                            - op
                      logic:
                        type: string
                        enum:
                          - and
                          - or
                        examples:
                          - and
                    required:
                      - items
                      - logic
                  sort:
                    type: object
                    properties:
                      field:
                        type: string
                      direction:
                        type: string
                        enum:
                          - asc
                          - desc
                        examples:
                          - asc
                    required:
                      - field
                      - direction
            required:
              - entity
              - columns
              - question
        format:
          type: string
          enum:
            - csv
            - xlsx
          examples:
            - csv
        delimiter:
          default: ','
          type: string
          enum:
            - ','
            - ;
            - "\t"
            - '|'
        dateFormat:
          default: sql
          type: string
          enum:
            - sql
            - iso
        compression:
          default: none
          type: string
          enum:
            - none
            - gzip
            - zip
        listSeparator:
          default: '|'
          type: string
          minLength: 1
          maxLength: 3
        systemFields:
          default: false
          type: boolean
      required:
        - entities
        - format
    ExportDefinition:
      type: object
      properties:
        entities:
          minItems: 1
          type: array
          items:
            type: object
            properties:
              entity:
                type: string
              columns:
                minItems: 1
                type: array
                items:
                  type: string
              question:
                type: object
                properties:
                  search:
                    type: string
                  filter:
                    type: object
                    properties:
                      items:
                        maxItems: 100
                        type: array
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            op:
                              type: string
                            value: {}
                          required:
                            - field
                            - op
                          additionalProperties: false
                      logic:
                        type: string
                        enum:
                          - and
                          - or
                    required:
                      - items
                      - logic
                    additionalProperties: false
                  sort:
                    type: object
                    properties:
                      field:
                        type: string
                      direction:
                        type: string
                        enum:
                          - asc
                          - desc
                    required:
                      - field
                      - direction
                    additionalProperties: false
                additionalProperties: false
            required:
              - entity
              - columns
              - question
            additionalProperties: false
        format:
          type: string
          enum:
            - csv
            - xlsx
        delimiter:
          default: ','
          type: string
          enum:
            - ','
            - ;
            - "\t"
            - '|'
        dateFormat:
          default: sql
          type: string
          enum:
            - sql
            - iso
        compression:
          default: none
          type: string
          enum:
            - none
            - gzip
            - zip
        listSeparator:
          default: '|'
          type: string
          minLength: 1
          maxLength: 3
        systemFields:
          default: false
          type: boolean
      required:
        - entities
        - format
        - delimiter
        - dateFormat
        - compression
        - listSeparator
        - systemFields
      additionalProperties: false
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: >-
        An organization's API key, sent on every call as `Authorization: Bearer
        <key>`. A person of the organization creates it in the app, in
        **Settings › API and connections › API keys**.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.