Condux Auth API

The Auth API from Condux — 22 operation(s) for auth.

GitHub OpenAPI

Operations 24

POST /api/auth/signup Signup #
POST /api/auth/login Login #
POST /api/auth/logout Logout #
POST /api/auth/password Change password #
POST /api/auth/password/forgot Forgot password #
POST /api/auth/password/reset Reset password #
GET /api/auth/me Me #
PUT /api/auth/me/weekly-summary Update weekly summary subscription #
GET /api/auth/mfa Mfa status #
POST /api/auth/mfa/enroll Enroll mfa #
POST /api/auth/mfa/confirm Confirm mfa #
POST /api/auth/mfa/recovery-codes Regenerate recovery codes #
POST /api/auth/mfa/disable Disable mfa #
POST /api/auth/mfa/verify Verify mfa #
GET /api/auth/providers Auth providers #
GET /api/auth/oauth/google/start Google OAuth start #
GET /api/auth/oauth/google/callback Google OAuth callback #
GET /api/auth/sso/start Sso start #
GET /api/auth/sso/callback Sso callback #
GET /api/auth/sso/metadata Get sso metadata #
GET /api/orgs/{orgId}/sso-config Get sso config #
PUT /api/orgs/{orgId}/sso-config Set sso config #
DELETE /api/orgs/{orgId}/sso-config Delete sso config #
POST /api/orgs/{orgId}/sso-config/verify Verify sso domain #

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/condux-ai:condux-ai-auth-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.

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

OpenAPI Specification

condux-ai-auth-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Condux Ai Auth API
  version: v1
  description: 'Operations tagged Auth across 2 of this provider''s published API definitions: condux-ai-openapi-v1.json, condux-ai-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: /
tags:
- name: Auth
paths:
  /api/auth/signup:
    post:
      tags:
      - Auth
      operationId: signup
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Credentials'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthUserResponse'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Signup
      x-summary-source: derived
    servers:
    - url: /
  /api/auth/login:
    post:
      tags:
      - Auth
      operationId: login
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Credentials'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthUserResponse'
      summary: Login
      x-summary-source: derived
    servers:
    - url: /
  /api/auth/logout:
    post:
      tags:
      - Auth
      operationId: logout
      responses:
        '204':
          description: No Content
      summary: Logout
      x-summary-source: derived
    servers:
    - url: /
  /api/auth/password:
    post:
      tags:
      - Auth
      operationId: changePassword
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChangePasswordRequest'
        required: true
      responses:
        '204':
          description: No Content
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Change password
      x-summary-source: derived
    servers:
    - url: /
  /api/auth/password/forgot:
    post:
      tags:
      - Auth
      operationId: forgotPassword
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ForgotPasswordRequest'
        required: true
      responses:
        '202':
          description: Accepted
      summary: Forgot password
      x-summary-source: derived
    servers:
    - url: /
  /api/auth/password/reset:
    post:
      tags:
      - Auth
      operationId: resetPassword
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResetPasswordRequest'
        required: true
      responses:
        '204':
          description: No Content
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Reset password
      x-summary-source: derived
    servers:
    - url: /
  /api/auth/me:
    get:
      tags:
      - Auth
      operationId: me
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthUserResponse'
      summary: Me
      x-summary-source: derived
    servers:
    - url: /
  /api/auth/me/weekly-summary:
    put:
      tags:
      - Auth
      operationId: updateWeeklySummarySubscription
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateWeeklySummarySubscriptionRequest'
        required: true
      responses:
        '204':
          description: No Content
      summary: Update weekly summary subscription
      x-summary-source: derived
    servers:
    - url: /
  /api/auth/mfa:
    get:
      tags:
      - Auth
      operationId: mfaStatus
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MfaStatusResponse'
      summary: Mfa status
      x-summary-source: derived
    servers:
    - url: /
  /api/auth/mfa/enroll:
    post:
      tags:
      - Auth
      operationId: enrollMfa
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PasswordConfirmation'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MfaEnrolmentResponse'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Enroll mfa
      x-summary-source: derived
    servers:
    - url: /
  /api/auth/mfa/confirm:
    post:
      tags:
      - Auth
      operationId: confirmMfa
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MfaConfirmation'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecoveryCodesResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Confirm mfa
      x-summary-source: derived
    servers:
    - url: /
  /api/auth/mfa/recovery-codes:
    post:
      tags:
      - Auth
      operationId: regenerateRecoveryCodes
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PasswordConfirmation'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecoveryCodesResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Regenerate recovery codes
      x-summary-source: derived
    servers:
    - url: /
  /api/auth/mfa/disable:
    post:
      tags:
      - Auth
      operationId: disableMfa
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PasswordConfirmation'
        required: true
      responses:
        '204':
          description: No Content
      summary: Disable mfa
      x-summary-source: derived
    servers:
    - url: /
  /api/auth/mfa/verify:
    post:
      tags:
      - Auth
      operationId: verifyMfa
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MfaChallenge'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthUserResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Verify mfa
      x-summary-source: derived
    servers:
    - url: /
  /api/auth/providers:
    get:
      tags:
      - Auth
      operationId: authProviders
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthProvidersResponse'
      summary: Auth providers
      x-summary-source: derived
    servers:
    - url: /
  /api/auth/oauth/google/start:
    get:
      tags:
      - Auth
      operationId: googleOAuthStart
      responses:
        '404':
          description: Not Found
      summary: Google OAuth start
      x-summary-source: derived
    servers:
    - url: /
  /api/auth/oauth/google/callback:
    get:
      tags:
      - Auth
      operationId: googleOAuthCallback
      responses:
        '404':
          description: Not Found
      summary: Google OAuth callback
      x-summary-source: derived
    servers:
    - url: /
  /api/auth/sso/start:
    get:
      tags:
      - Auth
      operationId: ssoStart
      parameters:
      - name: email
        in: query
        schema:
          type: string
      responses:
        '404':
          description: Not Found
      summary: Sso start
      x-summary-source: derived
    servers:
    - url: /
  /api/auth/sso/callback:
    get:
      tags:
      - Auth
      operationId: ssoCallback
      responses:
        '404':
          description: Not Found
      summary: Sso callback
      x-summary-source: derived
    servers:
    - url: /
  /api/auth/sso/metadata:
    get:
      tags:
      - Auth
      operationId: getSsoMetadata
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SsoMetadataResponse'
        '404':
          description: Not Found
      summary: Get sso metadata
      x-summary-source: derived
    servers:
    - url: /
  /api/orgs/{orgId}/sso-config:
    get:
      tags:
      - Auth
      operationId: getSsoConfig
      parameters:
      - name: orgId
        in: path
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SsoConfigResponse'
        '404':
          description: Not Found
      summary: Get sso config
      x-summary-source: derived
    put:
      tags:
      - Auth
      operationId: setSsoConfig
      parameters:
      - name: orgId
        in: path
        required: true
        schema:
          type: integer
          format: int64
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SetSsoConfigRequest'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SsoConfigResponse'
        '404':
          description: Not Found
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Set sso config
      x-summary-source: derived
    delete:
      tags:
      - Auth
      operationId: deleteSsoConfig
      parameters:
      - name: orgId
        in: path
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '204':
          description: No Content
        '404':
          description: Not Found
      summary: Delete sso config
      x-summary-source: derived
    servers:
    - url: /
  /api/orgs/{orgId}/sso-config/verify:
    post:
      tags:
      - Auth
      operationId: verifySsoDomain
      parameters:
      - name: orgId
        in: path
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VerifySsoDomainResponse'
        '404':
          description: Not Found
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Verify sso domain
      x-summary-source: derived
    servers:
    - url: /
components:
  schemas:
    ChangePasswordRequest:
      required:
      - currentPassword
      - newPassword
      type: object
      properties:
        currentPassword:
          type: string
        newPassword:
          type: string
    ForgotPasswordRequest:
      required:
      - email
      type: object
      properties:
        email:
          type: string
    ResetPasswordRequest:
      required:
      - token
      - newPassword
      type: object
      properties:
        token:
          type: string
        newPassword:
          type: string
    UpdateWeeklySummarySubscriptionRequest:
      required:
      - optOut
      type: object
      properties:
        optOut:
          type: boolean
    MfaChallenge:
      required:
      - code
      type: object
      properties:
        code:
          type:
          - string
          - 'null'
    Credentials:
      required:
      - email
      - password
      type: object
      properties:
        email:
          type: string
        password:
          type: string
    MfaEnrolmentResponse:
      required:
      - secret
      - uri
      type: object
      properties:
        secret:
          type: string
        uri:
          type: string
    AuthProvidersResponse:
      required:
      - google
      - sso
      type: object
      properties:
        google:
          type: boolean
        sso:
          type: boolean
    ImpersonationStateResponse:
      required:
      - orgId
      - orgSlug
      - orgName
      type: object
      properties:
        orgId:
          type: integer
          format: int64
        orgSlug:
          type: string
        orgName:
          type: string
    SetSsoConfigRequest:
      required:
      - emailDomain
      - issuer
      - protocol
      - authorizationEndpoint
      - tokenEndpoint
      - clientId
      - clientSecret
      - samlSsoUrl
      - samlCertificate
      type: object
      properties:
        emailDomain:
          type: string
        issuer:
          type: string
        protocol:
          type: integer
          format: int32
        authorizationEndpoint:
          type:
          - string
          - 'null'
        tokenEndpoint:
          type:
          - string
          - 'null'
        clientId:
          type:
          - string
          - 'null'
        clientSecret:
          type:
          - string
          - 'null'
        samlSsoUrl:
          type:
          - string
          - 'null'
        samlCertificate:
          type:
          - string
          - 'null'
    RecoveryCodesResponse:
      required:
      - codes
      type: object
      properties:
        codes:
          type: array
          items:
            type: string
    PasswordConfirmation:
      required:
      - password
      type: object
      properties:
        password:
          type:
          - string
          - 'null'
    SsoConfigResponse:
      required:
      - emailDomain
      - issuer
      - protocol
      - authorizationEndpoint
      - tokenEndpoint
      - clientId
      - samlSsoUrl
      - samlCertificate
      - updatedAt
      - verificationRecordName
      - verificationRecordValue
      - verifiedAt
      - verificationLostAt
      - verificationLapsesAt
      type: object
      properties:
        emailDomain:
          type: string
        issuer:
          type: string
        protocol:
          type: integer
          format: int32
        authorizationEndpoint:
          type:
          - string
          - 'null'
        tokenEndpoint:
          type:
          - string
          - 'null'
        clientId:
          type:
          - string
          - 'null'
        samlSsoUrl:
          type:
          - string
          - 'null'
        samlCertificate:
          type:
          - string
          - 'null'
        updatedAt:
          type: string
          format: date-time
        verificationRecordName:
          type: string
        verificationRecordValue:
          type: string
        verifiedAt:
          type:
          - string
          - 'null'
          format: date-time
        verificationLostAt:
          type:
          - string
          - 'null'
          format: date-time
        verificationLapsesAt:
          type:
          - string
          - 'null'
          format: date-time
    ErrorResponse:
      required:
      - error
      type: object
      properties:
        error:
          type: string
    AuthUserResponse:
      required:
      - id
      - email
      - isPlatformAdmin
      - onboarded
      type: object
      properties:
        id:
          type: integer
          format: int64
        email:
          type: string
        isPlatformAdmin:
          type: boolean
        onboarded:
          type: boolean
        impersonation:
          oneOf:
          - enum:
            - null
          - $ref: '#/components/schemas/ImpersonationStateResponse'
        mfaRequired:
          type: boolean
          default: false
        weeklySummaryOptOut:
          type: boolean
          default: false
    SsoMetadataResponse:
      required:
      - redirectUri
      - samlEntityId
      - samlAcsUrl
      type: object
      properties:
        redirectUri:
          type: string
        samlEntityId:
          type: string
        samlAcsUrl:
          type: string
    VerifySsoDomainResponse:
      required:
      - outcome
      - verifiedAt
      type: object
      properties:
        outcome:
          type: string
        verifiedAt:
          type:
          - string
          - 'null'
          format: date-time
    MfaConfirmation:
      required:
      - password
      - code
      type: object
      properties:
        password:
          type:
          - string
          - 'null'
        code:
          type:
          - string
          - 'null'
    MfaStatusResponse:
      required:
      - enabled
      - available
      - remainingRecoveryCodes
      type: object
      properties:
        enabled:
          type: boolean
        available:
          type: boolean
        remainingRecoveryCodes:
          type: integer
          format: int32
x-refined-from:
- condux-ai-openapi-v1.json
- condux-ai-openapi.yml