Conga Custom Settings API

openapi: 3.2.0
info:
  title: Administration Custom Settings API
  version: 1.0.0
servers:
- url: https://rls.congacloud.com/api/revenue-admin/v1
security:
- Bearer: []
tags:
- name: CustomSettings
paths:
  /flows:
    get:
      tags:
      - CustomSettings
      summary: List flows
      description: Retrieves the list of the flows.
      responses:
        '200':
          description: OK
        '204':
          description: No Content
      operationId: getFlows
      x-operation-id-source: derived
    post:
      tags:
      - CustomSettings
      summary: Create flows
      description: Creates one or more custom flows based on the request body.The API also creates display action settings and display column settings with default values, which can be overriden or updated using the settings endpoints.
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Flow'
          text/json:
            schema:
              $ref: '#/components/schemas/Flow'
          application/*+json:
            schema:
              $ref: '#/components/schemas/Flow'
      responses:
        '201':
          description: Created
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/Flow'
            application/json:
              schema:
                $ref: '#/components/schemas/Flow'
            text/json:
              schema:
                $ref: '#/components/schemas/Flow'
      operationId: postFlows
      x-operation-id-source: derived
  /flows/{flowName}/views:
    get:
      tags:
      - CustomSettings
      summary: Retrieve column displays associated with a flow
      description: 'Retrieves the column displays for the flow passed in the parameter, based on the Display Column Settings configured and the Display Type. The columns are defined for the following Display Types which correspond to different sections on a CPQ page:


        Cart Line Item


        Cart Total Item


        Mass Update


        Cost Line Item


        Usage Price tiers


        Price Ramps


        Tierd Price


        Related Price


        Line Item Waterfall


        Option Line Item


        The API also retrieves the following details associated with the columns:


        Sequence: Defines sequence in which columns are displayed on CPQ pages.


        Field Name: The name of the column


        Is Editable: Indicates whether the column is editable in CPQ.


        Style: Defines the column text alignment using CSS styles.


        Style Class: Defines the style class used for the column.


        '''
      parameters:
      - name: flowName
        in: path
        description: The name of the flow
        required: true
        schema:
          type: string
          default: system
      - name: viewFor
        in: query
        description: The component associated with the flow
        schema:
          type: string
          default: Cart
      - name: search
        in: query
        description: Search with view field
        schema:
          type: string
      - name: sort
        in: query
        description: Sort the views
        schema:
          type: string
      responses:
        '200':
          description: OK
        '204':
          description: No Content
      operationId: getFlowsByFlowNameViews
      x-operation-id-source: derived
    post:
      tags:
      - CustomSettings
      summary: Create views
      description: Creates views for a flow.
      parameters:
      - name: flowName
        in: path
        description: The name of the flow
        required: true
        schema:
          type: string
          default: system
      - name: viewFor
        in: query
        description: The component associated with the flow
        schema:
          type: string
          default: Cart
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/View'
          text/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/View'
          application/*+json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/View'
      responses:
        '201':
          description: Created
          content:
            text/plain:
              schema:
                type: array
                items: {}
            application/json:
              schema:
                type: array
                items: {}
            text/json:
              schema:
                type: array
                items: {}
      operationId: postFlowsByFlowNameViews
      x-operation-id-source: derived
    put:
      tags:
      - CustomSettings
      summary: Update flow views
      description: Updates one or more views for a flow record.
      parameters:
      - name: flowName
        in: path
        description: The name of the flow
        required: true
        schema:
          type: string
          default: system
      - name: viewFor
        in: query
        description: The component associated with the flow
        schema:
          type: string
          default: Cart
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/View'
          text/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/View'
          application/*+json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/View'
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: array
                items: {}
            application/json:
              schema:
                type: array
                items: {}
            text/json:
              schema:
                type: array
                items: {}
      operationId: putFlowsByFlowNameViews
      x-operation-id-source: derived
  /flows/{flowName}/views/{viewName}:
    delete:
      tags:
      - CustomSettings
      summary: Delete flow views
      description: Deletes the views for a flow.
      parameters:
      - name: viewName
        in: path
        description: The name of the view
        required: true
        schema:
          type: string
      - name: flowName
        in: path
        description: The name of the flow
        required: true
        schema:
          type: string
          default: system
      - name: viewFor
        in: query
        description: The component associated with the flow
        schema:
          type: string
          default: Cart
      responses:
        '200':
          description: OK
        '404':
          description: Not Found
      operationId: deleteFlowsByFlowNameViewsByViewName
      x-operation-id-source: derived
    get:
      tags:
      - CustomSettings
      summary: Retrieve views associated with a flow
      description: Retrieves the views that are associated with the flow.
      parameters:
      - name: viewName
        in: path
        description: The name of the view
        required: true
        schema:
          type: string
      - name: flowName
        in: path
        description: The name of the flow
        required: true
        schema:
          type: string
          default: system
      - name: viewFor
        in: query
        description: The ccomponent associated with the flow
        schema:
          type: string
          default: Cart
      responses:
        '200':
          description: OK
        '204':
          description: No Content
      operationId: getFlowsByFlowNameViewsByViewName
      x-operation-id-source: derived
  /flows/{flowname}:
    delete:
      tags:
      - CustomSettings
      summary: Delete a flow
      description: Deletes a flow based on the flow name provided in the parameter.
      parameters:
      - name: flowname
        in: path
        description: ''
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: boolean
            application/json:
              schema:
                type: boolean
            text/json:
              schema:
                type: boolean
      operationId: deleteFlowsByFlowname
      x-operation-id-source: derived
    get:
      tags:
      - CustomSettings
      summary: Get a flow by name
      description: This API can be used to retrieve a single flow record.
      parameters:
      - name: flowname
        in: path
        description: ''
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
        '204':
          description: No Content
      operationId: getFlowsByFlowname
      x-operation-id-source: derived
    put:
      tags:
      - CustomSettings
      summary: Update a flow
      description: updates a flow based on the flow name provided in the parameter.
      parameters:
      - name: flowname
        in: path
        description: ''
        required: true
        schema:
          type: string
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Flow'
          text/json:
            schema:
              $ref: '#/components/schemas/Flow'
          application/*+json:
            schema:
              $ref: '#/components/schemas/Flow'
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/Flow'
            application/json:
              schema:
                $ref: '#/components/schemas/Flow'
            text/json:
              schema:
                $ref: '#/components/schemas/Flow'
      operationId: putFlowsByFlowname
      x-operation-id-source: derived
  /flows/{flowname}/actions:
    get:
      tags:
      - CustomSettings
      summary: Retrieve actions associated with a flow
      description: 'Retrieves actions for the flow passed in the parameter, based on the display action settings configured and the display type. The actions are defined for the following Display Types which correspond to different pages in CPQ:


        Cart Page


        Catalog Page


        Bundle Page


        Attribute Page


        Resolve


        configuration Page


        Installed Products Page


        Analyze Quote


        Cart Summary


        The API also retrieves the following details associated with the actions:


        Sequence: Defines sequence in which actions are displayed on CPQ pages.


        Action: API names of the actions.For example, Finalize andAddmoreproduct.


        Action Label Name: Actions lables that displayed on the CPQ pages. For example, Finalize and Close Cart.


        Display As: Defines whether given action is displayed as an Action or Task on the CPQ page.


        Action Area: Defines position on the page where action is displayed.For example, Left, Right, and Center.


        Action Style Class: Defines the style class used for the action.


        Action Page: The name of the Visualforce or custom page that is invoked for the respective action along with action params.


        Behavior: Defines the action page''''s behavior on opening the page in a dialog window, new window, or the same window.


        Action type: Defines the action type. For example, Quick Redirect, Save, and Quick Save.


        Is Enabled: Indicates whether the action is enabled or disabled.


        Always Display: Indicates that the actions are displayed even is they are disabled.The disabled actions are grayed out on the CPQ pages.'
      parameters:
      - name: flowname
        in: path
        description: ''
        required: true
        schema:
          type: string
          default: system
      responses:
        '200':
          description: OK
        '204':
          description: No Content
      operationId: getFlowsByFlownameActions
      x-operation-id-source: derived
    post:
      tags:
      - CustomSettings
      summary: Create flow actions
      description: Creates 1 or more flow actions.
      parameters:
      - name: flowname
        in: path
        description: ''
        required: true
        schema:
          type: string
          default: system
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              type: array
              items: {}
            example:
            - DisplayType: DisplayType
              ActionName: ActionName
              Name: Name
              Sequence: 1
              Flow: Flowname
              IsEnabled: true
              ActionArea: Flowname
              DisplayAs: Action
              AlwaysDisplay: true
              ActionLabelName: ActionLabelName
          text/json:
            schema:
              type: array
              items: {}
          application/*+json:
            schema:
              type: array
              items: {}
      responses:
        '201':
          description: Created
          content:
            text/plain:
              schema:
                type: array
                items: {}
            application/json:
              schema:
                type: array
                items: {}
            text/json:
              schema:
                type: array
                items: {}
      operationId: postFlowsByFlownameActions
      x-operation-id-source: derived
    put:
      tags:
      - CustomSettings
      summary: Update flow actions
      description: Creates, updates, and deletes flow actions based on the request body, for the flow passed in the parameter.
      parameters:
      - name: flowname
        in: path
        description: ''
        required: true
        schema:
          type: string
          default: system
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              type: array
              items: {}
            example:
            - DisplayType: DisplayType
              ActionName: ActionName
              Name: Name
              Sequence: 1
              Flow: Flowname
              IsEnabled: true
              ActionArea: Flowname
              DisplayAs: Action
              AlwaysDisplay: true
              ActionLabelName: ActionLabelName
          text/json:
            schema:
              type: array
              items: {}
          application/*+json:
            schema:
              type: array
              items: {}
      responses:
        '201':
          description: Created
          content:
            text/plain:
              schema:
                type: array
                items: {}
            application/json:
              schema:
                type: array
                items: {}
            text/json:
              schema:
                type: array
                items: {}
        '400':
          description: Bad Request
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/RevenueException'
            application/json:
              schema:
                $ref: '#/components/schemas/RevenueException'
            text/json:
              schema:
                $ref: '#/components/schemas/RevenueException'
      operationId: putFlowsByFlownameActions
      x-operation-id-source: derived
  /flows/{flowname}/displays:
    get:
      tags:
      - CustomSettings
      summary: Retrieve column displays associated with a flow
      description: 'Retrieves column displays for the flow passed in the parameter, based on the display column settings configured and the display type. The columns are defined for the following Display Types which correspond to different sections on a CPQ page:


        Cart Line Item


        Cart Total Item


        Mass Update


        Cost Line Item


        Usage Price tiers


        Price Ramps


        Tierd Price


        Related Price


        Line Item Waterfall


        Option Line Item


        The API also retrieves the following details associated with the columns:


        Sequence: Defines sequence in which columns are displayed on CPQ pages.


        Field Name: The name of the column


        Is Editable: Indicates whether the column is editable in CPQ.


        Style: Defines the column text alignment using CSS styles.


        Style Class: Defines the style class used for the column.


        '''
      parameters:
      - name: flowname
        in: path
        description: ''
        required: true
        schema:
          type: string
          default: system
      responses:
        '200':
          description: OK
        '204':
          description: No Content
      operationId: getFlowsByFlownameDisplays
      x-operation-id-source: derived
    post:
      tags:
      - CustomSettings
      summary: Create flow displays
      description: Creates 1 or more displays for a flow.
      parameters:
      - name: flowname
        in: path
        description: ''
        required: true
        schema:
          type: string
          default: system
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              type: array
              items: {}
            example:
            - DisplayType: DisplayType
              Flow: FlowName
              Name: Name
              FieldLength: 18
              FieldName: FieldName
              FieldType: FieldType
              IsCalculated: true
              IsEditable: true
              IsPricePoint: false
              IsSortable: false
              Label: Label
              ObjectType: null
              Sequence: 1
              Scale: 5
              Style: null
              StyleClass: null
              SObjectName: null
              Controller: null
              IsRichTextchText: false
          text/json:
            schema:
              type: array
              items: {}
          application/*+json:
            schema:
              type: array
              items: {}
      responses:
        '201':
          description: Created
      operationId: postFlowsByFlownameDisplays
      x-operation-id-source: derived
    put:
      tags:
      - CustomSettings
      summary: Update flow displays
      description: Updates 1 more displays for a flow record.
      parameters:
      - name: flowname
        in: path
        description: ''
        required: true
        schema:
          type: string
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              type: array
              items: {}
            example:
            - DisplayType: DisplayType
              Flow: FlowName
              Name: Name
              FieldLength: 18
              FieldName: FieldName
              FieldType: FieldType
              IsCalculated: true
              IsEditable: true
              IsPricePoint: false
              IsSortable: false
              Label: Label
              ObjectType: null
              Sequence: 1
              Scale: 5
              Style: null
              StyleClass: null
              SObjectName: null
              Controller: null
              IsRichTextchText: false
          text/json:
            schema:
              type: array
              items: {}
          application/*+json:
            schema:
              type: array
              items: {}
      responses:
        '201':
          description: Created
        '400':
          description: Bad Request
      operationId: putFlowsByFlownameDisplays
      x-operation-id-source: derived
  /flows/{flowname}/settings:
    get:
      tags:
      - CustomSettings
      summary: Retrieve custom setting defined for a flow
      description: 'Retrieves the custom settings defined for a flow name provided in the parameter. When custom settings are defined at both flow-level and global-level, flow-level take precedence over global settings in response the API retrieves.

        The API retrieves the following custom settings:


        Config System Properties


        Config Select Config Products Settings


        Config Select Bundle Options Settings


        Incentive System Properties


        Installed Products Settings


        The above-mentioned custom settings are categorized into the following:


        Config Page Settings


        Catalog Page Settings


        Cart Page Settings


        Pricing Engine


        Configuration Engine


        Promotions Settings


        Asset Settings


        Incentives Settings


        Favorite Settings'
      parameters:
      - name: flowname
        in: path
        description: ''
        required: true
        schema:
          type: string
          default: system
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: object
                additionalProperties: {}
            application/json:
              schema:
                type: object
                additionalProperties: {}
            text/json:
              schema:
                type: object
                additionalProperties: {}
        '204':
          description: No Content
      operationId: getFlowsByFlownameSettings
      x-operation-id-source: derived
  /flows/{flowname}/settings/{settingname}:
    delete:
      tags:
      - CustomSettings
      summary: Delete settings
      description: Deletes a setting or child setting for a flow.
      parameters:
      - name: settingname
        in: path
        description: ''
        required: true
        schema:
          type: string
      - name: childsettingname
        in: query
        description: ''
        schema:
          type: string
      - name: flowname
        in: path
        description: ''
        required: true
        schema:
          type: string
          default: system
      responses:
        '200':
          description: OK
        '204':
          description: No Content
      operationId: deleteFlowsByFlownameSettingsBySettingname
      x-operation-id-source: derived
    get:
      tags:
      - CustomSettings
      summary: Retrieve custom settings associated with a flow
      description: 'Retrieves the following categories of setting associated with a flow name provided in the parameters.


        Config Page Settings


        Catalog Page Settings


        The above-mentioned settings are divided into the following custom settings or child settings which are used in the `settingName` parameter to retrieve the fields belonging to it.


        Config System Properties


        Config Select Config Products Settings


        Config Select Bundle Options Settings


        The `childSettingName` is not supported in this release'
      parameters:
      - name: settingname
        in: path
        description: ''
        required: true
        schema:
          type: string
      - name: childsettingname
        in: query
        description: ''
        schema:
          type: string
      - name: flowname
        in: path
        description: ''
        required: true
        schema:
          type: string
          default: system
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: object
                additionalProperties: {}
            application/json:
              schema:
                type: object
                additionalProperties: {}
            text/json:
              schema:
                type: object
                additionalProperties: {}
        '204':
          description: No Content
      operationId: getFlowsByFlownameSettingsBySettingname
      x-operation-id-source: derived
    post:
      tags:
      - CustomSettings
      summary: Create settings
      description: Creates a setting or child setting for a flow.
      parameters:
      - name: settingname
        in: path
        description: ''
        required: true
        schema:
          type: string
      - name: childsettingname
        in: query
        description: ''
        schema:
          type: string
      - name: flowname
        in: path
        description: ''
        required: true
        schema:
          type: string
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              type: object
              additionalProperties: {}
            example:
              key1: value1
              key2: value2
          text/json:
            schema:
              type: object
              additionalProperties: {}
          application/*+json:
            schema:
              type: object
              additionalProperties: {}
      responses:
        '201':
          description: Created
          content:
            text/plain:
              schema:
                type: array
                items: {}
            application/json:
              schema:
                type: array
                items: {}
            text/json:
              schema:
                type: array
                items: {}
      operationId: postFlowsByFlownameSettingsBySettingname
      x-operation-id-source: derived
    put:
      tags:
      - CustomSettings
      summary: Update custom settings associated with a flow
      description: 'Updates the following categories of setting associated with a flow name provided in the parameters.


        Config Page Settings


        Catalog Page Settings


        The above-mentioned settings are divided into the following custom settings or child settings which are used in the `settingName` parameter to update the fields belonging to it.


        Config System Properties


        Config Select Config Products Settings


        Config Select Bundle Options Settings


        The `childSettingName` is not supported in this release.'
      parameters:
      - name: settingname
        in: path
        description: ''
        required: true
        schema:
          type: string
      - name: childsettingname
        in: query
        description: ''
        schema:
          type: string
      - name: flowname
        in: path
        description: ''
        required: true
        schema:
          type: string
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              type: object
              additionalProperties: {}
            example:
              key1: value1
              key2: value2
          text/json:
            schema:
              type: object
              additionalProperties: {}
          application/*+json:
            schema:
              type: object
              additionalProperties: {}
      responses:
        '201':
          description: Created
          content:
            text/plain:
              schema:
                type: array
                items: {}
            application/json:
              schema:
                type: array
                items: {}
            text/json:
              schema:
                type: array
                items: {}
      operationId: putFlowsByFlownameSettingsBySettingname
      x-operation-id-source: derived
  /flows/{flowname}/settings/{settingname}/{childsettingname}:
    delete:
      tags:
      - CustomSettings
      summary: Delete settings
      description: Deletes a setting or child setting for a flow.
      parameters:
      - name: settingname
        in: path
        description: ''
        required: true
        schema:
          type: string
      - name: childsettingname
        in: path
        description: ''
        required: true
        schema:
          type: string
      - name: flowname
        in: path
        description: ''
        required: true
        schema:
          type: string
          default: system
      responses:
        '200':
          description: OK
        '204':
          description: No Content
      operationId: deleteFlowsByFlownameSettingsBySettingnameByChildsettingname
      x-operation-id-source: derived
    get:
      tags:
      - CustomSettings
      summary: Retrieve custom settings associated with a flow
      description: 'Retrieves the following categories of setting associated with a flow name provided in the parameters.


        Config Page Settings


        Catalog Page Settings


        The above-mentioned settings are divided into the following custom settings or child settings which are used in the `settingName` parameter to retrieve the fields belonging to it.


        Config System Properties


        Config Select Config Products Settings


        Config Select Bundle Options Settings


        The `childSettingName` is not supported in this release'
      parameters:
      - name: settingname
        in: path
        description: ''
        required: true
        schema:
          type: string
      - name: childsettingname
        in: path
        description: ''
        required: true
        schema:
          type: string
      - name: flowname
        in: path
        description: ''
        required: true
        schema:
          type: string
          default: system
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: object
                additionalProperties: {}
            application/json:
              schema:
                type: object
                additionalProperties: {}
            text/json:
              schema:
                type: object
                additionalProperties: {}
        '204':
          description: No Content
      operationId: getFlowsByFlownameSettingsBySettingnameByChildsettingname
      x-operation-id-source: derived
    post:
      tags:
      - CustomSettings
      summary: Create settings
      description: Creates a setting or child setting for a flow.
      parameters:
      - name: settingname
        in: path
        description: ''
        required: true
        schema:
          type: string
      - name: childsettingname
        in: path
        description: ''
        required: true
        schema:
          type: string
      - name: flowname
        in: path
        description: ''
        required: true
        schema:
          type: string
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              type: object
              additionalProperties: {}
            example:
              key1: value1
              key2: value2
          text/json:
            schema:
              type: object
              additionalProperties: {}
          application/*+json:
            schema:
              type: object
              additionalProperties: {}
      responses:
        '201':
          description: Created
          content:
            text/plain:
              schema:
                type: array
                items: {}
            application/json:
              schema:
                type: array
                items: {}
            text/json:
              schema:
                type: array
                items: {}
      operationId: postFlowsByFlownameSettingsBySettingnameByChildsettingname
      x-operation-id-source: derived
    put:
      tags:
      - CustomSettings
      summary: Update custom settings associated with a flow
      description: 'Updates the following categories of setting associated with a flow name provided in the parameters.


        Config Page Settings


        Catalog Page Settings


        The above-mentioned settings are divided into the following custom settings or child settings which are used in the `settingName` parameter to update the fields belonging to it.


        Config System Properties


        Config Select Config Products Settings


        Config Select Bundle Options Settings


        The `childSettingName` is not supported in this release.'
      parameters:
      - name: settingname
     

# --- truncated at 32 KB (75 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/openapi/conga-customsettings-api-openapi.yml