Create an agent profile
POST/api/v1/agent-profiles/create
Creates a profile in the caller's project library. A duplicate profile ID fails
with ALREADY_EXISTS; use update to
replace an existing profile. The store assigns the initial immutable version.
The system prompt must be a valid template and every variable spec needs a unique name;
otherwise create fails with 400.
Enabled profiles are immediately selectable. Disabled profiles are omitted from
the selection library, and a direct send naming one fails with
ACTIVE_PROFILE_DISABLED. Queued messages currently take a different fallback
path; see unusable profiles.
Request
Responses
- 200
Profile created; the stored record is echoed back
Document ID: DOC-MA-profiles-prompts-api-createAgentProfile. Section identities and revisions.
| Section | Stable reference |
|---|---|
| Overview | DOC-MA-profiles-prompts-api-createAgentProfile#overview |
| Request | DOC-MA-profiles-prompts-api-createAgentProfile#request |
| Responses | DOC-MA-profiles-prompts-api-createAgentProfile#responses |