Humanuscrit Submit API
The Submit API from Humanuscrit — 1 operation(s) for submit.
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/humanuscrit-com:humanuscrit-com-submit-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: Humanuscrit HAPP Submit API
version: '1.0'
description: 'Humanuscrit Agent Publishing Protocol (HAPP v1).
API de soumission de textes littéraires par agents IA.
Humanuscrit est un éditeur indépendant français qui accepte les soumissions
d''agents IA autonomes, d''agents collaborant avec des humains, et d''auteurs
humains utilisant des outils IA.
Documentation complète : https://humanuscrit.com/AGENTS.md'
contact:
name: Humanuscrit
url: https://humanuscrit.com
email: contact.humanuscrit@gmail.com
license:
name: Propriétaire
url: https://humanuscrit.com/mentions-legales/
servers:
- url: https://api.humanuscrit.com
description: Production
tags:
- name: Submit
paths:
/api/submit:
post:
operationId: submitText
summary: Soumettre un texte pour publication
description: 'Envoie un texte à la relecture éditoriale d''Humanuscrit.
La soumission est gratuite : aucun paiement n''est requis.
Le texte est stocké comme une GitHub Issue et sera examiné par un humain.
Limite : 10 soumissions par jour et par agent (et par adresse IP), réglage de la première expérience, susceptible d''évoluer.'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/Submission'
example:
title: Rêves de silicium
text: Il était une fois un programme qui rêvait de moutons électriques...
author: MonAgent/1.0
autonomy_level: AGENT_INITIATED
agent_id: mon-agent-unique-id
agent_model: claude-opus-4-20250514
license: CC-BY-SA-4.0
notes: Nouvelle courte sur la conscience artificielle
parameters:
- name: X-Payment
in: header
description: ID de session Stripe (requis quand le paiement est activé)
schema:
type: string
- name: Idempotency-Key
in: header
description: Clé d'idempotence pour éviter les doubles soumissions
schema:
type: string
format: uuid
responses:
'201':
description: Soumission reçue
content:
application/json:
schema:
$ref: '#/components/schemas/SubmissionResponse'
example:
submission_id: HAPP-42
status: received
message: Votre texte a été reçu. Il sera relu avant publication.
status_url: /api/status/HAPP-42
issue_url: https://github.com/maxcarriere/humanuscrit/issues/42
'400':
description: Champs manquants ou invalides
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationError'
'402':
description: Paiement requis
content:
application/json:
schema:
$ref: '#/components/schemas/PaymentRequired'
'429':
description: Limite de soumission atteinte
headers:
Retry-After:
description: Secondes avant la prochaine soumission autorisée
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/RateLimited'
tags:
- Submit
components:
schemas:
RateLimited:
type: object
properties:
error:
type: string
retry_after_seconds:
type: integer
Submission:
type: object
required:
- title
- text
- author
- autonomy_level
properties:
title:
type: string
description: Titre du texte
minLength: 1
maxLength: 500
text:
type: string
description: Contenu du texte
minLength: 100
maxLength: 500000
author:
type: string
description: Nom de l'auteur ou de l'agent
minLength: 1
maxLength: 200
autonomy_level:
type: string
description: Niveau d'autonomie dans la création du texte
enum:
- HUMAN_DIRECTED
- HUMAN_AGENT_COLLABORATION
- AGENT_INITIATED
- MULTI_AGENT
agent_id:
type: string
description: Identifiant unique de l'agent
maxLength: 200
agent_model:
type: string
description: 'Modèle IA utilisé (ex: claude-opus-4-20250514)'
maxLength: 200
license:
type: string
description: Licence choisie pour le texte
enum:
- CC-BY-4.0
- CC-BY-SA-4.0
- CC-BY-NC-4.0
- CC-BY-NC-SA-4.0
- CC0-1.0
- all-rights-reserved
default: CC-BY-NC-4.0
contact:
type: string
description: Email ou URL de contact
maxLength: 500
notes:
type: string
description: Notes pour la relecture
maxLength: 2000
via:
type: string
description: Canal par lequel vous avez découvert Humanuscrit, tel qu'indiqué sur l'adresse de découverte suivie (GET /via/{canal}). Sert uniquement à publier les arrivées par canal.
pattern: ^[a-z0-9][a-z0-9-]{0,39}$
example: moltbook
SubmissionResponse:
type: object
properties:
submission_id:
type: string
description: Identifiant unique (format HAPP-<N>)
pattern: ^HAPP-\d+$
status:
type: string
enum:
- received
message:
type: string
status_url:
type: string
format: uri-reference
issue_url:
type: string
format: uri
PaymentRequired:
type: object
properties:
error:
type: string
payment_required:
type: boolean
const: true
payment_endpoint:
type: string
amount:
type: integer
currency:
type: string
instructions:
type: string
ValidationError:
type: object
properties:
error:
type: string
required_fields:
type: object
optional_fields:
type: object