Mend

Mend SAML Integration - Organization API

The SAML Integration - Organization API from Mend — 6 operation(s) for saml integration - organization.

GitHub OpenAPI
Business capability
Tenant Identity Federation BC-4230.50

Operations 12

GET /api/v3.0/orgs/{scopeUuid}/saml/settings Get SAML Setting #
PUT /api/v3.0/orgs/{scopeUuid}/saml/settings Update SAML Setting #
POST /api/v3.0/orgs/{scopeUuid}/saml/settings Create SAML Setting #
DELETE /api/v3.0/orgs/{scopeUuid}/saml/settings Remove SAML Setting #
GET /api/v2.0/orgs/{contextIdentifier}/saml/settings Get SAML Setting #
PUT /api/v2.0/orgs/{contextIdentifier}/saml/settings Update SAML Setting #
POST /api/v2.0/orgs/{contextIdentifier}/saml/settings Create SAML Setting #
DELETE /api/v2.0/orgs/{contextIdentifier}/saml/settings Remove SAML Setting #
GET /api/v3.0/orgs/{scopeUuid}/saml/mappings Get SAML Role to Groups Mapping #
GET /api/v3.0/orgs/{scopeUuid}/saml/attributes Get SAML Attribute Mapping #
GET /api/v2.0/orgs/{contextIdentifier}/saml/mappings Get SAML Role to Groups Mapping #
GET /api/v2.0/orgs/{contextIdentifier}/saml/attributes Get SAML Attribute Mapping #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/mend/openapi/mend-saml-integration-organization-api-openapi.yml

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-saml-integration-organization-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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-saml-integration-organization-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Mend SAML Integration - Organization API
  description: 'Mend''s enhanced SCA API enables automation of workflows in a REST compliant format. The API features:

    + Access for any user with Mend credentials, via a user key available in the user''s profile page in the Mend App.

    + Improved security with a JWT token per organization, which expires every 10 minutes.

    + Added scalability with support for pagination, filtering and sorting search results.

    + Broader functionality available programmatically.

    + New standard API documentation for easy navigation and search.


    **Note:** To help you get started with the Mend SCA API 2.0, we recommend reviewing our onboarding guide -> Getting Started with Mend SCA API 2.0.

    This resource covers initial setup, authentication instructions, and helpful tips to help you successfully begin working with the Mend SCA API 2.0. If you have a dedicated instance of Mend, contact your Mend representative to access this API on your instance.'
  version: 3.0.1
servers:
- url: https://api-saas.mend.io
  description: Generated server url
security:
- bearer-key: []
tags:
- name: SAML Integration - Organization
paths:
  /api/v3.0/orgs/{scopeUuid}/saml/settings:
    get:
      tags:
      - SAML Integration - Organization
      summary: Get SAML Setting
      description: Returns SAML Setting
      operationId: getSAMLSettings
      parameters:
      - name: scopeUuid
        in: path
        description: Scope UUID (Account/Organization)
        required: true
        schema:
          type: string
      responses:
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DWRResponseV3SAMLSettingDTO'
    put:
      tags:
      - SAML Integration - Organization
      summary: Update SAML Setting
      description: Returns SAML token
      operationId: updateSAMLSettings
      parameters:
      - name: scopeUuid
        in: path
        description: Scope UUID (Account/Organization)
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SAMLSettingsRequestDTO'
        required: true
      responses:
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DWRResponseV3SAMLSettingDTO'
    post:
      tags:
      - SAML Integration - Organization
      summary: Create SAML Setting
      description: Returns SAML token
      operationId: createSAMLSettings
      parameters:
      - name: scopeUuid
        in: path
        description: Scope UUID (Account/Organization)
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SAMLSettingsRequestDTO'
        required: true
      responses:
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DWRResponseV3SAMLSettingDTO'
    delete:
      tags:
      - SAML Integration - Organization
      summary: Remove SAML Setting
      description: Returns SAML token
      operationId: removeSAMLSettings
      parameters:
      - name: scopeUuid
        in: path
        description: Scope UUID (Account/Organization)
        required: true
        schema:
          type: string
      responses:
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DWRResponseV3String'
  /api/v2.0/orgs/{contextIdentifier}/saml/settings:
    get:
      tags:
      - SAML Integration - Organization
      summary: Get SAML Setting
      description: Returns SAML Setting
      operationId: getSAMLSettings_2
      parameters:
      - name: contextIdentifier
        in: path
        description: entity UUID or ApiToken (organization, product or project).
        required: true
        schema:
          type: string
      responses:
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SAMLSettingDTO'
    put:
      tags:
      - SAML Integration - Organization
      summary: Update SAML Setting
      description: Returns SAML token
      operationId: updateSAMLSettings_2
      parameters:
      - name: contextIdentifier
        in: path
        description: entity UUID or ApiToken (organization, product or project).
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SAMLSettingsRequestDTO'
        required: true
      responses:
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SAMLSettingDTO'
    post:
      tags:
      - SAML Integration - Organization
      summary: Create SAML Setting
      description: Returns SAML token
      operationId: createSAMLSettings_2
      parameters:
      - name: contextIdentifier
        in: path
        description: entity UUID or ApiToken (organization, product or project).
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SAMLSettingsRequestDTO'
        required: true
      responses:
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SAMLSettingDTO'
    delete:
      tags:
      - SAML Integration - Organization
      summary: Remove SAML Setting
      description: Returns SAML token
      operationId: removeSAMLSettings_2
      parameters:
      - name: contextIdentifier
        in: path
        description: entity UUID or ApiToken (organization, product or project).
        required: true
        schema:
          type: string
      responses:
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: string
  /api/v3.0/orgs/{scopeUuid}/saml/mappings:
    get:
      tags:
      - SAML Integration - Organization
      summary: Get SAML Role to Groups Mapping
      description: Returns SAML Role to Groups Mapping
      operationId: getSamlRoleGroupsMapping
      parameters:
      - name: scopeUuid
        in: path
        description: Scope UUID (Account/Organization)
        required: true
        schema:
          type: string
      responses:
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DWRResponseV3CollectionSamlRoleGroupsMappingDTO'
  /api/v3.0/orgs/{scopeUuid}/saml/attributes:
    get:
      tags:
      - SAML Integration - Organization
      summary: Get SAML Attribute Mapping
      description: Returns SAML Attribute Mapping
      operationId: getSamlAttributes
      parameters:
      - name: scopeUuid
        in: path
        description: Scope UUID (Account/Organization)
        required: true
        schema:
          type: string
      responses:
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DWRResponseV3MapSamlAttributeKeyTypeString'
  /api/v2.0/orgs/{contextIdentifier}/saml/mappings:
    get:
      tags:
      - SAML Integration - Organization
      summary: Get SAML Role to Groups Mapping
      description: Returns SAML Role to Groups Mapping
      operationId: getSamlRoleGroupsMapping_2
      parameters:
      - name: contextIdentifier
        in: path
        description: entity UUID or ApiToken (organization, product or project).
        required: true
        schema:
          type: string
      responses:
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SamlRoleGroupsMappingDTO'
  /api/v2.0/orgs/{contextIdentifier}/saml/attributes:
    get:
      tags:
      - SAML Integration - Organization
      summary: Get SAML Attribute Mapping
      description: Returns SAML Attribute Mapping
      operationId: getSamlAttributes_2
      parameters:
      - name: contextIdentifier
        in: path
        description: entity UUID or ApiToken (organization, product or project).
        required: true
        schema:
          type: string
      responses:
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/DWRResponseBase'
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  type: string
components:
  schemas:
    SAMLSettingsRequestDTO:
      type: object
      properties:
        metadataType:
          type: string
          enum:
          - URL
          - XML
          - FILE
        metadataLink:
          type: string
        metadataInfo:
          type: string
        idpDomains:
          type: array
          items:
            type: string
        allAttributeKeys:
          type: object
          additionalProperties:
            type: string
        roleGroupsMapping:
          type: array
          items:
            $ref: '#/components/schemas/SamlRoleGroupsMappingDTO'
        enableIdpInitiatedLogin:
          type: boolean
        enforceSsoOnLogin:
          type: boolean
        justInTimeProvisioning:
          type: boolean
    GroupInfoDTO:
      required:
      - uuid
      type: object
      properties:
        uuid:
          title: Group Uuid
          type: string
          example: 123e4567-e89b-12d3-a456-426655440000
        name:
          title: Group Name
          type: string
          example: Group A
        description:
          title: Group Description
          type: string
          example: A description for a group
        domainUUID:
          title: Domain Uuid
          type: string
          example: 123e4567-e89b-12d3-a456-426655440000
        domainName:
          title: Domain Name
          type: string
          example: Domain A
        globalAccountUUID:
          title: Global Account Uuid
          type: string
          example: 123e4567-e89b-12d3-a456-426655440000
        userUUIDs:
          uniqueItems: true
          type: array
          items:
            title: User Uuid
            type: string
            example: 123e4567-e89b-12d3-a456-426655440000
    DWRResponseBase:
      type: object
      properties:
        supportToken:
          title: Support Token
          type: string
          example: 1171c60d
    DWRResponseV3CollectionSamlRoleGroupsMappingDTO:
      type: object
      properties:
        additionalData:
          type: object
          additionalProperties:
            type: object
        supportToken:
          type: string
        response:
          type: array
          items:
            $ref: '#/components/schemas/SamlRoleGroupsMappingDTO'
    SAMLSettingDTO:
      type: object
      properties:
        id:
          type: string
        isActive:
          type: boolean
        metadataType:
          type: string
          enum:
          - URL
          - XML
          - FILE
        entityID:
          type: string
        replyUrl:
          type: string
        idpDomains:
          type: array
          items:
            type: string
        metadataLink:
          type: string
        allAttributeKeys:
          type: object
          additionalProperties:
            type: string
        roleGroupsMapping:
          type: array
          items:
            $ref: '#/components/schemas/SamlRoleGroupsMappingDTO'
        expiresAt:
          type: string
          format: date-time
        enableIdpInitiatedLogin:
          type: boolean
        enforceSsoOnLogin:
          type: boolean
        justInTimeProvisioning:
          type: boolean
        signingPreview:
          $ref: '#/components/schemas/SamlSigningPreview'
    DWRResponseV3String:
      type: object
      properties:
        supportToken:
          title: Support Token
          type: string
          example: 1171c60d
        response:
          type: string
    DWRResponseV3MapSamlAttributeKeyTypeString:
      type: object
      properties:
        additionalData:
          type: object
          additionalProperties:
            type: object
        supportToken:
          type: string
        response:
          type: object
          additionalProperties:
            type: string
    DWRResponseV3SAMLSettingDTO:
      type: object
      properties:
        additionalData:
          type: object
          additionalProperties:
            type: object
        supportToken:
          type: string
        response:
          $ref: '#/components/schemas/SAMLSettingDTO'
    SamlSigningPreview:
      type: object
      properties:
        subject:
          type: object
          additionalProperties:
            type: string
        thumbprint:
          type: string
    SamlRoleGroupsMappingDTO:
      type: object
      properties:
        roleName:
          type: string
        roleGroups:
          type: array
          items:
            $ref: '#/components/schemas/GroupInfoDTO'
  securitySchemes:
    bearer-key:
      type: http
      description: JWT token Bearer
      scheme: bearer
      bearerFormat: JWT