Passer au contenu principal
PATCH
Mettre à jour l'agent

Mettre à jour l’agent

PATCH /v1/agents/{agentID} Met à jour les champs modifiables d’une identité d’agent machine existante. Seuls les champs fournis dans le corps de la requête sont modifiés ; tous les autres champs restent inchangés. Au moins un champ doit être fourni.
Pour modifier les étendues d’un agent, utilisez le système de délégation ou réenregistrez l’agent. agent. Les portées ne peuvent pas être modifiées directement via ce point de terminaison pour préserver la piste d’audit des changements de portée.

Authentification

Nécessite l’en-tête X-API-Key ou un jeton JWT Bearer. L’espace de travail est dérivé de l’identifiant authentifié ; n’envoyez pas X-Tenant-ID.

Corps de la requête

Tous les champs sont facultatifs, mais au moins un doit être fourni.

Réponse

Renvoie l’objet d’identité d’agent mis à jour complet.
string
Clé primaire UUID interne.
string
Identifiant d’agent conforme à MAIP.
string
Le nom d’affichage mis à jour.
string
La description mise à jour.
object
L’objet de métadonnées mis à jour.
string
Statut du cycle de vie actuel après la mise à jour.
string
Horodatage ISO 8601 reflétant la mise à jour.

Exemple

Autorisations

X-API-Key
string
header
requis

Clé API pour l'authentification machine-à-machine

Paramètres de chemin

agentId
string<uuid>
requis

Identifiant de l'agent

Corps

application/json
description
string | null
display_name
string | null
Maximum string length: 256
metadata
any
status
string | null

Réponse

Agent mis à jour

id
string<uuid>
agent_type
enum<string>
Options disponibles:
orchestrator,
worker,
inference,
pipeline,
service,
bot,
llm
display_name
string
Maximum string length: 256
description
string
status
enum<string>
Options disponibles:
active,
suspended,
revoked
scopes
string[]
metadata
object
trust_score
number<float>
Plage requise: 0 <= x <= 1
public_key
string

Clé publique encodée en Base64

session_count
integer
keys
object[]
created_at
string<date-time>
updated_at
string<date-time>