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:
- 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 |
core.file.link¶
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
- 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.
core.user.self.link_identity¶
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: |
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.