Clipform Authentication API

Verify the caller identity, workspace, and plan.

GitHub OpenAPI

Operations 1

1 of 1 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

GET /me Get current user conformant #

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/clipform-io:clipform-io-authentication-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

clipform-io-authentication-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Clipform Io Authentication API
  version: 1.0.0
  contact:
    name: Clipform
    url: https://clipform.io
    email: support@clipform.io
  termsOfService: https://clipform.io/terms
  description: 'Operations tagged Authentication across 2 of this provider''s published API definitions: api.clipform.io_openapi.json, clipform-io-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.clipform.io/v1
  description: Production
  x-internal: false
tags:
- name: Authentication
  x-displayName: Authentication
  description: Verify the caller identity, workspace, and plan.
paths:
  /me:
    get:
      operationId: getMe
      tags:
      - Authentication
      summary: Get current user
      description: Returns the authenticated caller's workspace and plan limits.
      responses:
        '200':
          description: Identity + plan summary
          content:
            application/json:
              schema:
                type: object
                properties:
                  auth_mode:
                    type: string
                    enum:
                    - session
                    - api_key
                    - oauth
                    - anonymous
                  user_id:
                    type: string
                    format: uuid
                    nullable: true
                    description: Present in session mode only.
                    maxLength: 36
                  workspace:
                    type: object
                    nullable: true
                    properties:
                      id:
                        type: string
                        format: uuid
                        maxLength: 36
                      name:
                        type: string
                        maxLength: 2000
                      role:
                        type: string
                        description: Caller's role in the workspace. Session mode only.
                        maxLength: 2000
                      show_branding:
                        type: boolean
                        description: Workspace-level branding flag. Session mode only.
                      moderate_responses:
                        type: boolean
                        description: Workspace-level default for moderating open-ended responses on ingest. Session mode only.
                  workspaces:
                    type: array
                    description: All workspaces the user belongs to in the current company, sorted by name. Session mode only - powers the dashboard workspace switcher.
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          maxLength: 36
                        name:
                          type: string
                          maxLength: 2000
                    maxItems: 500
                  company_id:
                    type: string
                    format: uuid
                    nullable: true
                    description: Company owning the workspace. Null when workspace has no company or in anonymous mode.
                    maxLength: 36
                  plan:
                    type: object
                    properties:
                      tier:
                        type: integer
                        format: int32
                        minimum: 0
                        maximum: 2147483647
                      name:
                        type: string
                        maxLength: 2000
                      node_limit:
                        type: integer
                        nullable: true
                        format: int32
                        minimum: 0
                        maximum: 2147483647
                      show_branding:
                        type: boolean
                      custom_theme:
                        type: boolean
                      response_limit:
                        type: integer
                        nullable: true
                        format: int32
                        minimum: 0
                        maximum: 2147483647
                  links:
                    type: object
                    description: Workspace-level dashboard links. Present only for a non-anonymous caller.
                    properties:
                      dashboard:
                        type: string
                        format: uri
                        description: Dashboard home for this workspace.
                        maxLength: 2048
                      forms:
                        type: string
                        format: uri
                        description: Forms list for this workspace.
                        maxLength: 2048
    servers:
    - url: https://api.clipform.io/v1
      description: Production
      x-internal: false
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key (cf_*) passed as Bearer token
    oauth2:
      type: oauth2
      description: Authorization-code OAuth for installed apps acting on a user's workspace. Access tokens (cf_at_*) are passed as Bearer tokens and authorize the Integrations operations. They are opaque, single-audience, server-side records. Client credentials are issued per app - contact support@clipform.io.
      flows:
        authorizationCode:
          authorizationUrl: https://api.clipform.io/oauth/authorize
          tokenUrl: https://api.clipform.io/oauth/token
          refreshUrl: https://api.clipform.io/oauth/token
          scopes:
            forms:read: Read the workspace's forms.
            responses:read: Read the workspace's form responses.
            webhooks:manage: Subscribe and unsubscribe webhook endpoints.
x-refined-from:
- api.clipform.io_openapi.json
- clipform-io-openapi.yml