Agent API v1

Amenez du contexte externe dans votre espace MyInc en quelques minutes.

Envoyez notes, liens, markdown et fichiers dans votre espace de travail MyInc avec une seule clé API. Utilisez la même API pour transformer ce contexte en pages et drafts, qui attendent toujours votre approbation avant publication.

Voir la première requête Voir l’aperçu du produit

First request

curl https://myinc.app/api/agent/clips \
  -X POST \
  -H 'Authorization: Bearer tk_your_api_key' \
  -H 'Idempotency-Key: clip-001' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Insight hebdomadaire",
    "text": "Enregistrez la réponse finale de la recherche du jour."
  }'

Clips

POST /api/agent/clips

Ingest

POST /api/agent/ingest

Upload

POST /api/agent/upload

Projects

POST /api/agent/projects

Amenez du contexte externe dans votre espace de travail

Enregistrez une note, un lien ou une réponse

Envoyez un élément à la fois dans votre espace MyInc sous forme de clip que votre équipe IA peut réutiliser.

Ingest de liens, texte et markdown par lots

Regroupez les éléments liés dans une seule capture pour que votre espace les conserve ensemble.

Créez des pages et générez des drafts

Organisez d’abord le contexte dans une page, puis demandez à MyInc de générer un draft, qui reste en attente de votre approbation.

Créez des projects et ajoutez des éléments

Ouvrez un project depuis votre agent et déposez clips, pages et drafts dans les étapes du project à mesure que le travail avance.

Quickstart

Connectez-vous à MyInc et créez une clé API à scope dans Settings → API keys.

Envoyez la clé en auth Bearer à chaque requête et ajoutez un Idempotency-Key aux requêtes d’écriture.

Commencez par un clip ou un lot d’ingest, puis étendez vers pages, génération de drafts, uploads et projects.

Authentification

L’Agent API v1 de MyInc utilise des clés API personnelles. Créez des clés à scope pour des intégrations précises dans Settings → API keys et gardez-les côté serveur comme jetons Bearer.

curl https://myinc.app/api/agent/clips \
  -X POST \
  -H 'Authorization: Bearer tk_your_api_key' \
  -H 'Idempotency-Key: clip-001' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Insight hebdomadaire",
    "text": "Enregistrez la réponse finale de la recherche du jour."
  }'

Les clés API à scope sont prises en charge pour clips, ingest, uploads, pages, generation et projects.
Scopes recommandés : clips:write, ingest:write, upload:write, pages:read, pages:generate, projects:write.
Les clés se créent et se révoquent dans Settings → API keys.

Crédits et limites

Les requêtes Agent API suivent les mêmes limites de forfait que le produit. Les crédits s’appliquent aux actions basées sur l’IA, et non à un quota séparé réservé aux agents.

POST /api/agent/ingest consomme des crédits IA par élément : text 1, markdown 1, url 2.
POST /api/agent/pages/:id/generate consomme des crédits IA : custom 6, template set 15.
La création de projects suit la limite de projects actifs de votre forfait.

Écritures idempotentes

Les endpoints d’écriture prennent en charge Idempotency-Key. Renvoyer la même requête avec la même clé retourne le résultat stocké. Réutiliser la même clé avec un autre body retourne 409.

curl https://myinc.app/api/agent/projects \
  -X POST \
  -H 'Authorization: Bearer tk_your_api_key' \
  -H 'Idempotency-Key: project-2026-04-launch' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Plan de lancement d’avril",
    "template": "goal_milestones"
  }'

Endpoints principaux

POST/api/agent/clips

Créer un clip

Pour une seule note, un lien ou une réponse à conserver.

{
  "title": "Réponse enregistrée",
  "text": "Voici le résumé final qui mérite d’être conservé.",
  "tags": ["research", "launch"]
}

POST/api/agent/ingest

Ingest par lot

Envoyez texte, URLs et markdown ensemble et gardez-les groupés dans une seule capture.

{
  "items": [
    { "type": "url", "url": "https://example.com/article" },
    { "type": "markdown", "title": "Notes", "text": "# Points clés\n- Un\n- Deux" }
  ]
}

POST/api/agent/upload

Téléverser un fichier

Envoyez des uploads multipart via la même surface Agent API quand votre agent doit joindre des fichiers.

curl https://myinc.app/api/agent/upload \
  -H 'Authorization: Bearer tk_your_api_key' \
  -H 'Idempotency-Key: upload-001' \
  -F '[email protected]'

POST/api/agent/pages/:id/generate

Générer un draft depuis une page

Utilisez la génération de pages quand vos clips sont déjà organisés en une page.

{
  "mode": "custom",
  "prompt": "Transformez cette page en un brief court et publiable."
}

POST/api/agent/projects

Créer un project

Ouvrez un nouveau project MyInc depuis votre flux d’agent avec un nom, un template et un statut.

{
  "name": "Plan de lancement d’avril",
  "template": "goal_milestones",
  "icon": "🚀"
}

POST/api/agent/projects/:id/items

Ajouter un élément à une étape du project

Placez un clip, une page, un draft ou un élément publié dans une étape de project MyInc depuis votre flux d’agent.

{
  "stage": "clip",
  "referenceId": "clip_123"
}

Forme de réponse commune

L’Agent API v1 renvoie un envelope normalisé pour que votre intégration gère succès et erreur de façon cohérente.

{
  "success": true,
  "data": {
    "id": "clip_123",
    "title": "Réponse enregistrée"
  },
  "error": null
}

Conçue pour Hermes et vos propres agents

Connectez Hermes ou tout agent que vous construisez à votre espace MyInc. Commencez par clips et ingest, puis ajoutez pages, generation et projects à mesure que votre équipe IA prend en charge plus de travail.

MyInc

Comment le contexte externe atteint votre espace de travail

Capturez d’abord avec clips et ingest

Pointez votre agent vers clips et ingest pour pousser notes, liens et markdown dans votre espace MyInc au fil de l’eau.

Voir l’aperçu du produit

Puis construisez pages et projects

Une fois le contexte dans votre espace, générez pages et drafts et organisez le travail en projects, le tout en attente de votre approbation.

Voir l’aperçu du produit

Exemples de référence par endpoint

Ouvrez chaque endpoint pour voir un body de requête, un exemple de réponse et des notes d’intégration.

POST/api/agent/clipsCréer un clip

Request body

{
  "title": "Réponse enregistrée",
  "text": "Voici le résumé final qui mérite d’être conservé.",
  "tags": ["research", "launch"]
}

Response

{
  "success": true,
  "data": {
    "id": "clip_123",
    "title": "Réponse enregistrée",
    "text": "Voici le résumé final qui mérite d’être conservé."
  },
  "error": null
}

Notes

Bon premier endpoint pour Hermes ou votre propre agent.
Idéal pour une réponse finale à la fois.
GET /api/agent/clips liste les clips avec clips:read.

POST/api/agent/ingestIngest par lot

Request body

{
  "items": [
    { "type": "url", "url": "https://example.com/article" },
    { "type": "markdown", "title": "Notes", "text": "# Points clés\n- Un\n- Deux" }
  ]
}

Response

{
  "success": true,
  "data": {
    "captureBatchId": "batch_123",
    "created": [
      { "id": "clip_1", "title": "https://example.com/article", "url": "https://example.com/article" },
      { "id": "clip_2", "title": "Notes", "url": null }
    ],
    "failed": []
  },
  "error": null
}

Notes

Meilleur point de départ quand un agent envoie plusieurs éléments à la fois.
text, url et markdown sont pris en charge dans une seule requête (jusqu’à 50 éléments).
Cette route facture des crédits IA par élément et renvoie des échecs par élément en cas d’épuisement.

POST/api/agent/uploadTéléverser un fichier

Request body

curl https://myinc.app/api/agent/upload \
  -H 'Authorization: Bearer tk_your_api_key' \
  -H 'Idempotency-Key: upload-001' \
  -F '[email protected]'

Response

{
  "success": true,
  "data": {
    "id": "clip_upload_123",
    "title": "notes.md"
  },
  "error": null
}

Notes

À utiliser quand votre agent envoie de vrais fichiers plutôt que du JSON.
Les clés à scope et l’idempotence fonctionnent aussi pour les uploads.
C’est la façade agent publique au-dessus de l’upload de fichiers MyInc, pas la route web interne.

POST/api/agent/pages/:id/generateGénérer un draft depuis une page

Request body

{
  "mode": "custom",
  "prompt": "Transformez cette page en un brief court et publiable."
}

Response

{
  "success": true,
  "data": {
    "jobId": "draft_123",
    "type": "page_generation",
    "status": "completed",
    "result": {
      "draftId": "draft_123"
    }
  },
  "error": null
}

Notes

Le draft généré reste en attente de votre approbation dans MyInc ; rien n’est publié automatiquement.
À utiliser après avoir organisé les clips en une page (POST /api/agent/pages, GET /api/agent/pages/:id).
Interrogez GET /api/agent/jobs/:id pour l’état du draft ; la génération consomme les mêmes crédits IA que le flux in-app.

POST/api/agent/projectsCréer un project

Request body

{
  "name": "Plan de lancement d’avril",
  "template": "goal_milestones",
  "icon": "🚀"
}

Response

{
  "success": true,
  "data": {
    "id": "project_123",
    "name": "Plan de lancement d’avril",
    "template": "goal_milestones"
  },
  "error": null
}

Notes

À utiliser quand l’agent a besoin d’un espace durable, pas seulement d’un clip.
Templates : goal_milestones ou pipeline_board.
La création de projects suit les mêmes limites de projects actifs que l’app.

POST/api/agent/projects/:id/itemsAjouter un élément à une étape du project

Request body

{
  "stage": "clip",
  "referenceId": "clip_123"
}

Response

{
  "success": true,
  "data": {
    "id": "project_item_123",
    "stage": "clip",
    "referenceId": "clip_123"
  },
  "error": null
}

Notes

Si columnId est omis, MyInc résout la première colonne de flux pour cette étape.
À utiliser juste après avoir créé un clip ou une page quand l’agent construit un flux de project.

Portée actuelle de v1

Agent API privée pour les premières intégrations, pas encore une plateforme publique entièrement versionnée.
Les clés API à scope, les clés d’idempotence et la façade d’upload sont désormais incluses dans v1.
Les jobs de génération utilisent pour l’instant un wrapper léger autour de la génération de drafts MyInc.

Commencez par une requête utile, puis laissez votre équipe IA continuer.

La meilleure première intégration est simple : enregistrez une réponse utile, un lien ou une note markdown dans votre espace de travail. Une fois que ça marche, transformez-la en pages et drafts que votre équipe IA prépare pour votre approbation.

Voir la première requête Voir l’aperçu du produit