> ## Documentation Index
> Fetch the complete documentation index at: https://prismeai-docs-next.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get v2orgs authsso

> Get a specific SSO auth provider by slug



## OpenAPI

````yaml /api-reference/swagger.yml get /v2/orgs/{orgSlug}/auth/sso/{slug}
openapi: 3.0.0
info:
  version: 1.0.0
  title: Prisme.ai APIs
  description: Prisme.ai APIs specifications
  termsOfService: https://www.prisme.ai/mentions-legales
  contact:
    name: Prisme.ai Support Team
    email: support@prisme.ai
    url: https://www.prisme.ai
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://api.eda.prisme.ai
  - url: http://localhost:3001
security:
  - BearerAuth: []
  - WorkspaceApiKeyAuth: []
  - BearerAuth: []
    WorkspaceApiKeyAuth: []
paths:
  /v2/orgs/{orgSlug}/auth/sso/{slug}:
    get:
      tags:
        - API Gateway
      description: Get a specific SSO auth provider by slug
      operationId: getAuthProvider
      parameters:
        - name: orgSlug
          in: path
          description: Organization slug
          required: true
          schema:
            type: string
        - name: slug
          in: path
          description: Provider slug
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthProvider'
        '401':
          description: AuthenticationError
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthenticationError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ObjectNotFoundError'
components:
  schemas:
    AuthProvider:
      type: object
      required:
        - slug
        - type
        - config
      properties:
        id:
          type: string
        slug:
          type: string
          description: Unique provider identifier (e.g. "google", "okta-saml")
        name:
          type: string
          description: Display name for the provider (e.g. "Google", "Corporate SSO")
        icon:
          type: string
          description: Icon URL or identifier for the provider
        type:
          $ref: '#/components/schemas/AuthProviderType'
          description: Authentication protocol type
        config:
          type: object
          additionalProperties: true
          description: Provider-specific configuration (OIDC or SAML settings)
          anyOf:
            - $ref: '#/components/schemas/AuthProviderOidcConfig'
            - $ref: '#/components/schemas/AuthProviderSamlConfig'
        attributesMapping:
          type: object
          additionalProperties:
            type: string
          properties:
            firstName:
              type: string
            lastName:
              type: string
            email:
              type: string
          description: Maps provider claims to user fields (e.g. firstName, email)
        source:
          type: string
          enum:
            - file
            - database
          description: Where this provider is configured (read-only, returned by GET)
        enabled:
          type: boolean
          description: >-
            Whether this provider is active (default true). Disabled providers
            are not registered as passport strategies.
        meta:
          type: object
          additionalProperties: true
          description: Free-form metadata JSON
        domains:
          type: array
          items:
            type: string
          description: Associated domain names
        orgSlug:
          type: string
          description: Associated organization slug
    AuthenticationError:
      type: object
      properties:
        error:
          type: string
          example: AuthenticationError
        message:
          type: string
          example: Unauthenticated
    ObjectNotFoundError:
      type: object
      properties:
        error:
          type: string
          example: ObjectNotFound
        message:
          type: string
    AuthProviderType:
      type: string
      enum:
        - oidc
        - saml
    AuthProviderOidcConfig:
      type: object
      required:
        - client_id
        - authorization_endpoint
        - token_endpoint
        - jwks_uri
      properties:
        client_id:
          type: string
        client_secret:
          type: string
        authorization_endpoint:
          type: string
        token_endpoint:
          type: string
        scopes:
          type: array
          items:
            type: string
        state:
          type: boolean
        jwks_uri:
          type: string
        pkce:
          type: boolean
    AuthProviderSamlConfig:
      type: object
      properties:
        idp_metadata_filepath:
          type: string
          description: Absolute path to the SAML XML config file in the container
        idp_metadata_xml:
          type: string
          description: Raw SAML XML config
        issuer:
          type: string
          description: Required
        audience:
          type: string
          description: Required, should match issuer
        skipRequestCompression:
          type: boolean
        wantAuthnResponseSigned:
          type: boolean
        identifierFormat:
          type: string
          description: >-
            Required if neither idp_metadata_xml or idp_metadata_filepath are
            configured
        identityProviderUrl:
          type: string
          description: >-
            Required if neither idp_metadata_xml or idp_metadata_filepath are
            configured
        entryPoint:
          type: string
          description: >-
            Required if neither idp_metadata_xml or idp_metadata_filepath are
            configured
        logoutUrl:
          type: string
        idpCert:
          type: string
          description: >-
            Required if neither idp_metadata_xml or idp_metadata_filepath are
            configured
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
    WorkspaceApiKeyAuth:
      type: apiKey
      in: header
      name: x-prismeai-api-key

````