Skip to content

List Snapshots

GET
/api/v1/projects/{project_id}/snapshots
curl --request GET \
--url 'https://aura.strangeworks.com/api/v1/projects/example/snapshots?limit=50&offset=0' \
--header 'Authorization: Bearer <token>'
project_id
required
Project Id
string
limit
Limit
integer
default: 50 >= 1 <= 200
offset
Offset
integer
0

Successful Response

Media typeapplication/json
SnapshotListResponse
object
limit
required
Limit
integer
offset
required
Offset
integer
snapshots
required
Snapshots
Array<object>
SnapshotResponse

Metadata for a single workspace snapshot (list view).

Built from the Snapshot ORM object via model_validate; solution_summary is read from the model’s like-named property (the linked execution’s summary), so the execution relationship must be eager-loaded.

object
conversation_id
Any of:
string
created_at
required
Created At
string format: date-time
execution_id
Any of:
string
file_count
required
File Count
integer
id
required
Id
string
kind
SnapshotKind
string
default: solve
Allowed values: solve manual
label
Any of:
string
parent_snapshot_id
Any of:
string
project_id
required
Project Id
string
solution_path
Any of:
string
solution_summary
Any of:
string
tags
Tags
Array<string>
default:
total_size_bytes
required
Total Size Bytes
integer
total
required
Total
integer
Example
{
"snapshots": [
{
"kind": "solve",
"tags": []
}
]
}

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
"detail": [
{
"ctx": {},
"input": "example",
"loc": [
"example"
],
"msg": "example",
"type": "example"
}
]
}