CortexPlus Auth API

The Auth API from CortexPlus — 10 operation(s) for auth.

GitHub OpenAPI

Operations 12

POST /v1/auth/register Register an account #
POST /v1/auth/login Log in and start a device session #
POST /v1/auth/verify Confirm the signup email and start a device session #
POST /v1/auth/verify/resend Send a new signup verification code #
POST /v1/auth/key Request an email sign-in code #
POST /v1/auth/key/redeem Redeem an email sign-in code #
GET /v1/auth/me Get the current account #
PATCH /v1/auth/me Update the current account profile #
DELETE /v1/auth/me Delete the current account #
POST /v1/auth/password Set or change the account password #
GET /v1/auth/devices List devices #
DELETE /v1/auth/devices/{id} Revoke a device #

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/cortexplus-io:cortexplus-io-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

cortexplus-io-auth-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Cortexplus Io Auth API
  version: 1.0.0
  description: 'Operations tagged Auth across 2 of this provider''s published API definitions: cortexplus-io-openapi.json, cortexplus-io-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.cortexplus.io
security:
- bearerAuth: []
tags:
- name: Auth
paths:
  /v1/auth/register:
    post:
      operationId: authRegister
      summary: Register an account
      description: Create a CortexPlus account. A 6-digit code is emailed and the account stays pending (202) until it is confirmed with /v1/auth/verify. When verification is disabled the response is a device session (201).
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
              - email
              - password
              properties:
                email:
                  type: string
                  format: email
                name:
                  type: string
                password:
                  type: string
                  minLength: 8
                deviceName:
                  type: string
                platform:
                  type: string
      responses:
        '201':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                required:
                - deviceToken
                - user
                properties:
                  deviceToken:
                    type: string
                    description: Device credential (cxd_…); use it as the bearer token.
                  user:
                    type: object
                    additionalProperties: true
        '202':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                required:
                - verificationRequired
                - email
                properties:
                  verificationRequired:
                    type: boolean
                    enum:
                    - true
                  email:
                    type: string
        default:
          description: Request failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  field:
                    type: string
                required:
                - error
      tags:
      - Auth
    servers:
    - url: https://api.cortexplus.io
  /v1/auth/login:
    post:
      operationId: authLogin
      summary: Log in and start a device session
      description: Log in with email and password and issue a device token for this app install.
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
              - email
              - password
              properties:
                email:
                  type: string
                  format: email
                password:
                  type: string
                deviceName:
                  type: string
                platform:
                  type: string
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                required:
                - deviceToken
                - user
                properties:
                  deviceToken:
                    type: string
                    description: Device credential (cxd_…); use it as the bearer token.
                  user:
                    type: object
                    additionalProperties: true
        '403':
          description: Request failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  field:
                    type: string
                required:
                - error
        default:
          description: Request failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  field:
                    type: string
                required:
                - error
      tags:
      - Auth
    servers:
    - url: https://api.cortexplus.io
  /v1/auth/verify:
    post:
      operationId: authVerifyEmail
      summary: Confirm the signup email and start a device session
      description: Confirm the email with the 6-digit code sent at signup and issue a device token for this app install.
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
              - email
              - code
              properties:
                email:
                  type: string
                  format: email
                code:
                  type: string
                  description: 6-digit code received by email.
                deviceName:
                  type: string
                platform:
                  type: string
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                required:
                - deviceToken
                - user
                properties:
                  deviceToken:
                    type: string
                    description: Device credential (cxd_…); use it as the bearer token.
                  user:
                    type: object
                    additionalProperties: true
        default:
          description: Request failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  field:
                    type: string
                required:
                - error
      tags:
      - Auth
    servers:
    - url: https://api.cortexplus.io
  /v1/auth/verify/resend:
    post:
      operationId: authResendVerification
      summary: Send a new signup verification code
      description: Email a new verification code to a pending account. Requires the signup password.
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
              - email
              - password
              properties:
                email:
                  type: string
                  format: email
                password:
                  type: string
                  description: Password chosen at signup.
      responses:
        '202':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                required:
                - sent
                properties:
                  sent:
                    type: boolean
        default:
          description: Request failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  field:
                    type: string
                required:
                - error
      tags:
      - Auth
    servers:
    - url: https://api.cortexplus.io
  /v1/auth/key:
    post:
      operationId: authRequestKey
      summary: Request an email sign-in code
      description: Send a 6-digit sign-in code to the account email address.
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
              - email
              properties:
                email:
                  type: string
                  format: email
      responses:
        '202':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                required:
                - sent
                - expiresInMinutes
                properties:
                  sent:
                    type: boolean
                  expiresInMinutes:
                    type: integer
        default:
          description: Request failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  field:
                    type: string
                required:
                - error
      tags:
      - Auth
    servers:
    - url: https://api.cortexplus.io
  /v1/auth/key/redeem:
    post:
      operationId: authRedeemKey
      summary: Redeem an email sign-in code
      description: Redeem the 6-digit code received by email (with the same email) and issue a device token for this app install.
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
              - email
              - key
              properties:
                email:
                  type: string
                  format: email
                  description: Email the code was sent to.
                key:
                  type: string
                  description: 6-digit code received by email.
                deviceName:
                  type: string
                platform:
                  type: string
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                required:
                - deviceToken
                - user
                properties:
                  deviceToken:
                    type: string
                    description: Device credential (cxd_…); use it as the bearer token.
                  user:
                    type: object
                    additionalProperties: true
        default:
          description: Request failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  field:
                    type: string
                required:
                - error
      tags:
      - Auth
    servers:
    - url: https://api.cortexplus.io
  /v1/auth/me:
    get:
      operationId: authMe
      summary: Get the current account
      description: Return the account behind the presented credential.
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
        default:
          description: Request failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  field:
                    type: string
                required:
                - error
      tags:
      - Auth
    patch:
      operationId: authUpdateProfile
      summary: Update the current account profile
      description: Update the account display name and/or language, timezone, geolocation and health agent access settings.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              properties:
                name:
                  type: string
                  minLength: 1
                  maxLength: 100
                settings:
                  type: object
                  additionalProperties: false
                  properties:
                    language:
                      type: string
                      enum:
                      - pt-BR
                      - en
                      - es
                    timezone:
                      type: string
                      minLength: 1
                    geolocation:
                      type: boolean
                      default: true
                      description: Record location sent with memory captures.
                    healthAgentAccess:
                      type: boolean
                      default: false
                      description: Share health (`saude`) memories with AI assistants using API keys (MCP and integrations).
                    birthDate:
                      type:
                      - string
                      - 'null'
                      format: date
                      description: Birth date used for nutrition intake ranges; `null` clears it.
                    sex:
                      type:
                      - string
                      - 'null'
                      enum:
                      - male
                      - female
                      - null
                      description: Biological sex used for nutrition intake ranges; `null` clears it.
                    activityLevel:
                      type:
                      - string
                      - 'null'
                      enum:
                      - sedentary
                      - light
                      - moderate
                      - active
                      - null
                      description: Physical activity level used for the estimated energy requirement.
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
        default:
          description: Request failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  field:
                    type: string
                required:
                - error
      tags:
      - Auth
    delete:
      operationId: authDeleteAccount
      summary: Delete the current account
      description: Permanently delete the account and all associated data.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
              - email
              properties:
                email:
                  type: string
      responses:
        '204':
          description: Account deleted.
        default:
          description: Request failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  field:
                    type: string
                required:
                - error
      tags:
      - Auth
    servers:
    - url: https://api.cortexplus.io
  /v1/auth/password:
    post:
      operationId: authSetPassword
      summary: Set or change the account password
      description: Set a password on a passwordless account, or change it when currentPassword is provided. Other device tokens are revoked.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
              - newPassword
              properties:
                newPassword:
                  type: string
                  minLength: 8
                currentPassword:
                  type: string
                  description: Required when the account already has a password.
      responses:
        '204':
          description: Password updated.
        default:
          description: Request failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  field:
                    type: string
                required:
                - error
      tags:
      - Auth
    servers:
    - url: https://api.cortexplus.io
  /v1/auth/devices:
    get:
      operationId: authListDevices
      summary: List devices
      description: List the account’s active device tokens.
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                required:
                - items
                - currentDeviceId
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
                  currentDeviceId:
                    type:
                    - string
                    - 'null'
                    description: Id of the calling device when authenticated with a device token.
        default:
          description: Request failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  field:
                    type: string
                required:
                - error
      tags:
      - Auth
    servers:
    - url: https://api.cortexplus.io
  /v1/auth/devices/{id}:
    delete:
      operationId: authRevokeDevice
      summary: Revoke a device
      description: Revoke a device token. Use the id current to revoke the device making this call (sign out).
      parameters:
      - name: id
        in: path
        required: true
        description: Device id, or the literal current.
        schema:
          type: string
      responses:
        '204':
          description: Device revoked.
        default:
          description: Request failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  field:
                    type: string
                required:
                - error
      tags:
      - Auth
    servers:
    - url: https://api.cortexplus.io
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
x-refined-from:
- cortexplus-io-openapi.json
- cortexplus-io-openapi.yml