Emboss

Emboss Users API

The Users API from Emboss — 7 operation(s) for users.

Documentation GitHub OpenAPI

Operations 7

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /users Sign up for a new account · Signup #

Ask an LLM

“How do I create an account with email and password?”

“Is a bot-check token required to sign up?”

Tell an agent

Sign up {email} with password {password} and Turnstile token {turnstile_token}.

Register a new account for {email} using {password}, verified by {turnstile_token}.

POST /users/verify Verify a new account's email · Verify #

Ask an LLM

“How do I confirm my email after signing up?”

“Can I verify with the emailed code instead of clicking the link?”

Tell an agent

Verify my account with link token {token}.

Verify {email} using code {code}.

POST /users/login Log in to the website with a password · Login #

Ask an LLM

“How do I sign in to my web account with my password?”

“What happens when I log in with an email that isn't verified yet?”

Tell an agent

Log in as {email} with password {password}.

Sign {email} into the website using {password}.

POST /users/verify/resend Resend the email verification code · Verify Resend #

Ask an LLM

“I never got my verification email; can it be resent?”

“Does resending verification reveal whether an email is registered?”

Tell an agent

Resend the verification code to {email} with Turnstile token {turnstile_token}.

Send {email} a fresh verification link, bot check {turnstile_token}.

POST /users/login/token Sign in with a one-time login token · Login With Token #

Ask an LLM

“How does clicking the verification link sign me in without a password?”

“Can a one-time login token be redeemed for a session?”

Tell an agent

Sign in {email} with one-time login token {login_token}.

Redeem login token {login_token} for {email}.

POST /users/reset/request Request a password reset email · Reset Request #

Ask an LLM

“I forgot my password; how do I get a reset link?”

“Is a bot-check needed to request a password reset?”

Tell an agent

Send a password reset to {email} with Turnstile token {turnstile_token}.

Request a reset link for {email}, bot check {turnstile_token}.

POST /users/reset/confirm Set a new password with a reset token · Reset Confirm #

Ask an LLM

“How do I set a new password after getting the reset email?”

“Can a reset token be used to choose a new password?”

Tell an agent

Set my password to {new_password} using reset token {token}.

Confirm password reset {token} with new password {new_password}.

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/getemboss-ai:getemboss-ai-users-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: Fast Users API
  version: 0.1.0
security:
- bearer: []
- oauth2:
  - forms:read
  - forms:write
tags:
- name: Users
paths:
  /users:
    post:
      summary: Signup
      operationId: signup_users_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SignupRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Users
  /users/verify:
    post:
      summary: Verify
      operationId: verify_users_verify_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VerifyRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Users
  /users/login:
    post:
      summary: Login
      operationId: login_users_login_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LoginRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Users
  /users/verify/resend:
    post:
      summary: Verify Resend
      description: 'Reissue the verification code and link for an unverified account. The

        answer is {"ok": true} for every email; the token fields are present only

        when there is something to send, so the endpoint cannot be used to probe

        which addresses are registered (spec 4.3).'
      operationId: verify_resend_users_verify_resend_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResendRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Users
  /users/login/token:
    post:
      summary: Login With Token
      description: 'Redeem the one-time login token /users/verify handed out (spec 5.3):

        the site''s credentials provider calls this from the /verify page so the

        person who clicked the emailed link is signed in without a password.'
      operationId: login_with_token_users_login_token_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LoginTokenRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Users
  /users/reset/request:
    post:
      summary: Reset Request
      operationId: reset_request_users_reset_request_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResetRequestBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Users
  /users/reset/confirm:
    post:
      summary: Reset Confirm
      operationId: reset_confirm_users_reset_confirm_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResetConfirmBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Users
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ResendRequest:
      properties:
        email:
          type: string
          title: Email
        turnstile_token:
          type: string
          title: Turnstile Token
      type: object
      required:
      - email
      - turnstile_token
      title: ResendRequest
    ResetConfirmBody:
      properties:
        token:
          type: string
          title: Token
        new_password:
          type: string
          title: New Password
      type: object
      required:
      - token
      - new_password
      title: ResetConfirmBody
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    ResetRequestBody:
      properties:
        email:
          type: string
          title: Email
        turnstile_token:
          type: string
          title: Turnstile Token
      type: object
      required:
      - email
      - turnstile_token
      title: ResetRequestBody
    SignupRequest:
      properties:
        email:
          type: string
          title: Email
        password:
          type: string
          title: Password
        turnstile_token:
          type: string
          title: Turnstile Token
      type: object
      required:
      - email
      - password
      - turnstile_token
      title: SignupRequest
    LoginTokenRequest:
      properties:
        email:
          type: string
          title: Email
        login_token:
          type: string
          title: Login Token
      type: object
      required:
      - email
      - login_token
      title: LoginTokenRequest
    LoginRequest:
      properties:
        email:
          type: string
          title: Email
        password:
          type: string
          title: Password
      type: object
      required:
      - email
      - password
      title: LoginRequest
    VerifyRequest:
      properties:
        token:
          anyOf:
          - type: string
          - type: 'null'
          title: Token
        email:
          anyOf:
          - type: string
          - type: 'null'
          title: Email
        code:
          anyOf:
          - type: string
          - type: 'null'
          title: Code
      type: object
      title: VerifyRequest
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      bearerFormat: Emboss API key (sk_...)
      description: An Emboss API key. See https://getemboss.ai/docs/authentication.
    oauth2:
      type: oauth2
      description: Sign in with your Emboss account. See https://getemboss.ai/docs/authentication.
      flows:
        authorizationCode:
          authorizationUrl: https://api.getemboss.ai/oauth/authorize
          tokenUrl: https://api.getemboss.ai/oauth/token
          scopes:
            forms:read: Read your forms
            forms:write: Create and fill forms

Emboss Users API

Operations 7

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification