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/famulor-io:famulor-io-folders-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: Famulor Folders API
summary: REST API für AI-Assistenten, Anrufe, Konversationen, Leads und omnichannel Kundenkommunikation.
description: 'Die Famulor Produkt-API unter `https://app.famulor.de/api`. Damit steuerst du
AI-Assistenten, startest und liest Anrufe, verwaltest Leads und Kampagnen,
versendest SMS und WhatsApp-Nachrichten, pflegst Wissensdatenbanken und
automatisierst Prozesse.
## Authentifizierung
Alle Endpunkte erwarten einen API-Key als Bearer-Token:
```
Authorization: Bearer YOUR_API_KEY
```
Den Key erstellst du in deinem Account unter im
Bereich API-Keys. Der Key wird nur einmal angezeigt.
## Webhooks
Famulor sendet Ereignisse (Post-Call, Conversation Ended, Read Receipts) an
deine URL. Die Payloads stehen im Abschnitt `webhooks` dieser Spec.
Diese Datei wird aus der offiziellen Dokumentation generiert:'
version: 1.0.0
contact:
name: Famulor Support
email: sales@famulor.io
url: https://www.famulor.io/support
license:
name: Proprietary
url: https://www.famulor.io/terms
termsOfService: https://www.famulor.io/terms
servers:
- url: https://app.famulor.de/api
description: Production
security:
- BearerAuth: []
tags:
- name: Folders
description: Ordner zur Organisation von Assistenten.
paths:
/user/folder:
post:
tags:
- Folders
summary: Create Folder
operationId: createFolder
description: 'Create a folder to organize your assistants
Docs'
externalDocs:
description: Create Folder
url: https://docs.famulor.io/api-v1/folders/create
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
type: string
description: The folder name (max 255 characters). Must be unique within your account.
color:
type: string
description: 'A color for the folder badge. One of: `gray`, `slate`, `red`, `orange`, `amber`, `green`, `teal`, `blue`, `purple`, `pink`.'
enum:
- gray
- slate
- red
- orange
- amber
- green
- teal
- blue
- purple
- pink
required:
- name
responses:
'201':
description: Success Response
content:
application/json:
example:
message: Folder created successfully
data:
id: 12
name: Acme Corp
color: blue
assistants_count: 0
schema:
type: object
properties:
message:
type: string
description: Success message
data:
type: object
properties:
id:
type: integer
description: The unique identifier of the created folder
name:
type: string
description: The folder name
color:
type: string
description: The folder color (or `null`)
assistants_count:
type: integer
description: Number of assistants in this folder (always `0` for a new folder)
additionalProperties: true
additionalProperties: true
'401':
$ref: '#/components/responses/Unauthorized'
'422':
description: Validation Error
content:
application/json:
example:
message: The name has already been taken.
errors:
name:
- The name has already been taken.
/user/folder/{id}:
delete:
tags:
- Folders
summary: Delete Folder
operationId: deleteFolder
description: 'Delete a folder
Docs'
externalDocs:
description: Delete Folder
url: https://docs.famulor.io/api-v1/folders/delete
parameters:
- name: id
in: path
required: true
description: The folder ID. Must belong to your account.
schema:
type: integer
responses:
'200':
description: Success Response
content:
application/json:
example:
message: Folder deleted successfully
'401':
$ref: '#/components/responses/Unauthorized'
'404':
description: Not Found
content:
application/json:
example:
message: Folder not found
'422':
$ref: '#/components/responses/ValidationError'
put:
tags:
- Folders
summary: Update Folder
operationId: updateFolder
description: 'Rename a folder or change its color
Docs'
externalDocs:
description: Update Folder
url: https://docs.famulor.io/api-v1/folders/update
parameters:
- name: id
in: path
required: true
description: The folder ID. Must belong to your account.
schema:
type: integer
requestBody:
required: false
content:
application/json:
schema:
type: object
properties:
name:
type: string
description: New name (max 255 characters). Must be unique within your account.
color:
type: string
description: 'New color. One of: `gray`, `slate`, `red`, `orange`, `amber`, `green`, `teal`, `blue`, `purple`, `pink`. Send `null` to clear it.'
enum:
- gray
- slate
- red
- orange
- amber
- green
- teal
- blue
- purple
- pink
responses:
'200':
description: Success Response
content:
application/json:
example:
message: Folder updated successfully
data:
id: 12
name: Acme Inc.
color: pink
assistants_count: 4
schema:
type: object
properties:
message:
type: string
description: Success message
data:
type: object
properties:
id:
type: integer
description: The folder ID
name:
type: string
description: The folder name
color:
type: string
description: The folder color (or `null`)
assistants_count:
type: integer
description: Number of assistants in this folder
additionalProperties: true
additionalProperties: true
'401':
$ref: '#/components/responses/Unauthorized'
'404':
description: Not Found
content:
application/json:
example:
message: Folder not found
'422':
$ref: '#/components/responses/ValidationError'
/user/folders:
get:
tags:
- Folders
summary: List Folders
operationId: listFolders
description: 'List the folders in your account
Docs'
externalDocs:
description: List Folders
url: https://docs.famulor.io/api-v1/folders/list
parameters:
- name: per_page
in: query
required: false
description: 'Number of folders per page (1-100, default: 15)'
schema:
type: integer
- name: page
in: query
required: false
description: 'Page number (default: 1)'
schema:
type: integer
responses:
'200':
description: Success Response
content:
application/json:
example:
data:
- id: 12
name: Acme Corp
color: blue
assistants_count: 4
- id: 18
name: Globex
color: teal
assistants_count: 0
current_page: 1
per_page: 15
total: 2
schema:
type: object
properties:
data:
type: array
items:
type: object
properties:
id:
type: integer
description: The unique identifier of the folder
name:
type: string
description: The folder name
color:
type: string
description: The folder color (or `null`)
assistants_count:
type: integer
description: Number of assistants in this folder
additionalProperties: true
additionalProperties: true
'401':
$ref: '#/components/responses/Unauthorized'
'422':
$ref: '#/components/responses/ValidationError'
components:
responses:
ValidationError:
description: Die Anfrage ist inhaltlich ungültig.
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationError'
example:
message: The given data was invalid.
errors:
phone_number:
- The phone number field is required.
Unauthorized:
description: Fehlender oder ungültiger API-Key.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
message: Unauthenticated.
schemas:
ValidationError:
type: object
properties:
message:
type: string
errors:
type: object
description: Feldname → Liste der Fehlermeldungen.
additionalProperties:
type: array
items:
type: string
Error:
type: object
properties:
message:
type: string
description: Menschenlesbare Fehlermeldung.
error:
type: string
description: Fehlerkennung, sofern gesetzt.
securitySchemes:
BearerAuth:
type: http
scheme: bearer
description: 'API-Key als Bearer-Token: `Authorization: Bearer YOUR_API_KEY`. Key erstellen unter https://app.famulor.de.'
externalDocs:
description: Famulor API-Dokumentation
url: https://docs.famulor.io/api-v1/introduction