Skip to main content

Save agent profile

POST /api/agent-profiles/{name}

Create or update an agent profile under name (path name is authoritative). Server-managed id/revision: overwrite keeps the namesake's id and bumps revision; create mints a fresh id (save_profile_preserving_identity). Returns 422 on invalid payloads (secret-safe detail) and 409 when creating a new profile would exceed MAX_AGENT_PROFILES.

Parameters​

NameInTypeRequiredDescription
namepathstringyes—
org_idquery`stringnull`no

Responses​

StatusDescription
201Successful Response
422Validation Error

Response body​

FieldTypeRequiredDescription
namestringyes—
messagestringyes—

Operation ID: save_agent_profile_api_agent_profiles__name__post