Skip to main content
POST
Add Particle to System Prompt

Authorizations

Authorization
string
header
required

JWT token from Stytch B2B authentication (magic link, SSO, or M2M)

Headers

Idempotency-Key
string | null

Path Parameters

system_prompt_id
string
required

System Prompt ID

Body

application/json

Request schema for adding a particle to a system prompt.

particleId
string
required

ID of the particle to add

Example:

"part_abc123"

particleVersionId
string | null

Optional version ID to pin (NULL = use current)

Example:

"pv_xyz789"

order
integer
default:0

Order in the composition (lower = earlier)

Required range: x >= 0
Example:

0

Response

Successful Response

Response schema for a particle within a system prompt.

id
string
required

Association ID

Example:

"spa_abc123"

particleId
string
required

Particle ID

Example:

"part_xyz789"

order
integer
required

Order in composition

Example:

0

particleName
string | null

Particle name (derived)

Example:

"Professional Tone"

particleCategory
enum<string> | null

Particle category (derived)

Available options:
role,
tone,
guardrails,
constraints,
format
Example:

"tone"

particleVersionId
string | null

Pinned version ID (NULL = current)

Example:

"pv_abc123"

pinnedVersion
integer | null

Pinned version number (derived)

Example:

2

tokenCount
integer | null

Token count of the particle content

Example:

25