ClipOnIt Account API
The Account API from ClipOnIt — 16 operation(s) for account.
Operations 21
DELETE
/api/me/oauth/{client_id}
Revoke a connector: deletes all its tokens and pending codes for this account
#
The Account API from ClipOnIt — 16 operation(s) for account.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/cliponit-app:cliponit-app-account-api"
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.
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: 3.2.0
info:
title: Cliponit App Account API
version: 1.0.0
contact:
name: ClipOnIt
url: https://cliponit.app
license:
name: Proprietary
url: https://cliponit.app
description: 'Operations tagged Account 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: Account
paths:
/api/me/usage:
get:
tags:
- Account
summary: AI usage & cost of the account
description: 'One row per (kind, model) over the last `days` days: calls, tokens, audio seconds and estimated USD cost (Claude list prices, Whisper 0.006 $/min). `all=1` returns a per-user breakdown and is restricted to the ADMIN_EMAIL account.'
parameters:
- name: days
in: query
schema:
type: integer
default: 30
minimum: 1
maximum: 365
- name: all
in: query
schema:
type: string
enum:
- '1'
responses:
'200':
description: Usage
content:
application/json:
schema:
type: object
properties:
days:
type: integer
total_usd:
type: number
rows:
type: array
items:
type: object
properties:
key:
type: string
calls:
type: integer
input_tokens:
type: integer
output_tokens:
type: integer
seconds:
type: number
cost_usd:
type: number
'403':
description: '`all=1` from a non-admin account'
operationId: getApiMeUsage
x-operation-id-source: derived
servers:
- url: https://cliponit.app
description: Production
- url: http://localhost:3000
description: Local dev (cargo run)
/api/me:
patch:
tags:
- Account
operationId: updateMe
summary: Update profile (name, locale, e-mail notifications)
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
type: string
locale:
type: string
description: UI locale, e.g. `fr` or `en`
notify_ready:
type: boolean
description: E-mail me when a video finishes processing (clips ready, or processing failed). Default true.
responses:
'200':
description: Updated user
content:
application/json:
schema:
$ref: '#/components/schemas/User'
'401':
$ref: '#/components/responses/Unauthorized'
servers:
- url: https://cliponit.app
description: Production
- url: http://localhost:3000
description: Local dev (cargo run)
/api/onboarding:
post:
tags:
- Account
operationId: completeOnboarding
summary: Save onboarding answers
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- role
- videos_per_month
- source
properties:
role:
type: string
role_other:
type: string
videos_per_month:
type: string
source:
type: string
responses:
'200':
description: Done
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
onboarded:
type: integer
const: 1
servers:
- url: https://cliponit.app
description: Production
- url: http://localhost:3000
description: Local dev (cargo run)
/api/onboarding/skip:
post:
tags:
- Account
operationId: skipOnboarding
summary: Skip onboarding
responses:
'200':
$ref: '#/components/responses/Ok'
servers:
- url: https://cliponit.app
description: Production
- url: http://localhost:3000
description: Local dev (cargo run)
/api/feedback:
post:
tags:
- Account
operationId: sendFeedback
summary: Rate the clips detected for a video
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- video_id
- rating
properties:
video_id:
$ref: '#/components/schemas/Uuid'
rating:
type: integer
enum:
- 1
- 2
- 3
description: 1 = bad, 2 = ok, 3 = great
responses:
'200':
description: Stored
content:
application/json:
schema:
type: object
properties:
id:
$ref: '#/components/schemas/Uuid'
rating:
type: integer
servers:
- url: https://cliponit.app
description: Production
- url: http://localhost:3000
description: Local dev (cargo run)
/api/me/api-key:
get:
tags:
- Account
operationId: getApiKey
summary: Whether an API key exists (prefix only)
responses:
'200':
description: Key status
content:
application/json:
schema:
type: object
properties:
has_key:
type: boolean
prefix:
type:
- string
- 'null'
example: ck_ab12…
post:
tags:
- Account
operationId: createApiKey
summary: Create (or regenerate) the API key
description: 'Returns the full key **once** (`ck_` + 64 hex). Use it as `Authorization: Bearer ck_…` on every `/api/*` route and on `POST /mcp`. Requires a plan with `api_mcp` (Starter and above) → 403 otherwise. Regenerating revokes the previous key.'
responses:
'200':
description: New key
content:
application/json:
schema:
type: object
required:
- api_key
properties:
api_key:
type: string
pattern: ^ck_[0-9a-f]{64}$
'403':
$ref: '#/components/responses/Forbidden'
delete:
tags:
- Account
operationId: deleteApiKey
summary: Revoke the API key
responses:
'200':
$ref: '#/components/responses/Ok'
servers:
- url: https://cliponit.app
description: Production
- url: http://localhost:3000
description: Local dev (cargo run)
/api/me/subtitle-preset:
get:
tags:
- Account
operationId: getSubtitlePreset
summary: Account subtitle preset (built-in defaults if none)
responses:
'200':
description: Preset
content:
application/json:
schema:
$ref: '#/components/schemas/Subtitles'
put:
tags:
- Account
operationId: setSubtitlePreset
summary: Set the subtitle preset applied to every new clip edit
description: Fields are merged over the built-in defaults (`{}` resets), validated like `updateClipEdit`, then stored. Applied when a `clip_edits` row is created (first `getClip`/`updateClipEdit`/export of a clip+orientation); existing edits are not changed. Same plan gating as `updateClipEdit` for `lang`/`overrides`.
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SubtitlesPatch'
example:
style: karaoke
color: yellow
size: 3
words_per_line: 3
responses:
'200':
description: Stored preset
content:
application/json:
schema:
$ref: '#/components/schemas/Subtitles'
'400':
$ref: '#/components/responses/BadRequest'
'403':
$ref: '#/components/responses/Forbidden'
servers:
- url: https://cliponit.app
description: Production
- url: http://localhost:3000
description: Local dev (cargo run)
/api/me/logo:
get:
tags:
- Account
operationId: getLogo
summary: Custom logo URL (replaces the watermark on exports)
responses:
'200':
description: Logo
content:
application/json:
schema:
$ref: '#/components/schemas/Logo'
post:
tags:
- Account
operationId: uploadLogo
summary: Upload a logo (png/jpg ≤ 2 MB)
description: Converted to PNG ≤ 400 px wide. Rendered bottom-right of exports instead of the watermark (Starter plan and above).
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
required:
- file
properties:
file:
type: string
format: binary
responses:
'200':
description: Logo
content:
application/json:
schema:
$ref: '#/components/schemas/Logo'
'400':
$ref: '#/components/responses/BadRequest'
'403':
$ref: '#/components/responses/Forbidden'
delete:
tags:
- Account
operationId: deleteLogo
summary: Remove the logo
responses:
'200':
$ref: '#/components/responses/Ok'
servers:
- url: https://cliponit.app
description: Production
- url: http://localhost:3000
description: Local dev (cargo run)
/api/me/affiliate:
get:
tags:
- Account
operationId: getAffiliate
summary: Affiliate link and stats of the account (30% for life)
description: Creates the `ref_code` on first call. `link` = `PUBLIC_URL/?ref=CODE`; a visitor who signs up (email or Google) within 60 days of clicking it is attributed to this account. Every Stripe `invoice.paid` of a referred user adds a payout of 30% of `amount_paid`. If the affiliate is a Stripe customer the amount is credited to their balance automatically (`credited`, deducted from their next invoices); otherwise it stays `pending` and the founder pays monthly (PayPal/bank transfer) and marks it `paid` via `PATCH /api/admin/payouts/{id}`.
responses:
'200':
description: Affiliate info
content:
application/json:
schema:
type: object
properties:
ref_code:
type: string
example: K7QM2XJ4
link:
type: string
signups:
type: integer
paying:
type: integer
pending_cents:
type: integer
description: cents
paid_cents:
type: integer
description: cents
rate_percent:
type: integer
example: 30
payouts:
type: array
description: 20 most recent
items:
type: object
properties:
id:
type: integer
amount_cents:
type: integer
description: cents
commission_cents:
type: integer
description: cents
currency:
type: string
example: usd
status:
type: string
enum:
- pending
- credited
- paid
created_at:
type: string
paid_at:
type:
- string
- 'null'
stripe_balance_txn_id:
type:
- string
- 'null'
credited_cents:
type: integer
description: cents
servers:
- url: https://cliponit.app
description: Production
- url: http://localhost:3000
description: Local dev (cargo run)
/api/admin/payouts:
get:
tags:
- Account
operationId: listPayouts
summary: 'Admin: referral payouts by status (ADMIN_EMAIL only)'
parameters:
- name: status
in: query
schema:
type: string
enum:
- pending
- credited
- paid
default: pending
responses:
'200':
description: Payouts, ordered by affiliate email
content:
application/json:
schema:
type: array
items:
type: object
properties:
id:
type: integer
amount_cents:
type: integer
description: cents
commission_cents:
type: integer
description: cents
currency:
type: string
example: usd
status:
type: string
enum:
- pending
- credited
- paid
created_at:
type: string
paid_at:
type:
- string
- 'null'
affiliate_email:
type: string
referred_email:
type: string
'403':
description: Not the admin account
servers:
- url: https://cliponit.app
description: Production
- url: http://localhost:3000
description: Local dev (cargo run)
/api/admin/payouts/{id}:
patch:
tags:
- Account
operationId: updatePayout
summary: 'Admin: mark a referral payout paid (or back to pending)'
parameters:
- name: id
in: path
required: true
schema:
type: integer
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- status
properties:
status:
type: string
enum:
- paid
- pending
responses:
'200':
description: Updated
content:
application/json:
schema:
type: object
properties:
id:
type: integer
status:
type: string
'403':
description: Not the admin account
'404':
description: Unknown payout
servers:
- url: https://cliponit.app
description: Production
- url: http://localhost:3000
description: Local dev (cargo run)
/api/me/oauth:
get:
tags:
- Account
operationId: listOauthGrants
summary: Connectors (OAuth clients) authorized on this account
responses:
'200':
description: One row per client with live tokens
content:
application/json:
schema:
type: array
items:
type: object
properties:
client_id:
type: string
name:
type: string
example: Claude
since:
type: string
example: '2026-10-03 16:46:51'
until:
type: string
description: Latest refresh-token expiry
servers:
- url: https://cliponit.app
description: Production
- url: http://localhost:3000
description: Local dev (cargo run)
/api/me/oauth/{client_id}:
delete:
tags:
- Account
operationId: revokeOauthGrant
summary: 'Revoke a connector: deletes all its tokens and pending codes for this account'
parameters:
- name: client_id
in: path
required: true
schema:
type: string
responses:
'200':
description: Revoked
content:
application/json:
schema:
type: object
properties:
revoked:
type: integer
description: token rows deleted
servers:
- url: https://cliponit.app
description: Production
- url: http://localhost:3000
description: Local dev (cargo run)
/api/extension/token:
post:
tags:
- Account
operationId: createExtensionToken
summary: Create a Chrome extension token (`cke_…`)
description: 'Returns an opaque token **once** (`cke_` + 64 hex), stored SHA-256 only. **Requires the web `session` cookie**: a Bearer (session token, `ck_…` API key or OAuth `cko_…`) is rejected with 401, so a stolen token cannot mint more. The token replaces the session cookie inside the Chrome extension (`Authorization: Bearer cke_…`) and therefore works on **every plan, free included** — unlike the `ck_…` API key, which unlocks the public API and MCP and needs a paid plan. Sliding expiry: 180 days, pushed back on every authenticated call. Max 5 live tokens per account (the oldest is revoked beyond that); rate-limited to 10/h per account and 30/h per IP.'
security:
- SessionCookie: []
requestBody:
required: false
content:
application/json:
schema:
type: object
properties:
label:
type: string
maxLength: 60
description: Optional name shown in `GET /api/me/extensions`
example: Chrome · macOS
responses:
'200':
description: New token (shown once)
content:
application/json:
schema:
type: object
required:
- token
properties:
token:
type: string
pattern: ^cke_[0-9a-f]{64}$
expires_in_days:
type: integer
example: 180
'401':
$ref: '#/components/responses/Unauthorized'
'429':
description: Too many tokens created, retry later
servers:
- url: https://cliponit.app
description: Production
- url: http://localhost:3000
description: Local dev (cargo run)
/api/me/extensions:
get:
tags:
- Account
operationId: listExtensionTokens
summary: Chrome extensions connected to this account
description: Live tokens only. The token itself is never returned (only its SHA-256 is stored).
responses:
'200':
description: Connected extensions
content:
application/json:
schema:
type: array
items:
type: object
properties:
id:
type: string
format: uuid
label:
type:
- string
- 'null'
example: Chrome · macOS
created_at:
type: string
example: '2026-10-16 09:12:00'
last_used_at:
type:
- string
- 'null'
description: null until the extension has made one call
expires_at:
type: string
description: 'sliding: +180 days on every authenticated call'
servers:
- url: https://cliponit.app
description: Production
- url: http://localhost:3000
description: Local dev (cargo run)
/api/me/extensions/{id}:
delete:
tags:
- Account
operationId: revokeExtensionToken
summary: Revoke one extension token
description: 'Only tokens of the calling account; an unknown id returns `{revoked: 0}`.'
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
responses:
'200':
description: Revoked
content:
application/json:
schema:
type: object
properties:
revoked:
type: integer
description: rows deleted (0 or 1)
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)
Logo:
type: object
properties:
logo_url:
type:
- string
- 'null'
example: /files/logos/<user_id>.png
Hook:
type: object
description: Title card burned at the top of the frame during the first `duration_s` seconds.
properties:
enabled:
type: boolean
default: false
text:
type:
- string
- 'null'
maxLength: 120
description: null = the clip title
duration_s:
type: number
minimum: 0.5
maximum: 10
default: 2.5
style:
type: string
enum:
- card
- plain
default: card
Uuid:
type: string
format: uuid
example: 6f1c2d6e-3b1a-4c0f-9a0e-2f5d1c7b8e90
SubtitleOverride:
type: object
required:
- start
- end
- text
description: Replaces the transcript text for a range (absolute seconds). Requires `edit_captions`.
properties:
start:
type: number
end:
type: number
text:
type: string
Subtitles:
type: object
required:
- enabled
- color
- case
- lang
description: Burned-in subtitles. All fields except the required ones have defaults and are always returned by `getClip`.
properties:
enabled:
type: boolean
color:
type: string
enum:
- yellow
- white
- green
- cyan
- pink
- orange
- rainbow
description: Accent colour (current word in karaoke, text otherwise)
case:
type: string
enum:
- normal
- upper
- lower
lang:
type: string
default: original
description: '`original` or an ISO 639-1 code (`en`, `es`…) to translate — requires `translate` in the plan'
overrides:
type: array
items:
$ref: '#/components/schemas/SubtitleOverride'
default: []
style:
type: string
enum:
- karaoke
- boxed
- outline
- glow
- minimal
default: karaoke
font:
type: string
enum:
- Inter
- Montserrat
- Bangers
- Poppins
- Arial
default: Inter
position:
type: string
enum:
- bottom
- middle
- top
default: bottom
size:
type: integer
enum:
- 1
- 2
- 3
default: 2
description: 52/64/80 px in 9:16 (×7/8 in 16:9)
words_per_line:
type: integer
minimum: 3
maximum: 8
default: 5
animate:
type: boolean
default: false
description: Pop ×1.10 on the current word
hook:
$ref: '#/components/schemas/Hook'
example:
enabled: true
color: yellow
case: normal
lang: original
overrides: []
style: karaoke
font: Inter
position: bottom
size: 2
words_per_line: 5
animate: true
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
SubtitlesPatch:
type: object
description: 'Partial subtitles patch: every field optional, merged field by field over the current values (or over the built-in defaults for the account preset). Same enums as `Subtitles`.'
properties:
enabled:
type: boolean
color:
type: string
enum:
- yellow
- white
- green
- cyan
- pink
- orange
- rainbow
case:
type: string
enum:
- normal
- upper
- lower
lang:
type: string
overrides:
type: array
items:
$ref: '#/components/schemas/SubtitleOverride'
style:
type: string
enum:
- karaoke
- boxed
- outline
- glow
- minimal
font:
type: string
enum:
- Inter
- Montserrat
- Bangers
- Poppins
- Arial
position:
type: string
enum:
- bottom
- middle
- top
size:
type: integer
enum:
- 1
- 2
- 3
words_per_line:
type: integer
minimum: 3
maximum: 8
animate:
type: boolean
hook:
$ref: '#/components/schemas/Hook'
responses:
Ok:
description: Done
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
const: true
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
Forbidden:
description: Feature not included in the user's plan (upgrade at /billing)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: L'API & MCP nécessitent le plan Starter
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