Update Particle
Update a particle. If content is changed, a new version is created automatically. System particles cannot be modified.
Authorizations
JWT token from Stytch B2B authentication (magic link, SSO, or M2M)
Headers
Path Parameters
Particle ID
Body
Request schema for updating a particle. Updating content creates a new version automatically.
Updated name
1 - 255"Updated Tone"
Updated description
1000"Updated description text"
New content (creates a new version)
1 - 50000"Updated prompt content."
Updated enabled status
true
Response
Successful Response
Response schema for particle. Content visibility is controlled by is_system flag: - System particles: content hidden (MOAT protection) - Organization particles: content visible to org members
Unique particle identifier
"part_abc123"
Human-readable name
"Professional Tone"
Particle category
role, tone, guardrails, constraints, format "tone"
Whether this is a system-managed particle
false
Whether the particle is active
true
Timestamp when the particle was created
"2024-01-15T10:30:00Z"
Timestamp when the particle was last updated
"2024-01-15T14:45:00Z"
Particle description
"Sets professional tone"
Current version number (derived from current_version)
3
Token count of current version
25
Current content (hidden for system particles)
"Maintain a professional tone."
Version history (when expanded)