Mend

Mend Settings - In-House API

The Settings - In-House API from Mend — 4 operation(s) for settings - in-house.

GitHub OpenAPI

Operations 8

PUT /api/v2.0/orgs/{orgToken}/settings/inHouse/{ruleUuid} Update single InHouse Rule #
DELETE /api/v2.0/orgs/{orgToken}/settings/inHouse/{ruleUuid} Delete Single In-House Rule #
PUT /api/v2.0/orgs/{orgToken}/settings/inHouse/rules Update Multiple In-House Rules #
POST /api/v2.0/orgs/{orgToken}/settings/inHouse/rules Create Multiple In-House Rules #
DELETE /api/v2.0/orgs/{orgToken}/settings/inHouse/rules Delete multiple InhHouse rules #
PUT /api/v2.0/orgs/{orgToken}/settings/inHouse/apply Apply In-House Rules #
GET /api/v2.0/orgs/{orgToken}/settings/inHouse Get In-House Settings #
POST /api/v2.0/orgs/{orgToken}/settings/inHouse Create Single In-House Rule #

Documentation

📖
APIReference
https://api-docs.mend.io/platform/3.0
📖
APIReference
https://api-docs.mend.io/sca/2.0

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/mend/refs/heads/main/openapi/mend-settings-in-house-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/mend/refs/heads/main/json-schema/mend-dwrresponse-pageable-in-house-settings-dto-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/mend/refs/heads/main/json-schema/mend-dwrresponse-warning-list-in-house-rule-dto-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/mend/refs/heads/main/json-schema/mend-dwrresponse-warning-in-house-rule-dto-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/mend/refs/heads/main/json-schema/mend-update-in-house-rules-request-dto-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/mend/refs/heads/main/json-schema/mend-create-in-house-rule-request-dto-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/mend/refs/heads/main/json-schema/mend-update-in-house-rule-request-dto-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/mend:mend-settings-in-house-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mend-settings-in-house-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Mend Settings - In-House API
  description: Mend's enhanced SCA API enables automation of workflows in a REST compliant format.
  version: '2.0'
servers:
- url: https://api-saas.mend.io
  description: Generated server url
security:
- bearer-key: []
tags:
- name: Settings - In-House
paths:
  /api/v2.0/orgs/{orgToken}/settings/inHouse/{ruleUuid}:
    put:
      tags:
      - Settings - In-House
      summary: Update single InHouse Rule
      description: Updates a single In-House library rule
      operationId: updateInHouseRule
      parameters:
      - name: orgToken
        in: path
        description: 'org UUID (by running Entities - Organization > Get User Organizations) or API Key (from the Mend SCA App: **Integrate** tab > **API Key**).'
        required: true
        schema:
          type: string
      - name: ruleUuid
        in: path
        description: The In-House rule UUID
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateInHouseRuleRequestDTO'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DWRResponseWarningInHouseRuleDTO'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
    delete:
      tags:
      - Settings - In-House
      summary: Delete Single In-House Rule
      description: Deletes a single In-House library rule
      operationId: deleteInHouseRule
      parameters:
      - name: orgToken
        in: path
        description: 'org UUID (by running Entities - Organization > Get User Organizations) or API Key (from the Mend SCA App: **Integrate** tab > **API Key**).'
        required: true
        schema:
          type: string
      - name: ruleUuid
        in: path
        description: The InHouse rule UUID
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DWRResponseMessageDTO'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
  /api/v2.0/orgs/{orgToken}/settings/inHouse/rules:
    put:
      tags:
      - Settings - In-House
      summary: Update Multiple In-House Rules
      description: Updates the pattern-mat§ching rules of an In-House library rule
      operationId: updateAllowListRulesSettings
      parameters:
      - name: orgToken
        in: path
        description: 'org UUID (by running Entities - Organization > Get User Organizations) or API Key (from the Mend SCA App: **Integrate** tab > **API Key**).'
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/UpdateInHouseRulesRequestDTO'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DWRResponseMessageDTO'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
    post:
      tags:
      - Settings - In-House
      summary: Create Multiple In-House Rules
      description: Creates one or more in-house library rules
      operationId: addInHouseRules
      parameters:
      - name: orgToken
        in: path
        description: 'org UUID (by running Entities - Organization > Get User Organizations) or API Key (from the Mend SCA App: **Integrate** tab > **API Key**).'
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/CreateInHouseRuleRequestDTO'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DWRResponseWarningListInHouseRuleDTO'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
    delete:
      tags:
      - Settings - In-House
      summary: Delete multiple InhHouse rules
      description: Deletes one or more in-house library rules
      operationId: deleteInHouseRules
      parameters:
      - name: orgToken
        in: path
        description: 'org UUID (by running Entities - Organization > Get User Organizations) or API Key (from the Mend SCA App: **Integrate** tab > **API Key**).'
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/DeleteInHouseRuleRequestDTO'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DWRResponseMessageDTO'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
  /api/v2.0/orgs/{orgToken}/settings/inHouse/apply:
    put:
      tags:
      - Settings - In-House
      summary: Apply In-House Rules
      description: Applies the current In-House library rules to a given organization. Use this request after creating and/or updating In-House rules
      operationId: applyWhiteListRules_1
      parameters:
      - name: orgToken
        in: path
        description: 'org UUID (by running Entities - Organization > Get User Organizations) or API Key (from the Mend SCA App: **Integrate** tab > **API Key**).'
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DWRResponseMessageDTO'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
  /api/v2.0/orgs/{orgToken}/settings/inHouse:
    get:
      tags:
      - Settings - In-House
      summary: Get In-House Settings
      description: Returns a list of all In-House library rules for a given organization
      operationId: getOrgProprietaryRules
      parameters:
      - name: pageSize
        in: query
        description: Enter the number of items to return in each page of the result.
        allowEmptyValue: true
        schema:
          maximum: 10000
          type: string
          default: '50'
      - name: page
        in: query
        allowEmptyValue: true
        schema:
          type: string
          default: '0'
      - name: orgToken
        in: path
        description: 'org UUID (by running Entities - Organization > Get User Organizations) or API Key (from the Mend SCA App: **Integrate** tab > **API Key**).'
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DWRResponsePageableInHouseSettingsDTO'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
    post:
      tags:
      - Settings - In-House
      summary: Create Single In-House Rule
      description: Creates a single In-House rule to match libraries by name or maven coordinates (artifact id, group id) and designate these libraries as known, trusted entities
      operationId: addProprietaryRule
      parameters:
      - name: orgToken
        in: path
        description: 'org UUID (by running Entities - Organization > Get User Organizations) or API Key (from the Mend SCA App: **Integrate** tab > **API Key**).'
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateInHouseRuleRequestDTO'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DWRResponseWarningInHouseRuleDTO'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
components:
  schemas:
    DWRResponseBase:
      type: object
      properties:
        supportToken:
          title: Support Token
          type: string
          example: 1171c60d
    InHouseSettingsDTO:
      type: object
      properties:
        rules:
          type: array
          items:
            $ref: '#/components/schemas/InHouseRuleDTO'
        active:
          type: boolean
    InHouseRuleDTO:
      required:
      - type
      type: object
      properties:
        uuid:
          type: string
        type:
          title: InHouse Rule Regex Type
          type: string
          enum:
          - NAME
          - LIBRARY_COORDINATES
          - ARTIFACT_ID
        regex:
          title: InHouse Regex Rule
          type: string
          example: .*a*
        description:
          title: InHouse Rule Description
          type: string
        createdAt:
          type: string
          format: date-time
        createdBy:
          title: Created By
          type: string
          description: Jon.Snow
        empty:
          type: boolean
    MessageDTO:
      type: object
      properties:
        message:
          title: message
          type: string
          example: Success!
    DeleteInHouseRuleRequestDTO:
      required:
      - uuid
      type: object
      properties:
        uuid:
          title: InHouse Rule UUID
          type: string
          example: 123e4567-e89b-12d3-a456-426655440000
        empty:
          type: boolean
    UpdateInHouseRuleRequestDTO:
      type: object
      properties:
        type:
          title: InHouse Rule Regex Type
          type: string
          example: NAME
          enum:
          - NAME
          - LIBRARY_COORDINATES
          - ARTIFACT_ID
        regex:
          title: InHouse Regex Rule
          type: string
          example: '*aa*'
        description:
          title: InHouse Description
          type: string
          example: description for InHouse rule
        empty:
          type: boolean
    CreateInHouseRuleRequestDTO:
      required:
      - regex
      - type
      type: object
      properties:
        type:
          title: InHouse Rule Regex Type
          type: string
          example: NAME
          enum:
          - NAME
          - LIBRARY_COORDINATES
          - ARTIFACT_ID
        regex:
          title: InHouse Regex Rule
          type: string
          example: '*aa*'
        description:
          title: InHouse Description
          type: string
          example: description for inHouse rule
        empty:
          type: boolean
    DWRResponseWarningListInHouseRuleDTO:
      title: Initiates the update process for an individual In-House library rule
      type: object
      properties:
        additionalData:
          title: 'Provides warning messages for notifying about conditions related to the '
          type: object
          description: '+ **warningMessage**: Serves as an alert to inform you about the status of the rule being updated.

            The warning message will provide information about whether the rule already exists or if some of the rules are already present'
          example:
            warningMessage: item already exists
        supportToken:
          title: Support Token
          type: string
          example: 1171c60d
        retVal:
          type: array
          items:
            $ref: '#/components/schemas/InHouseRuleDTO'
      description: ddsc
    DWRResponsePageableInHouseSettingsDTO:
      type: object
      properties:
        additionalData:
          title: Provides insights into endpoint-supported pagination information.
          type: object
          description: '+ **totalItems**: The total count of data points returned in an API response.

            + **isLastPage**: Defines whether the current page represents the conclusion of the API response. When “true”, this signifies you are viewing the last page of the API response. When “false”, this indicates there are further pages remaining.'
          example:
            totalItems: '422'
            isLastPage: 'true'
        supportToken:
          title: Support Token
          type: string
          example: 1171c60d
        retVal:
          $ref: '#/components/schemas/InHouseSettingsDTO'
      description: Provides insights into endpoint-supported pagination information
    DWRResponseMessageDTO:
      type: object
      properties:
        supportToken:
          title: Support Token
          type: string
          example: 1171c60d
        retVal:
          $ref: '#/components/schemas/MessageDTO'
    DWRResponseWarningInHouseRuleDTO:
      title: Initiates the update process for an individual In-House library rule
      type: object
      properties:
        additionalData:
          title: 'Provides warning messages for notifying about conditions related to the '
          type: object
          description: '+ **warningMessage**: Serves as an alert to inform you about the status of the rule being updated.

            The warning message will provide information about whether the rule already exists or if some of the rules are already present'
          example:
            warningMessage: item already exists
        supportToken:
          title: Support Token
          type: string
          example: 1171c60d
        retVal:
          $ref: '#/components/schemas/InHouseRuleDTO'
      description: ddsc
    UpdateInHouseRulesRequestDTO:
      required:
      - uuid
      type: object
      properties:
        uuid:
          title: Proprietary Rule UUID
          type: string
          example: 123e4567-e89b-12d3-a456-426655440000
        type:
          title: Proprietary Rule Regex Type
          type: string
          example: NAME
          enum:
          - NAME
          - LIBRARY_COORDINATES
          - ARTIFACT_ID
        regex:
          title: Proprietary Regex Rule
          type: string
          example: '*aa*'
        description:
          title: Proprietary Description
          type: string
          example: description for white list
        empty:
          type: boolean
  securitySchemes:
    bearer-key:
      type: http
      description: JWT token Bearer
      scheme: bearer
      bearerFormat: JWT