ClipOnIt Auth API

Register, login, current user, password reset, Google OAuth.

GitHub OpenAPI

Operations 15

3 of 15 operations are conformant: apis.io called them with no credentials and the responses matched this contract. Checked 2026-11-12. how this works · status file

POST /api/auth/register Create an account #
POST /api/auth/login Log in with email and password #
POST /api/auth/logout Log out (delete the session) #
GET /api/auth/providers Which OAuth providers are configured conformant #
GET /api/auth/google Start Google OAuth (browser only) #
GET /api/auth/google/callback Google OAuth callback (browser only) #
POST /api/auth/forgot Send a password reset email #
POST /api/auth/reset Set a new password from a reset token #
GET /api/me Current user and quota #
GET /.well-known/oauth-protected-resource OAuth protected resource metadata (RFC 9728) for the MCP server conformant #
GET /.well-known/oauth-authorization-server OAuth authorization server metadata (RFC 8414) conformant #
POST /oauth/register Dynamic client registration (RFC 7591), public clients only #
GET /oauth/authorize Authorization endpoint (code + PKCE S256): consent page, or redirect to… #
POST /oauth/authorize Consent form submit → `redirect_uri?code=…&state=…` (code: 10 min, single use) #
POST /oauth/token Token endpoint: authorization_code + code_verifier, or refresh_token (rotation) #

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/cliponit-app:cliponit-app-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

cliponit-app-auth-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Cliponit App Auth API
  version: 1.0.0
  contact:
    name: ClipOnIt
    url: https://cliponit.app
  license:
    name: Proprietary
    url: https://cliponit.app
  description: 'Operations tagged auth across 2 of this provider''s published API definitions: cliponit-app-openapi.json, cliponit-app-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://cliponit.app
  description: Production
- url: http://localhost:3000
  description: Local dev (cargo run)
security:
- ApiKey: []
- SessionCookie: []
- OAuth2:
  - clips
tags:
- name: Auth
  description: Register, login, current user, password reset, Google OAuth.
paths:
  /api/auth/register:
    post:
      tags:
      - Auth
      operationId: register
      security: []
      summary: Create an account
      description: Creates a user (free plan), opens a 30-day session and seeds a demo video. Returns the session token (also set as the `session` cookie).
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - email
              - name
              - password
              properties:
                email:
                  type: string
                  format: email
                name:
                  type: string
                password:
                  type: string
                  minLength: 8
            example:
              email: a@b.c
              name: Ana
              password: secret12
      responses:
        '200':
          $ref: '#/components/responses/Session'
        '400':
          $ref: '#/components/responses/BadRequest'
    servers:
    - url: https://cliponit.app
      description: Production
    - url: http://localhost:3000
      description: Local dev (cargo run)
  /api/auth/login:
    post:
      tags:
      - Auth
      operationId: login
      security: []
      summary: Log in with email and password
      description: 'Returns `{user, token}`; use `token` as `Authorization: Bearer ` (session, 30 days). Accounts created with Google OAuth get 400 « Connecte-toi avec Google ».'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - email
              - password
              properties:
                email:
                  type: string
                  format: email
                password:
                  type: string
      responses:
        '200':
          $ref: '#/components/responses/Session'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
    servers:
    - url: https://cliponit.app
      description: Production
    - url: http://localhost:3000
      description: Local dev (cargo run)
  /api/auth/logout:
    post:
      tags:
      - Auth
      operationId: logout
      summary: Log out (delete the session)
      responses:
        '200':
          $ref: '#/components/responses/Ok'
    servers:
    - url: https://cliponit.app
      description: Production
    - url: http://localhost:3000
      description: Local dev (cargo run)
  /api/auth/providers:
    get:
      tags:
      - Auth
      operationId: getAuthProviders
      security: []
      summary: Which OAuth providers are configured
      responses:
        '200':
          description: Providers
          content:
            application/json:
              schema:
                type: object
                properties:
                  google:
                    type: boolean
    servers:
    - url: https://cliponit.app
      description: Production
    - url: http://localhost:3000
      description: Local dev (cargo run)
  /api/auth/google:
    get:
      tags:
      - Auth
      operationId: googleAuthStart
      security: []
      summary: Start Google OAuth (browser only)
      description: 302 to Google's consent screen. Not usable by agents; use an API key instead.
      responses:
        '302':
          description: Redirect to Google
        '400':
          $ref: '#/components/responses/BadRequest'
    servers:
    - url: https://cliponit.app
      description: Production
    - url: http://localhost:3000
      description: Local dev (cargo run)
  /api/auth/google/callback:
    get:
      tags:
      - Auth
      operationId: googleAuthCallback
      security: []
      summary: Google OAuth callback (browser only)
      parameters:
      - name: code
        in: query
        schema:
          type: string
      - name: state
        in: query
        schema:
          type: string
      responses:
        '302':
          description: Redirect to `/` or `/onboarding` with the session cookie, or `/login?error=google`
    servers:
    - url: https://cliponit.app
      description: Production
    - url: http://localhost:3000
      description: Local dev (cargo run)
  /api/auth/forgot:
    post:
      tags:
      - Auth
      operationId: forgotPassword
      security: []
      summary: Send a password reset email
      description: Always returns `{ok:true}` (does not reveal whether the email exists). Link valid 1 hour.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - email
              properties:
                email:
                  type: string
                  format: email
      responses:
        '200':
          $ref: '#/components/responses/Ok'
    servers:
    - url: https://cliponit.app
      description: Production
    - url: http://localhost:3000
      description: Local dev (cargo run)
  /api/auth/reset:
    post:
      tags:
      - Auth
      operationId: resetPassword
      security: []
      summary: Set a new password from a reset token
      description: Invalidates all sessions of the user.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - token
              - password
              properties:
                token:
                  type: string
                password:
                  type: string
                  minLength: 8
      responses:
        '200':
          $ref: '#/components/responses/Ok'
        '400':
          $ref: '#/components/responses/BadRequest'
    servers:
    - url: https://cliponit.app
      description: Production
    - url: http://localhost:3000
      description: Local dev (cargo run)
  /api/me:
    get:
      tags:
      - Auth
      operationId: getMe
      summary: Current user and quota
      description: Call this first to know the plan and remaining quota (`quota.videos_used` vs `quota.videos_limit`) and which features are unlocked (`api_mcp`, `translate`, `broll_music`, `premiere_xml`…).
      responses:
        '200':
          description: User + quota
          content:
            application/json:
              schema:
                type: object
                required:
                - user
                - quota
                properties:
                  user:
                    allOf:
                    - $ref: '#/components/schemas/User'
                    - type: object
                      properties:
                        delete_after:
                          type:
                          - string
                          - 'null'
                          description: Scheduled account deletion date, null if none
                        notify_ready:
                          type: boolean
                          description: E-mail when a video finishes processing (settable with PATCH /api/me)
                  quota:
                    $ref: '#/components/schemas/Quota'
        '401':
          $ref: '#/components/responses/Unauthorized'
    servers:
    - url: https://cliponit.app
      description: Production
    - url: http://localhost:3000
      description: Local dev (cargo run)
  /.well-known/oauth-protected-resource:
    get:
      tags:
      - Auth
      operationId: oauthProtectedResourceMetadata
      summary: OAuth protected resource metadata (RFC 9728) for the MCP server
      description: 'Also served at `/.well-known/oauth-protected-resource/mcp`. Referenced by the `WWW-Authenticate: Bearer resource_metadata="…"` header on every 401 from `POST /mcp`.'
      security: []
      responses:
        '200':
          description: Metadata
          content:
            application/json:
              schema:
                type: object
                properties:
                  resource:
                    type: string
                    example: https://cliponit.app/mcp
                  authorization_servers:
                    type: array
                    items:
                      type: string
                    example:
                    - https://cliponit.app
                  scopes_supported:
                    type: array
                    items:
                      type: string
                    example:
                    - clips
                  bearer_methods_supported:
                    type: array
                    items:
                      type: string
    servers:
    - url: https://cliponit.app
      description: Production
    - url: http://localhost:3000
      description: Local dev (cargo run)
  /.well-known/oauth-authorization-server:
    get:
      tags:
      - Auth
      operationId: oauthAuthorizationServerMetadata
      summary: OAuth authorization server metadata (RFC 8414)
      security: []
      responses:
        '200':
          description: Metadata
          content:
            application/json:
              schema:
                type: object
                properties:
                  issuer:
                    type: string
                  authorization_endpoint:
                    type: string
                  token_endpoint:
                    type: string
                  registration_endpoint:
                    type: string
                  scopes_supported:
                    type: array
                    items:
                      type: string
                  response_types_supported:
                    type: array
                    items:
                      type: string
                    example:
                    - code
                  grant_types_supported:
                    type: array
                    items:
                      type: string
                    example:
                    - authorization_code
                    - refresh_token
                  code_challenge_methods_supported:
                    type: array
                    items:
                      type: string
                    example:
                    - S256
                  token_endpoint_auth_methods_supported:
                    type: array
                    items:
                      type: string
                    example:
                    - none
    servers:
    - url: https://cliponit.app
      description: Production
    - url: http://localhost:3000
      description: Local dev (cargo run)
  /oauth/register:
    post:
      tags:
      - Auth
      operationId: oauthRegisterClient
      summary: Dynamic client registration (RFC 7591), public clients only
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - redirect_uris
              properties:
                client_name:
                  type: string
                  example: Claude
                redirect_uris:
                  type: array
                  items:
                    type: string
                    format: uri
                  description: https URLs, or http on localhost/127.0.0.1 (port ignored at authorization time).
                  example:
                  - https://claude.ai/api/mcp/auth_callback
                token_endpoint_auth_method:
                  type: string
                  enum:
                  - none
      responses:
        '201':
          description: Registered client
          content:
            application/json:
              schema:
                type: object
                properties:
                  client_id:
                    type: string
                    format: uuid
                  client_name:
                    type: string
                  redirect_uris:
                    type: array
                    items:
                      type: string
                  token_endpoint_auth_method:
                    type: string
                    example: none
                  grant_types:
                    type: array
                    items:
                      type: string
                  response_types:
                    type: array
                    items:
                      type: string
                  client_id_issued_at:
                    type: integer
        '400':
          description: '`invalid_redirect_uri` or `invalid_client_metadata`'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: invalid_grant
                  error_description:
                    type: string
    servers:
    - url: https://cliponit.app
      description: Production
    - url: http://localhost:3000
      description: Local dev (cargo run)
  /oauth/authorize:
    get:
      tags:
      - Auth
      operationId: oauthAuthorize
      summary: 'Authorization endpoint (code + PKCE S256): consent page, or redirect to…'
      description: Browser endpoint. Without a web session → `303 /login?next=/oauth/authorize?…`. With a session → HTML consent page (FR/EN) naming the client and the redirect host. Unknown `client_id` or unregistered `redirect_uri` → 400 page (no redirect). Other errors are returned to `redirect_uri` as `?error=…&state=…` (RFC 6749).
      security:
      - SessionCookie: []
      parameters:
      - name: response_type
        in: query
        required: true
        schema:
          type: string
          enum:
          - code
      - name: client_id
        in: query
        required: true
        schema:
          type: string
      - name: redirect_uri
        in: query
        required: true
        schema:
          type: string
          format: uri
      - name: code_challenge
        in: query
        required: true
        schema:
          type: string
          minLength: 43
      - name: code_challenge_method
        in: query
        required: true
        schema:
          type: string
          enum:
          - S256
      - name: state
        in: query
        schema:
          type: string
      - name: scope
        in: query
        schema:
          type: string
          example: clips
      - name: resource
        in: query
        schema:
          type: string
          example: https://cliponit.app/mcp
        description: RFC 8707; must be the MCP server URL if present.
      responses:
        '200':
          description: Consent page
          content:
            text/html: {}
        '303':
          description: Redirect to /login (no session)
        '400':
          description: Unknown client or unregistered redirect_uri
          content:
            text/html: {}
    post:
      tags:
      - Auth
      operationId: oauthConsent
      summary: 'Consent form submit → `redirect_uri?code=…&state=…` (code: 10 min, single use)'
      security:
      - SessionCookie: []
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - client_id
              - redirect_uri
              - code_challenge
              - code_challenge_method
              - decision
              properties:
                response_type:
                  type: string
                  enum:
                  - code
                client_id:
                  type: string
                redirect_uri:
                  type: string
                code_challenge:
                  type: string
                code_challenge_method:
                  type: string
                  enum:
                  - S256
                state:
                  type: string
                scope:
                  type: string
                resource:
                  type: string
                decision:
                  type: string
                  enum:
                  - allow
                  - deny
                  description: '`deny` → `redirect_uri?error=access_denied&state=…`'
      responses:
        '303':
          description: Redirect to redirect_uri with `code` (or `error`)
        '401':
          description: No session
    servers:
    - url: https://cliponit.app
      description: Production
    - url: http://localhost:3000
      description: Local dev (cargo run)
  /oauth/token:
    post:
      tags:
      - Auth
      operationId: oauthToken
      summary: 'Token endpoint: authorization_code + code_verifier, or refresh_token (rotation)'
      description: 'Form-encoded (RFC 6749). Returns `{access_token:"cko_…", token_type:"Bearer", expires_in:3600, refresh_token:"ckr_…", scope}` with `Cache-Control: no-store`. Codes are single use (consumed even on failure). Refresh tokens rotate: the previous one is invalidated in the same call. Errors: `invalid_request`, `invalid_grant`, `invalid_client` (401), `unsupported_grant_type`.'
      security: []
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - grant_type
              properties:
                grant_type:
                  type: string
                  enum:
                  - authorization_code
                  - refresh_token
                code:
                  type: string
                code_verifier:
                  type: string
                redirect_uri:
                  type: string
                client_id:
                  type: string
                refresh_token:
                  type: string
                resource:
                  type: string
      responses:
        '200':
          description: Tokens
          content:
            application/json:
              schema:
                type: object
                properties:
                  access_token:
                    type: string
                    example: cko_…
                  token_type:
                    type: string
                    example: Bearer
                  expires_in:
                    type: integer
                    example: 3600
                  refresh_token:
                    type: string
                    example: ckr_…
                  scope:
                    type: string
                    example: clips
        '400':
          description: '`invalid_grant` (bad/used/expired code, PKCE mismatch, bad refresh token), `invalid_request`, `unsupported_grant_type`'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: invalid_grant
                  error_description:
                    type: string
        '401':
          description: '`invalid_client` (client_id mismatch)'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: invalid_grant
                  error_description:
                    type: string
    servers:
    - url: https://cliponit.app
      description: Production
    - url: http://localhost:3000
      description: Local dev (cargo run)
components:
  schemas:
    Error:
      type: object
      required:
      - error
      properties:
        error:
          type: string
          description: Human-readable message (French or English)
    Quota:
      type: object
      description: Plan limits and current usage. Booleans tell which features the plan unlocks (403 otherwise).
      required:
      - plan
      - videos_used
      - videos_limit
      - max_bytes
      - retention_days
      - searches_today
      - watermark
      - logo
      - premiere_xml
      - edit_captions
      - translate
      - broll_music
      - api_mcp
      properties:
        plan:
          $ref: '#/components/schemas/PlanId'
        videos_used:
          type: integer
          description: Non-demo videos created this calendar month
        videos_limit:
          type: integer
          description: 'Monthly video quota (free: 2 total)'
        max_bytes:
          type: integer
          description: Max upload size per video, in bytes
        max_video_s:
          type:
          - number
          - 'null'
          description: 'Max duration per video in seconds (free: 1200), null = unlimited'
        retention_days:
          type:
          - integer
          - 'null'
          description: Videos older than this are deleted
        searches_today:
          type: integer
        searches_limit:
          type:
          - integer
          - 'null'
          description: 'Daily `findMoment` quota (free: 5), null = unlimited'
        watermark:
          type: boolean
          description: true = exports carry the ClipOnIt watermark
        logo:
          type: boolean
          description: Custom logo on exports
        premiere_xml:
          type: boolean
        edit_captions:
          type: boolean
          description: Subtitle text overrides
        translate:
          type: boolean
          description: Subtitles in another language
        broll_music:
          type: boolean
        api_mcp:
          type: boolean
          description: API key + MCP server access
    Uuid:
      type: string
      format: uuid
      example: 6f1c2d6e-3b1a-4c0f-9a0e-2f5d1c7b8e90
    PlanId:
      type: string
      enum:
      - free
      - starter
      - pro
      - business
    User:
      type: object
      required:
      - id
      - email
      - name
      - locale
      - plan
      - onboarded
      properties:
        id:
          $ref: '#/components/schemas/Uuid'
        email:
          type: string
          format: email
        name:
          type: string
        avatar_url:
          type:
          - string
          - 'null'
        locale:
          type: string
          example: fr
        plan:
          $ref: '#/components/schemas/PlanId'
        onboarded:
          type: integer
          enum:
          - 0
          - 1
  responses:
    BadRequest:
      description: 'Validation error — the message names the field, e.g. `champ subtitles.size invalide : attendu 1..3`'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Missing or invalid credentials
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: unauthorized
    Ok:
      description: Done
      content:
        application/json:
          schema:
            type: object
            properties:
              ok:
                type: boolean
                const: true
    Session:
      description: User + session token (also set as `session` cookie)
      content:
        application/json:
          schema:
            type: object
            required:
            - user
            - token
            properties:
              user:
                $ref: '#/components/schemas/User'
              token:
                type: string
                description: 'Session token (64 hex), usable as `Authorization: Bearer <token>` for 30 days'
  securitySchemes:
    ApiKey:
      type: http
      scheme: bearer
      bearerFormat: ck_<64 hex>
      description: 'Personal API key from `POST /api/me/api-key` (Starter plan and above). Also accepted: the session `token` returned by `login`/`register`. Send `Authorization: Bearer ck_…`.'
    SessionCookie:
      type: apiKey
      in: cookie
      name: session
      description: HttpOnly cookie set by `register`/`login` (browser clients).
    OAuth2:
      type: oauth2
      description: 'OAuth 2.1 for MCP connectors (Claude.ai / Claude Desktop / Claude Code / ChatGPT): discovery at `/.well-known/oauth-protected-resource` and `/.well-known/oauth-authorization-server`, dynamic client registration (RFC 7591) at `/oauth/register`, PKCE S256 required, public clients only. Access tokens (`cko_…`, 1 h) are accepted everywhere a `ck_…` key is; refresh tokens (`ckr_…`, 90 days) rotate on use.'
      flows:
        authorizationCode:
          authorizationUrl: https://cliponit.app/oauth/authorize
          tokenUrl: https://cliponit.app/oauth/token
          refreshUrl: https://cliponit.app/oauth/token
          scopes:
            clips: Import videos, read/edit clips, run exports (everything the API key allows)
externalDocs:
  description: Agent guide (llms-api.txt)
  url: https://cliponit.app/llms-api.txt
x-refined-from:
- cliponit-app-openapi.json
- cliponit-app-openapi.yml