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.
openapi: 3.2.0
info:
title: Computefirst Net Newsletter API
version: 0.2.0
contact:
name: Idan Roth
email: idan.roth.ai@gmail.com
url: https://computefirst.net/docs
termsOfService: https://computefirst.net/terms
x-privacy-policy: https://computefirst.net/privacy
description: 'Operations tagged Newsletter across 2 of this provider''s published API definitions: computefirst-net-openapi.json, computefirst-net-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://computefirst.net
security:
- bearerAuth: []
tags:
- name: Newsletter
description: Optional new-tool emails, with explicit consent.
paths:
/v1/subscribe:
post:
tags:
- Newsletter
summary: Subscribe to new-tool emails
description: 'Only with the person''s explicit agreement: consent must be true ("Email me about new ComputeFirst tools. I can unsubscribe at any time."). The same answer whether the address is new, already listed or unsubscribed. The address stays unconfirmed and gets nothing until it is confirmed (one confirmation email before the first newsletter); an address that unsubscribed is never re-added. Also accepts the website form (application/x-www-form-urlencoded).'
operationId: subscribe
security:
- {}
- bearerAuth: []
requestBody:
required: true
content:
application/json:
schema:
type: object
additionalProperties: false
required:
- email
- consent
properties:
email:
type: string
format: email
maxLength: 254
consent:
const: true
responses:
'200':
description: Received, pending confirmation
'400':
description: Invalid email or consent not given
'429':
description: Daily subscription limit reached; see retry_after
servers:
- url: https://computefirst.net
/v1/unsubscribe:
get:
tags:
- Newsletter
summary: Unsubscribe
description: The link in every newsletter email. Works without signing in; other query parameters (utm_*, ...) are ignored.
operationId: unsubscribe
security: []
parameters:
- name: token
in: query
required: true
schema:
type: string
responses:
'200':
description: Unsubscribed
'404':
description: Link not active
post:
tags:
- Newsletter
summary: One-click unsubscribe
description: RFC 8058 one-click unsubscribe for mail clients.
operationId: unsubscribeOneClick
security: []
parameters:
- name: token
in: query
required: true
schema:
type: string
responses:
'200':
description: Unsubscribed
'404':
description: Link not active
servers:
- url: https://computefirst.net
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: Optional key from email sign-in or a passkey profile. Not needed for search, contracts or execution.
externalDocs:
description: Documentation and connection guides
url: https://computefirst.net/docs
x-refined-from:
- computefirst-net-openapi.json
- computefirst-net-openapi.yml