openapi: 3.1.0
info:
  title: Formstack Confirmations Folders API
  description: 'REST API for Formstack — manage forms, fields, submissions, confirmations,

    notifications, webhooks, themes, folders, portals, smart lists, subaccounts,

    submit actions, and partial submissions. Authentication uses OAuth 2.0.


    Detailed endpoint definitions are derived from the public developer portal

    at https://developers.formstack.com/ (machine-readable index at

    https://developers.formstack.com/llms.txt).

    '
  version: 2025.0
  contact:
    name: Formstack Developers
    url: https://developers.formstack.com/
servers:
- url: https://www.formstack.com/api/v2
  description: Production v2
security:
- oauth2: []
tags:
- name: Folders
paths:
  /folder.json:
    get:
      summary: List folders
      operationId: listFolders
      tags:
      - Folders
      responses:
        '200':
          description: Folders.
    post:
      summary: Create folder
      operationId: createFolder
      tags:
      - Folders
      responses:
        '200':
          description: Created.
  /folder/{folderId}.json:
    parameters:
    - $ref: '#/components/parameters/folderId'
    get:
      summary: Get folder
      operationId: getFolder
      tags:
      - Folders
      responses:
        '200':
          description: Folder.
    put:
      summary: Update folder
      operationId: updateFolder
      tags:
      - Folders
      responses:
        '200':
          description: Updated.
    delete:
      summary: Delete folder
      operationId: deleteFolder
      tags:
      - Folders
      responses:
        '200':
          description: Deleted.
components:
  parameters:
    folderId:
      name: folderId
      in: path
      required: true
      schema:
        type: string
  securitySchemes:
    oauth2:
      type: oauth2
      description: OAuth 2.0 authorization code flow.
      flows:
        authorizationCode:
          authorizationUrl: https://www.formstack.com/api/v2/oauth2/authorize
          tokenUrl: https://www.formstack.com/api/v2/oauth2/token
          scopes:
            forms_read: Read forms
            forms_write: Manage forms
            submissions_read: Read submissions
            submissions_write: Manage submissions