Aller au contenu

Référence des opérations

153 opérations. Chacune est disponible à l'identique dans l'interface d'administration, par la CLI (harness op <nom>), par l'API (POST /api/v1/ops/<nom>) et par MCP. La permission est celle que le rôle de l'appelant doit contenir ; les drapeaux : lecture (ne modifie rien), humain (session web ré-authentifiée requise), sensible (action dangereuse : ré-authentification ou confirmation).

core.agent

core.agent.access.list

Lister les accès utilisateurs → agents et leurs plafonds

  • Permission : core.agent.access.list — drapeaux : lecture
Argument Type Requis Défaut Description
agent string non None
user string non None

core.agent.access.remove

Retirer l'accès d'un utilisateur à un agent

  • Permission : core.agent.access.remove
Argument Type Requis Défaut Description
user string oui
agent string oui

core.agent.access.set

Donner à un utilisateur accès à un agent avec un plafond (all | read_only | role:)

  • Permission : core.agent.access.set — drapeaux : sensible
Argument Type Requis Défaut Description
user string oui
agent string oui
cap string non 'all'

core.agent.create

Créer un agent (rôle agent-default)

  • Permission : core.agent.create — drapeaux : sensible
Argument Type Requis Défaut Description
name string oui
display_name string non ''
description string non ''
persona_md string non ''
instructions_md string non ''
model string non None
allowed_models liste de string non []
settings object non {}

core.agent.delete

Supprimer un agent (et ses liaisons, entrées et accès)

  • Permission : core.agent.delete — drapeaux : sensible
Argument Type Requis Défaut Description
agent string oui

core.agent.get

Détail complet d'un agent (persona, consignes, modèles autorisés, réglages)

  • Permission : core.agent.get — drapeaux : lecture
Argument Type Requis Défaut Description
agent string oui

core.agent.list

Lister les agents

  • Permission : core.agent.list — drapeaux : lecture

Aucun argument.

core.agent.self.get

Ma propre fiche d'agent : persona, consignes, réglages, modèles autorisés

  • Permission : core.agent.self.get — drapeaux : lecture

Aucun argument.

core.agent.self.update

Modifier ma propre fiche (persona, consignes, description, réglages non sensibles, modèle autorisé)

  • Permission : core.agent.self.update
Argument Type Requis Défaut Description
display_name string non None
description string non None
persona_md string non None
instructions_md string non None
model string non None
settings object non None

core.agent.update

Modifier un agent (nouvelle version, annulable)

  • Permission : core.agent.update
Argument Type Requis Défaut Description
agent string oui
display_name string non None
description string non None
persona_md string non None
instructions_md string non None
model string non None
allowed_models liste de string non None
driver string non None
settings object non None
status active \ disabled non None
expected_version integer non None

core.agent.version.list

Historique des versions d'un agent

  • Permission : core.agent.version.list — drapeaux : lecture
Argument Type Requis Défaut Description
agent string oui

core.agent.version.revert

Revenir à une version antérieure d'un agent (crée une nouvelle version)

  • Permission : core.agent.version.revert
Argument Type Requis Défaut Description
agent string oui
version integer oui

core.audit

core.audit.query

Interroger le journal d'audit (qui a fait quoi, décision)

  • Permission : core.audit.query — drapeaux : lecture
Argument Type Requis Défaut Description
sub string non None
op string non None
decision allow \ deny \ confirm \ error
after_id integer non None
limit integer non 100

core.budget

core.budget.delete

Supprimer le budget d'un périmètre

  • Permission : core.budget.delete
Argument Type Requis Défaut Description
scope string oui

core.budget.get

Lire le budget d'un périmètre

  • Permission : core.budget.get — drapeaux : lecture
Argument Type Requis Défaut Description
scope string oui

core.budget.list

Lister les budgets (coût/jour, tours/heure, concurrence)

  • Permission : core.budget.list — drapeaux : lecture

Aucun argument.

core.budget.set

Définir le budget d'un périmètre (global | agent: | entry:)

  • Permission : core.budget.set
Argument Type Requis Défaut Description
scope string oui
usd_per_day number non None
turns_per_hour integer non None
max_turn_seconds integer non None
max_concurrent integer non None

core.config

core.config.get

Lire un réglage de l'instance

  • Permission : core.config.get — drapeaux : lecture
Argument Type Requis Défaut Description
key string oui

core.config.history

Historique des modifications de réglages

  • Permission : core.config.history — drapeaux : lecture
Argument Type Requis Défaut Description
key string non None
limit integer non 50

core.config.list

Lister les réglages de l'instance (valeur, défaut, description)

  • Permission : core.config.list — drapeaux : lecture
Argument Type Requis Défaut Description
prefix string non ''

core.config.revert

Annuler la dernière modification d'un réglage (ou celle d'une entrée d'historique)

  • Permission : core.config.revert
Argument Type Requis Défaut Description
key string oui
history_id integer non None

core.config.set

Modifier un réglage de l'instance (historisé, annulable)

  • Permission : core.config.set — drapeaux : sensible
Argument Type Requis Défaut Description
key string oui
value — oui

core.entry

core.entry.create

Créer une entrée de routage

  • Permission : core.entry.create
Argument Type Requis Défaut Description
name string oui
platform string oui
agent string oui
match object non {}
default_mode action \ info \ ignore non
sender_rules liste de — non []
proof_required none \ linked \ session \ dkim
cap string non 'all'
enabled boolean non True

core.entry.delete

Supprimer une entrée de routage

  • Permission : core.entry.delete — drapeaux : sensible
Argument Type Requis Défaut Description
entry string oui

core.entry.get

Détail d'une entrée

  • Permission : core.entry.get — drapeaux : lecture
Argument Type Requis Défaut Description
entry string oui

core.entry.list

Lister les entrées (plateforme + salon → agent, mode, plafond)

  • Permission : core.entry.list — drapeaux : lecture

Aucun argument.

core.entry.test

Simule le routage d'un message fictif (aucun effet) et renvoie la décision

  • Permission : core.entry.test — drapeaux : lecture
Argument Type Requis Défaut Description
platform string oui webchat | discord | telegram | mail | …
account string non ''
channel string non ''
thread string non ''
sender_external_id string oui id of the fictitious sender on the platform
sender_proof string non 'none' none | platform | session | dkim | sent_label
sender_display string non ''
text string non 'test'
is_dm boolean non False
sender_user_id string non None webchat only: the user proven by a session

core.entry.update

Modifier une entrée de routage

  • Permission : core.entry.update
Argument Type Requis Défaut Description
entry string oui
platform string non None
agent string non None
match object non None
default_mode action \ info \ ignore non
sender_rules liste de — non None
proof_required none \ linked \ session \ dkim
cap string non None
enabled boolean non None

core.export

core.export.metrics_token.rotate

Régénérer le jeton de /metrics (montré une fois)

  • Permission : core.export.metrics_token.rotate — drapeaux : sensible

Aucun argument.

core.export.sink.create

Créer une destination d'export (logs/événements) ; l'envoi est assuré par le plugin export

  • Permission : core.export.sink.create — drapeaux : sensible
Argument Type Requis Défaut Description
name string oui
kind loki \ otlp \ syslog \ webhook
config object non {}
secret_value string non None
streams liste de string non ['logs', 'events']
min_level string non 'info'
enabled boolean non True

core.export.sink.delete

Supprimer une destination d'export

  • Permission : core.export.sink.delete — drapeaux : sensible
Argument Type Requis Défaut Description
sink string oui

core.export.sink.list

Lister les destinations d'export (compteurs, dernière erreur)

  • Permission : core.export.sink.list — drapeaux : lecture

Aucun argument.

core.export.sink.test

Demander un envoi de test vers une destination (exécuté par le plugin export)

  • Permission : core.export.sink.test
Argument Type Requis Défaut Description
sink string oui

core.export.sink.update

Modifier une destination d'export

  • Permission : core.export.sink.update — drapeaux : sensible
Argument Type Requis Défaut Description
sink string oui
config object non None
secret_value string non None
streams liste de string non None
min_level string non None
enabled boolean non None

core.file

core.file.delete

Supprime un fichier

  • Permission : core.file.delete — drapeaux : sensible
Argument Type Requis Défaut Description
file_id string oui

Lien de téléchargement à usage unique

  • Permission : core.file.link
Argument Type Requis Défaut Description
file_id string oui
ttl_s integer non 900

core.file.list

Liste mes fichiers (tous avec le droit core.file.admin)

  • Permission : core.file.list — drapeaux : lecture
Argument Type Requis Défaut Description
limit integer non 50
all boolean non False

core.file.put

Dépose un petit fichier inline (≤ 1 Mo ; au-delà : ticket d'envoi)

  • Permission : core.file.put
Argument Type Requis Défaut Description
name string oui
content_b64 string non None
text string non None
content_type string non 'application/octet-stream'
scope string non 'private'

core.file.upload_ticket

Ticket d'envoi à usage unique : PUT avec le corps brut

  • Permission : core.file.upload_ticket
Argument Type Requis Défaut Description
name string non None
content_type string non None
scope string non 'private'
ttl_s integer non 900

core.group

core.group.create

Créer un groupe d'utilisateurs

  • Permission : core.group.create
Argument Type Requis Défaut Description
name string oui
description string non ''

core.group.delete

Supprimer un groupe (ses liaisons aussi)

  • Permission : core.group.delete — drapeaux : sensible
Argument Type Requis Défaut Description
group string oui

core.group.get

Détail d'un groupe et de ses membres

  • Permission : core.group.get — drapeaux : lecture
Argument Type Requis Défaut Description
group string oui

core.group.list

Lister les groupes

  • Permission : core.group.list — drapeaux : lecture

Aucun argument.

core.group.member.add

Ajouter un utilisateur à un groupe (hérite des droits du groupe)

  • Permission : core.group.member.add
Argument Type Requis Défaut Description
group string oui
user string oui

core.group.member.remove

Retirer un utilisateur d'un groupe

  • Permission : core.group.member.remove
Argument Type Requis Défaut Description
group string oui
user string oui

core.instance

core.instance.status

État de l'instance : version, base, comptes, runs, plugins, clés

  • Permission : core.instance.status — drapeaux : lecture

Aucun argument.

core.local

core.local.user.create

Créer un compte ACTIF (mot de passe et TOTP générés, montrés une fois) — harness-admin seulement

  • Permission : core.local.user.create — drapeaux : humain sensible
Argument Type Requis Défaut Description
username string oui
display_name string non ''
email string non None
role string non 'member'
password string non None
totp boolean non True

core.local.user.reset_password

Remplacer le mot de passe d'un compte (généré et montré une fois) — harness-admin seulement

  • Permission : core.local.user.reset_password — drapeaux : humain sensible
Argument Type Requis Défaut Description
user string oui
password string non None

core.local.user.reset_totp

Remplacer (ou retirer) l'authentificateur TOTP d'un compte — harness-admin seulement

  • Permission : core.local.user.reset_totp — drapeaux : humain sensible
Argument Type Requis Défaut Description
user string oui
clear boolean non False

core.logs

core.logs.query

Interroger le tampon de logs (filtres, curseur after_id)

  • Permission : core.logs.query — drapeaux : lecture
Argument Type Requis Défaut Description
level string non None
svc string non None
event string non None
after_id integer non None
limit integer non 100

core.marketplace

core.marketplace.add

Ajouter une marketplace de plugins (jeton optionnel : catalogues privés)

  • Permission : core.marketplace.add — drapeaux : humain sensible
Argument Type Requis Défaut Description
name string oui
url string oui
public_url string non None
priority integer non 100
enabled boolean non True
token string non None

core.marketplace.get

Détail d'une marketplace de plugins

  • Permission : core.marketplace.get — drapeaux : lecture
Argument Type Requis Défaut Description
name string oui

core.marketplace.list

Lister les marketplaces de plugins (état, présence d'un jeton ; jamais le jeton)

  • Permission : core.marketplace.list — drapeaux : lecture

Aucun argument.

core.marketplace.remove

Supprimer une marketplace de plugins (jamais celle d'origine ; ses plugins restent installés)

  • Permission : core.marketplace.remove — drapeaux : humain sensible
Argument Type Requis Défaut Description
name string oui

core.marketplace.search

Chercher des plugins dans les marketplaces actives (résultats fusionnés, étiquetés)

  • Permission : core.marketplace.search — drapeaux : lecture
Argument Type Requis Défaut Description
q string non ''
type string non ''
tag string non ''
sort name \ updated \ created non
order asc \ desc non 'asc'
limit integer non 50
marketplace string non None
cursor string non ''

core.marketplace.test

Tester une marketplace (méta publique, puis lecture du catalogue avec le jeton)

  • Permission : core.marketplace.test
Argument Type Requis Défaut Description
name string oui

core.marketplace.token.set

Poser (ou supprimer) le jeton de lecture d'une marketplace

  • Permission : core.marketplace.token.set — drapeaux : humain sensible
Argument Type Requis Défaut Description
name string oui
token string non None

core.marketplace.update

Modifier une marketplace de plugins (URL, adresse publique, priorité, activation)

  • Permission : core.marketplace.update — drapeaux : humain sensible
Argument Type Requis Défaut Description
name string oui
url string non None
public_url string non None
priority integer non None
enabled boolean non None

core.mcp

core.mcp.resource.get

Détail d'une ressource MCP

  • Permission : core.mcp.resource.get — drapeaux : lecture
Argument Type Requis Défaut Description
name string oui

core.mcp.resource.list

Liste les ressources MCP enregistrées (mcp-auth)

  • Permission : core.mcp.resource.list — drapeaux : lecture

Aucun argument.

core.mcp.resource.remove

Supprime une ressource MCP manuelle

  • Permission : core.mcp.resource.remove — drapeaux : sensible
Argument Type Requis Défaut Description
name string oui

core.mcp.resource.set

Crée ou modifie une ressource MCP (jamais celles déclarées par un plugin)

  • Permission : core.mcp.resource.set — drapeaux : sensible
Argument Type Requis Défaut Description
name string oui
url string non None
kind local \ remote non 'remote'
upstream_url string non None
auth exchange \ secret \ none non
secret_key string non None
scopes liste de string non
enabled boolean non True

core.memory

core.memory.fact.propose

Proposer un fait attribué (mode info : non fiable, jamais dans les mémoires)

  • Permission : core.memory.fact.propose
Argument Type Requis Défaut Description
content string oui
source string non ''

core.memory.promote

Promouvoir une proposition de mémoire (admin)

  • Permission : core.memory.promote
Argument Type Requis Défaut Description
id string oui

core.memory.propose

Proposer une note de mémoire (promotion par un admin ; directe pour mon agent si source sûre)

  • Permission : core.memory.propose
Argument Type Requis Défaut Description
content string oui
scope string non None
source string non ''
trusted_source boolean non False

core.memory.purge

Purger la mémoire d'un périmètre (ma personne ; tout pour un admin)

  • Permission : core.memory.purge
Argument Type Requis Défaut Description
scope string oui
ids liste de string non None

core.memory.read

Lire la mémoire accessible (socle, mon agent, ma personne)

  • Permission : core.memory.read — drapeaux : lecture
Argument Type Requis Défaut Description
scope string non None
status promoted \ proposed non 'promoted'
kind note \ fact non 'note'
limit integer non 200

core.memory.reject

Rejeter une proposition de mémoire (admin)

  • Permission : core.memory.reject
Argument Type Requis Défaut Description
id string oui

core.model

core.model.account.add

Ajouter un compte modèle (jeton OAuth ou clé API, chiffré dans core/model/)

  • Permission : core.model.account.add — drapeaux : sensible
Argument Type Requis Défaut Description
name string oui
kind api_key \ oauth_token non 'oauth_token'
token string oui
priority integer non 100
base_url string non ''
provider string non 'claude'

core.model.account.disable

Désactiver un compte modèle

  • Permission : core.model.account.disable
Argument Type Requis Défaut Description
account string oui

core.model.account.enable

Activer un compte modèle (remet à zéro le cooldown)

  • Permission : core.model.account.enable
Argument Type Requis Défaut Description
account string oui

core.model.account.list

Lister les comptes modèle (jamais les secrets)

  • Permission : core.model.account.list — drapeaux : lecture

Aucun argument.

core.model.account.order

Définir l'ordre de priorité des comptes modèle

  • Permission : core.model.account.order
Argument Type Requis Défaut Description
accounts liste de string oui

core.model.account.test

Tester un compte modèle (secret déchiffrable ; appel réseau seulement si live=true)

  • Permission : core.model.account.test
Argument Type Requis Défaut Description
account string oui
live boolean non False

core.model.account.update

Modifier un compte modèle (jeton remplacé, priorité, URL de base, fournisseur)

  • Permission : core.model.account.update — drapeaux : sensible
Argument Type Requis Défaut Description
account string oui
token string non None
priority integer non None
base_url string non None
kind api_key \ oauth_token non None
provider string non None

core.notification

core.notification.ack

Acquitter des notifications d'administration (les marquer lues)

  • Permission : core.notification.ack
Argument Type Requis Défaut Description
ids liste de string oui

core.notification.ack_all

Acquitter toutes les notifications d'administration

  • Permission : core.notification.ack_all

Aucun argument.

core.notification.list

Lister les notifications d'administration (non lues d'abord si demandé)

  • Permission : core.notification.list — drapeaux : lecture
Argument Type Requis Défaut Description
unread_only boolean non False
limit integer non 100

core.plugin

core.plugin.action.run

Exécute une action déclarée par un plugin (droit propre à l'action)

  • Permission : core.plugin.action.run
Argument Type Requis Défaut Description
name string oui
action string oui
args object non

core.plugin.capability.set

Active ou désactive une capacité d'un plugin

  • Permission : core.plugin.capability.set
Argument Type Requis Défaut Description
name string oui
capability string oui
enabled boolean oui

core.plugin.get

Page générique d'un plugin (vue, configuration, secrets, outils, ressources, actions, suivi, droits, versions)

  • Permission : core.plugin.get — drapeaux : lecture
Argument Type Requis Défaut Description
name string oui

core.plugin.install

Installe un plugin depuis une marketplace (même chemin que core.plugin.source.add ; mode shadow par défaut)

  • Permission : core.plugin.install — drapeaux : humain sensible
Argument Type Requis Défaut Description
marketplace string oui
slug string oui
ci_unknown_ok boolean non False
mode off \ shadow non 'shadow'

core.plugin.list

Liste les plugins installés

  • Permission : core.plugin.list — drapeaux : lecture

Aucun argument.

core.plugin.logs

Dernières lignes de sortie d'erreur du worker d'un plugin

  • Permission : core.plugin.logs — drapeaux : lecture
Argument Type Requis Défaut Description
name string oui
n integer non 100

core.plugin.mode.set

Mode d'un plugin : off, shadow (hooks appelés, résultat ignoré) ou on

  • Permission : core.plugin.mode.set — drapeaux : sensible
Argument Type Requis Défaut Description
name string oui
mode off \ shadow \ on oui

core.plugin.pin

Épingle un plugin sur un commit (ou lève l'épinglage)

  • Permission : core.plugin.pin — drapeaux : sensible
Argument Type Requis Défaut Description
name string oui
sha string non None
unpin boolean non False

core.plugin.policy.set

Politique de mise à jour d'un plugin (core = manual imposé)

  • Permission : core.plugin.policy.set
Argument Type Requis Défaut Description
name string oui
policy auto \ notify \ manual oui

core.plugin.preview

Aperçu d'un plugin avant installation : manifeste, droits, egress, secrets, réglages, état CI (marketplace + slug, ou URL git ; rien n'est installé ni stocké)

  • Permission : core.plugin.preview — drapeaux : lecture
Argument Type Requis Défaut Description
marketplace string non None
slug string non None
url string non None
branch string non 'main'

core.plugin.rollback

Revient à la version précédente d'un plugin (et l'épingle)

  • Permission : core.plugin.rollback — drapeaux : sensible
Argument Type Requis Défaut Description
name string oui

core.plugin.secret.set

Pose (ou supprime) un secret déclaré par un plugin

  • Permission : core.plugin.secret.set — drapeaux : sensible
Argument Type Requis Défaut Description
name string oui
key string oui
secret string non None

core.plugin.settings.set

Modifie les réglages d'un plugin (clés déclarées dans son manifeste)

  • Permission : core.plugin.settings.set
Argument Type Requis Défaut Description
name string oui
settings object non

core.plugin.source.add

Installe un plugin depuis un dépôt git autorisé (super-admin)

  • Permission : core.plugin.source.add — drapeaux : humain sensible
Argument Type Requis Défaut Description
url string oui
branch string non 'main'
ci_unknown_ok boolean non False

core.plugin.source.remove

Désinstalle un plugin externe

  • Permission : core.plugin.source.remove — drapeaux : humain sensible
Argument Type Requis Défaut Description
name string oui

core.plugin.update.apply

Applique la mise à jour d'un plugin (CI verte, bleu/vert, retour arrière)

  • Permission : core.plugin.update.apply — drapeaux : sensible
Argument Type Requis Défaut Description
name string oui
force boolean non False

core.plugin.update.check

Interroge le dépôt d'un plugin (ls-remote)

  • Permission : core.plugin.update.check — drapeaux : lecture
Argument Type Requis Défaut Description
name string oui

core.rbac

core.rbac.bind

Lier un rôle ou une permission à un sujet (ajout de droits : ré-auth ou confirmation)

  • Permission : core.rbac.bind — drapeaux : sensible
Argument Type Requis Défaut Description
subject string oui
role string non None
permission string non None
scope string non '*'
effect allow \ deny \ confirm non
expires_at string non None

core.rbac.binding.list

Lister les liaisons (rôles/permissions accordés ou refusés)

  • Permission : core.rbac.binding.list — drapeaux : lecture
Argument Type Requis Défaut Description
subject string non None

core.rbac.explain

Expliquer pourquoi une permission est accordée ou refusée à l'appelant

  • Permission : core.rbac.explain — drapeaux : lecture
Argument Type Requis Défaut Description
perm string non None
resource string non '*'

core.rbac.pending.approve

Approuver une demande en attente (humain, hors bande) et l'exécuter

  • Permission : core.rbac.pending.approve — drapeaux : humain sensible
Argument Type Requis Défaut Description
id string oui
reason string non ''

core.rbac.pending.list

Lister les demandes en attente de confirmation hors bande

  • Permission : core.rbac.pending.list — drapeaux : lecture
Argument Type Requis Défaut Description
status pending \ approved \ rejected \ expired \
limit integer non 50

core.rbac.pending.reject

Rejeter une demande en attente

  • Permission : core.rbac.pending.reject — drapeaux : humain
Argument Type Requis Défaut Description
id string oui
reason string non ''

core.rbac.permission.list

Lister les permissions connues (issues du code : socle et plugins)

  • Permission : core.rbac.permission.list — drapeaux : lecture
Argument Type Requis Défaut Description
source string non None core | plugin:
query string non None substring of the name or description
limit integer non 500

core.rbac.role.create

Créer un rôle personnalisé

  • Permission : core.rbac.role.create — drapeaux : sensible
Argument Type Requis Défaut Description
name string oui
description string non ''
permissions liste de string non []

core.rbac.role.delete

Supprimer un rôle personnalisé inutilisé

  • Permission : core.rbac.role.delete — drapeaux : sensible
Argument Type Requis Défaut Description
name string oui

core.rbac.role.list

Lister les rôles et leurs permissions

  • Permission : core.rbac.role.list — drapeaux : lecture

Aucun argument.

core.rbac.role.update

Modifier un rôle personnalisé (ajouter des permissions = ajout de droits)

  • Permission : core.rbac.role.update — drapeaux : sensible
Argument Type Requis Défaut Description
name string oui
description string non None
permissions liste de string non None

core.rbac.simulate

Simuler la décision du PDP pour un autre sujet (sans rien exécuter)

  • Permission : core.rbac.simulate — drapeaux : lecture
Argument Type Requis Défaut Description
sub string oui
act string non None
perm string oui
resource string non '*'
ctx object non {}
human_session boolean non False

core.rbac.unbind

Retirer une liaison (retrait de droits : immédiat ; retirer un refus = ajout de droits)

  • Permission : core.rbac.unbind
Argument Type Requis Défaut Description
id string non None
subject string non None
role string non None
permission string non None
scope string non '*'

core.run

core.run.cancel

Demander l'annulation d'un run en cours

  • Permission : core.run.cancel
Argument Type Requis Défaut Description
id string oui

core.run.get

Détail d'un run (statut, coût, jetons, manifeste)

  • Permission : core.run.get — drapeaux : lecture
Argument Type Requis Défaut Description
id string oui

core.run.list

Lister les runs (les miens ; tous avec core.run.read_all)

  • Permission : core.run.list — drapeaux : lecture
Argument Type Requis Défaut Description
agent string non None
status string non None
limit integer non 50
before string non None

core.run.transcript

Transcription d'un run (événements ordonnés, curseur after_seq)

  • Permission : core.run.transcript — drapeaux : lecture
Argument Type Requis Défaut Description
id string oui
after_seq integer non 0
limit integer non 500

core.secret

core.secret.list

Lister les noms de secrets (empreinte seulement)

  • Permission : core.secret.list — drapeaux : lecture
Argument Type Requis Défaut Description
prefix string non ''

core.secret.rotate

Remplacer un secret existant (valeur fournie, ou générée et montrée une fois)

  • Permission : core.secret.rotate — drapeaux : sensible
Argument Type Requis Défaut Description
name string oui
secret_value string non None

core.secret.set

Enregistrer un secret chiffré (jamais relisible par une opération)

  • Permission : core.secret.set — drapeaux : sensible
Argument Type Requis Défaut Description
name string oui
secret_value string oui

core.secret.test

Vérifier qu'un secret existe et se déchiffre (sans le montrer)

  • Permission : core.secret.test — drapeaux : lecture
Argument Type Requis Défaut Description
name string oui

core.skill

core.skill.disable

Désactiver un skill (admin, ou mon agent pour les siens)

  • Permission : core.skill.disable
Argument Type Requis Défaut Description
id string oui

core.skill.list

Lister les skills visibles (socle, mon agent)

  • Permission : core.skill.list — drapeaux : lecture
Argument Type Requis Défaut Description
scope string non None

core.skill.promote

Promouvoir (activer) un skill proposé

  • Permission : core.skill.promote
Argument Type Requis Défaut Description
id string oui

core.skill.propose

Proposer ou éditer un skill (mon agent : actif ; socle : proposition à promouvoir)

  • Permission : core.skill.propose
Argument Type Requis Défaut Description
name string oui
description string non ''
content_md string oui
scope string non None

core.skill.view

Lire le contenu d'un skill

  • Permission : core.skill.view — drapeaux : lecture
Argument Type Requis Défaut Description
id string non None
name string non None
scope string non 'socle'

core.smtp

core.smtp.test

Envoyer un e-mail de test avec le réglage SMTP actuel (destinataire : le mien par défaut)

  • Permission : core.smtp.test — drapeaux : sensible
Argument Type Requis Défaut Description
to string non None

core.svc

core.svc.create

Créer un compte de service (n8n, automate) ; le jeton hsvc_ n'est montré qu'une fois

  • Permission : core.svc.create — drapeaux : sensible
Argument Type Requis Défaut Description
name string oui
description string non ''
days integer non None

core.svc.delete

Supprimer un compte de service et ses liaisons

  • Permission : core.svc.delete — drapeaux : sensible
Argument Type Requis Défaut Description
svc string oui

core.svc.key.create

Créer une clé API : compte de service + rôles + expiration + IP autorisées ; jeton montré une fois

  • Permission : core.svc.key.create — drapeaux : sensible
Argument Type Requis Défaut Description
name string oui
description string non ''
roles liste de string non []
days integer non None
cidrs liste de string non []

core.svc.key.issue

Émettre une nouvelle clé pour un compte de service (l'ancienne est invalidée ; montrée une fois)

  • Permission : core.svc.key.issue — drapeaux : sensible
Argument Type Requis Défaut Description
svc string oui
days integer non None
cidrs liste de string non None

core.svc.key.limits

Modifier l'expiration (renouvellement depuis maintenant) et/ou les IP autorisées d'une clé, sans la régénérer

  • Permission : core.svc.key.limits
Argument Type Requis Défaut Description
svc string oui
days integer non None
cidrs liste de string non None

core.svc.key.list

Lister les clés API (comptes de service) : rôles, expiration, dernier usage, IP autorisées

  • Permission : core.svc.key.list — drapeaux : lecture

Aucun argument.

core.svc.key.revoke

Révoquer la clé d'un compte de service (le compte et ses rôles restent)

  • Permission : core.svc.key.revoke — drapeaux : sensible
Argument Type Requis Défaut Description
svc string oui

core.svc.list

Lister les comptes de service

  • Permission : core.svc.list — drapeaux : lecture

Aucun argument.

core.svc.set_enabled

Activer ou désactiver un compte de service

  • Permission : core.svc.set_enabled
Argument Type Requis Défaut Description
svc string oui
enabled boolean oui

core.svc.token.rotate

Régénérer le jeton d'un compte de service (ancien invalidé, nouveau montré une fois)

  • Permission : core.svc.token.rotate — drapeaux : sensible
Argument Type Requis Défaut Description
svc string oui
days integer non None

core.token

core.token.create

Créer un jeton personnel pour la CLI (session humaine ; montré une fois)

  • Permission : core.token.create — drapeaux : humain
Argument Type Requis Défaut Description
name string oui
days integer non 30

core.token.list

Lister mes jetons personnels

  • Permission : core.token.list — drapeaux : lecture

Aucun argument.

core.token.revoke

Révoquer un de mes jetons personnels

  • Permission : core.token.revoke
Argument Type Requis Défaut Description
id string oui

core.user

core.user.delete

Supprimer définitivement un utilisateur DÉSACTIVÉ (identités, sessions, jetons, liaisons ; runs et conversations conservés sans propriétaire)

  • Permission : core.user.delete — drapeaux : humain sensible
Argument Type Requis Défaut Description
user string oui
confirm_username string oui

core.user.disable

Désactiver un utilisateur (sessions et jetons personnels révoqués)

  • Permission : core.user.disable — drapeaux : sensible
Argument Type Requis Défaut Description
user string oui

core.user.enable

Réactiver un utilisateur désactivé

  • Permission : core.user.enable — drapeaux : sensible
Argument Type Requis Défaut Description
user string oui

core.user.get

Détail d'un utilisateur (identités liées, groupes, accès aux agents)

  • Permission : core.user.get — drapeaux : lecture
Argument Type Requis Défaut Description
user string oui

core.user.invite

Inviter un utilisateur : crée le compte en attente et un lien d'activation à usage unique

  • Permission : core.user.invite — drapeaux : sensible
Argument Type Requis Défaut Description
username string oui
display_name string non ''
email string non None
role string non 'member'

core.user.list

Lister les utilisateurs

  • Permission : core.user.list — drapeaux : lecture
Argument Type Requis Défaut Description
status pending \ active \ disabled non
limit integer non 200

core.user.self.email.set

Définir mon adresse e-mail (un code de vérification est envoyé si SMTP est réglé)

  • Permission : core.user.self.email.set
Argument Type Requis Défaut Description
email string oui

core.user.self.email.verify

Vérifier mon adresse e-mail avec le code reçu

  • Permission : core.user.self.email.verify
Argument Type Requis Défaut Description
code string oui

core.user.self.get

Mon profil, mes identités liées, mes préférences

  • Permission : core.user.self.get — drapeaux : lecture

Aucun argument.

Lier une identité de plateforme à mon compte (preuve : session web)

  • Permission : core.user.self.link_identity
Argument Type Requis Défaut Description
platform string oui
external_id string oui
label string non ''

core.user.self.password

Changer mon mot de passe (session humaine uniquement)

  • Permission : core.user.self.password — drapeaux : humain
Argument Type Requis Défaut Description
current_password string oui
new_password string oui

core.user.self.totp

Activer, confirmer ou retirer mon TOTP (session humaine uniquement)

  • Permission : core.user.self.totp — drapeaux : humain
Argument Type Requis Défaut Description
action begin \ confirm \ disable oui
password string non None
code string non None

core.user.self.update

Modifier mon profil et mes préférences (jamais mes rôles)

  • Permission : core.user.self.update
Argument Type Requis Défaut Description
display_name string non None
email string non None
prefs object non None
profile_md string non None

core.user.update

Modifier le nom ou l'email d'un utilisateur

  • Permission : core.user.update
Argument Type Requis Défaut Description
user string oui
display_name string non None
email string non None

core.view

core.view.list

List view keys you created (metadata only, never the keys)

  • Permission : core.view.list — drapeaux : lecture
Argument Type Requis Défaut Description
type string non None
id string non None
include_inactive boolean non False

core.view.revoke

Revoke a view key (and the cookies it produced)

  • Permission : core.view.revoke
Argument Type Requis Défaut Description
key_id string oui Key id as returned by core.view.list

core.view.share

Create a single-use view link and send it to you (or a user) by direct message

  • Permission : core.view.share
Argument Type Requis Défaut Description
type string oui Object type: j (job/run), a (agent), u (person), s (session)
id string oui Object id
recipient string non None Optional 'user:' to receive the link instead of you
level string non 'summary' summary (default) or debug (super-admin only)
ttl_hours integer non 24

core.whoami

core.whoami

Qui suis-je : identité, contexte, rôles et permissions effectives

  • Permission : core.whoami — drapeaux : lecture

Aucun argument.