Skip to content

List graphic revisions

GET/v2/themes/{themeId}/rive-graphics/{graphicId}/revisions

GET
/v2/themes/{themeId}/rive-graphics/{graphicId}/revisions
curl --request GET \
--url https://api.ligr.live/rest/v2/themes/1/rive-graphics/example/revisions \
--header 'Authorization: Bearer <token>'

Beta. This operation can change between minor versions. See Beta status.

List every runtime revision attached to the graphic, newest first, with the published versions that pin each one. Download one with GET files/{kind}?version=working&revisionId=….

themeId
required
number format: double
graphicId
required
string

Ok

Media typeapplication/json
object
versions
required

Newest first.

Array<object>
object
version
required
integer format: int32
publishedAt
required
string
revisionIds
required

Revisions the version’s Rive assets pin.

Array<string>
revisions
required

Newest first.

Array<object>
object
revisionId
required
string
assetId
required
string
createdAt
required
string
sourceKind
required
string
Allowed values: runtime editor project
originalFilename
required
string
nullable
selectedEntry
required
string
nullable
runtimeSize
required
number format: double
nullable
runtimeSha256
required
string
nullable
sourceAvailable
required
boolean
sourceSize
required
number format: double
nullable
editableSource
required
boolean
archive
required
boolean
working
required

The working draft plays this revision.

boolean
publishedVersions
required

Published graphic versions that pin this revision.

Array<number>
repairs
required

What the repair changed when this revision was imported. Null when nothing was repaired.

object
total
required
integer format: int32
items
required
Array<object>
object
rule
required

reference-cleared, leftover-removed or editor-field-cleared.

string
element
required

The Rive object type, or * for a group of mixed types.

string
attribute
required
string
location
required

Where the repair is in the Rive editor. Null for leftovers outside any artboard.

string
nullable
count
required
integer format: int32
details
required

Up to 20 specific places inside the location, for example a transition.

Array<string>
draftOf
required

The first version published after this upload. Null while that draft is still the working draft.

number format: double
nullable
Example
{
"revisions": [
{
"sourceKind": "runtime"
}
]
}

Invalid Rive request

Media typeapplication/json
object
message
required
string
code
required
string
Examplegenerated
{
"message": "example",
"code": "example"
}

Theme, import, graphic, version, or file not found

Media typeapplication/json
object
message
required
string
code
required
string
Examplegenerated
{
"message": "example",
"code": "example"
}

Rive import or graphic state conflict

Media typeapplication/json
object
message
required
string
code
required
string
Examplegenerated
{
"message": "example",
"code": "example"
}

Rive candidate or source is no longer available

Media typeapplication/json
object
message
required
string
code
required
string
Examplegenerated
{
"message": "example",
"code": "example"
}

Rive file or configuration cannot be used

Media typeapplication/json
object
message
required
string
code
required
string
Examplegenerated
{
"message": "example",
"code": "example"
}

Rive source imports are unavailable

Media typeapplication/json
object
message
required
string
code
required
string
Examplegenerated
{
"message": "example",
"code": "example"
}