Find your role first Alerts API
The Alerts API from Find your role first — 5 operation(s) for alerts.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/findyourrolefirst-click:findyourrolefirst-click-alerts-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
openapi: 3.2.0
info:
title: Find your role first Alerts API
version: 0.2.0
tags:
- name: Alerts
paths:
/api/alerts:
get:
summary: List Alerts
operationId: list_alerts_api_alerts_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
tags:
- Alerts
post:
summary: Create Alert
description: 'Email new matches of this search once a day. The email costs nothing;
opening a role you haven''t unlocked this month uses one credit, as in Search.'
operationId: create_alert_api_alerts_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AlertInput'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Alerts
/api/alerts/{alert_id}:
delete:
summary: Delete Alert
operationId: delete_alert_api_alerts__alert_id__delete
parameters:
- name: alert_id
in: path
required: true
schema:
type: integer
title: Alert Id
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Alerts
/api/alerts/{alert_id}/pause:
post:
summary: Pause Alert
operationId: pause_alert_api_alerts__alert_id__pause_post
parameters:
- name: alert_id
in: path
required: true
schema:
type: integer
title: Alert Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PauseInput'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Alerts
/api/alerts/{alert_id}/cadence:
post:
summary: Alert Cadence
description: 'Instant: an email within about 15 minutes of a match (at most 12 a day). Daily:
one email a day.'
operationId: alert_cadence_api_alerts__alert_id__cadence_post
parameters:
- name: alert_id
in: path
required: true
schema:
type: integer
title: Alert Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CadenceInput'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Alerts
/alerts/stop:
get:
summary: Stop Alert
description: The email's stop link, and the one-click List-Unsubscribe POST.
operationId: stop_alert_alerts_stop_get
parameters:
- name: token
in: query
required: false
schema:
type: string
maxLength: 64
default: ''
title: Token
responses:
'200':
description: Successful Response
content:
text/html:
schema:
type: string
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Alerts
post:
summary: Stop Alert
description: The email's stop link, and the one-click List-Unsubscribe POST.
operationId: postAlertsStop
parameters:
- name: token
in: query
required: false
schema:
type: string
maxLength: 64
default: ''
title: Token
responses:
'200':
description: Successful Response
content:
text/html:
schema:
type: string
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Alerts
x-operation-id-source: normalized
x-operation-id-original: stop_alert_alerts_stop_get
components:
schemas:
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
PauseInput:
properties:
paused:
type: boolean
title: Paused
additionalProperties: false
type: object
required:
- paused
title: PauseInput
AlertInput:
properties:
query:
type: string
maxLength: 160
title: Query
default: ''
location:
type: string
maxLength: 100
title: Location
default: ''
source:
anyOf:
- type: string
enum:
- gh
- ashby
- lever
- workday
- amazon
- microsoft
- netflix
- apple
- google
- meta
- eightfold
- jibe
- phenom
- atlassian
- successfactors
- radancy
- type: 'null'
title: Source
published_since:
anyOf:
- type: string
- type: 'null'
title: Published Since
discovered_since:
anyOf:
- type: string
- type: 'null'
title: Discovered Since
limit:
type: integer
maximum: 20.0
minimum: 1.0
title: Limit
default: 20
offset:
type: integer
maximum: 10000.0
minimum: 0.0
title: Offset
default: 0
exclude:
type: string
maxLength: 120
title: Exclude
default: ''
remote:
type: boolean
title: Remote
default: false
posted_within_hours:
anyOf:
- type: integer
maximum: 1440.0
minimum: 1.0
- type: 'null'
title: Posted Within Hours
experience:
anyOf:
- items:
type: string
enum:
- 0-1
- 1-3
- 3-5
- 5-8
- 8+
- not_stated
- unchecked
type: array
- type: 'null'
title: Experience
family:
anyOf:
- type: string
const: product_adjacent
- type: 'null'
title: Family
roles:
anyOf:
- items:
type: string
maxLength: 100
type: array
maxItems: 40
- type: 'null'
title: Roles
locations:
anyOf:
- items:
type: string
maxLength: 100
type: array
maxItems: 8
- type: 'null'
title: Locations
badges:
anyOf:
- items:
type: string
enum:
- yc
- a16z
- bigtech
- bank
- quant
- consulting
type: array
maxItems: 5
- type: 'null'
title: Badges
focus:
anyOf:
- items:
type: string
maxLength: 40
type: array
maxItems: 8
- type: 'null'
title: Focus
exact:
type: boolean
title: Exact
default: false
not_similar:
anyOf:
- items:
type: string
maxLength: 100
type: array
maxItems: 40
- type: 'null'
title: Not Similar
additionalProperties: false
type: object
title: AlertInput
description: A search to email new matches of, once a day. Paging fields are ignored.
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
CadenceInput:
properties:
cadence:
type: string
enum:
- instant
- daily
title: Cadence
additionalProperties: false
type: object
required:
- cadence
title: CadenceInput