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