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: Feedico Auth API
version: 1.0.0
description: 'REST API for Feedico (`api.feedico.io`).
**Auth flow**
- `POST /api/v1/auth/login` - account email, password, and your **API token** (`fdco_...` from the Account panel). Returns a **session JWT** (`sessionToken`).
- `GET /api/v1/me` - send the **raw API token** in `Authorization: Bearer fdco_...` (not the session JWT).
- `GET/PATCH /api/v1/me/profile` - **session only** (JWT from login or `feedico_session` cookie after dashboard sign-in). **Not** `fdco_`. Read/update name, company, website; **email is read-only**.
- `POST /api/v1/auth/forgot-password` - public; sends reset email (configure `RESEND_API_KEY` in production).
- `POST /api/v1/auth/reset-password` - public; `token` from email link + `newPassword`.
- `PATCH /api/v1/me/password` - **session only**; change password with `currentPassword` + `newPassword`.
**Edge**
- `GET /health` is answered by the proxy in front of Next.js (port 3100), not by a Next route.'
servers:
- url: https://api.feedico.io
description: Production
- url: http://127.0.0.1:3100
description: Local API proxy → Next
- url: http://localhost:3001
description: Next.js direct
tags:
- name: Auth
paths:
/api/v1/auth/login:
post:
tags:
- Auth
summary: Login (JSON)
description: 'Returns a **session JWT** for Bearer use on routes that expect it (if added later).
This endpoint requires `Content-Type: application/json`.'
operationId: authLogin
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/LoginRequest'
examples:
default:
value:
email: user@example.com
password: your-account-password
token: fdco_...
responses:
'200':
description: Logged in
content:
application/json:
schema:
$ref: '#/components/schemas/LoginSuccess'
'400':
description: Bad request (invalid email, missing password, missing token, invalid JSON)
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorBody'
'401':
description: Invalid credentials or API token
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorBody'
'403':
description: API token not configured for this account
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorBody'
'415':
description: Unsupported media type (not JSON)
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorBody'
'503':
description: Auth or database not configured
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorBody'
components:
schemas:
ErrorBody:
type: object
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true
LoginRequest:
type: object
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true
LoginSuccess:
type: object
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true