Skip to main content
GET
/
v1
/
particles
/
{particle_id}
/
versions
List Particle Versions
curl --request GET \
  --url https://api.cuadra.ai/v1/particles/{particle_id}/versions \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "<string>",
    "version": 123,
    "tokenCount": 123,
    "createdAt": "2023-11-07T05:31:56Z",
    "content": "You are a helpful assistant.",
    "createdBy": "user_xyz789"
  }
]

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
particle_id
string
required

Particle ID

Response

Successful Response

​
id
string
required

Unique version identifier

Example:

"pv_abc123"

​
version
integer
required

Sequential version number

Example:

1

​
tokenCount
integer
required

Pre-computed token count

Example:

25

​
createdAt
string<date-time>
required

Timestamp when this version was created

Example:

"2024-01-15T10:30:00Z"

​
content
string | null

Particle content (hidden for system particles unless admin)

Example:

"You are a helpful assistant."

​
createdBy
string | null

ID of the user who created this version

Example:

"user_xyz789"