Console

Start

Platform

App store purchases

Auth

Builds

Database

Flags

Hosting

Jobs and cron

Localization

Monitoring

Network

Notifications

Organizations

Payments

Queues

Events

Realtime

Runners

Sandboxes

Storage

Webhooks

Workflows

Getting Started

Installation

Authentication

AI Services

KV Store

Overview

Webhooks

Deploy & Infrastructure

Reference

On this page

Request
Response
Asset
ResourceMeta
AssetRecipe
Condition
Variant
QaFinding
Errors
Examples

Reference

List assets

Lists assets.

Checked 2026-09-28

This method is not served on the public API. api.sylphx.com does not route this call: its backend is not deployed behind the public API, or does not implement the call. This page documents the contract. It is kept out of the sidebar and of search engines.

Lists assets. The filter is limited to kind, state, and review_state.

Not available yet. Sylphx Generated Assets is declared in the registry but no backend serves it: every call answers 501 with the problem code UNIMPLEMENTED.

Path GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/assets
Scope assets:read
Effect read — nothing is written.
Collection assets
Query page_size, page_token, filter
Pagination the answer carries assets and, when there is more, next_page_token

#Request

Field	Type	What it is
`parent`	`string`	The parent to list in. Required.
`page_size`	`int32`	At most this many; default 50, clamped to 1000.
`page_token`	`string`	`next_page_token` of the previous page.
`filter`	`string`	AIP-160 filter, limited to `kind`, `state`, and `review_state`; for example `kind = ASSET_KIND_IMAGE AND state = ASSET_STATE_READY`.

#Response

Field	Type	What it is
`assets`	`Asset[]`	The page.
`next_page_token`	`string`	The token of the next page; empty on the last page.

#Asset

Field	Type	What it is
`name`	`string`	`orgs/{org}/projects/{project}/envs/{env}/assets/{asset}`, where `{asset}` is the 16-hex logical key.
`uid`	`string`	`ast_<cell><ulid>`; never reused. Output only.
`meta`	`ResourceMeta`	Resource metadata.
`key`	`string`	The logical key: 16 lowercase hex characters computed from the recipe. Output only.
`kind`	`AssetKind`	What kind of asset this is. Output only. One of `image`, `sfx`, `music`, `video`, `character`, `voice`.
`recipe`	`AssetRecipe`	The recipe the asset was declared with. Output only.
`canonical`	`string`	The exact text the key is the hash of. Output only.
`variants_wanted`	`int32`	How many variants the recipe asks for. Output only.
`state`	`AssetState`	Where the asset is in its life. Output only. One of `pending`, `ready`, `approved`, `failed`, `refused`, `unsupported`.
`conditions`	`Condition[]`	Ready, Reconciling, Stalled. Output only.
`seed`	`string`	The seed of the asset, a decimal integer as a string. Output only.
`variants`	`Variant[]`	The stored variants, ordered by slot. Output only.
`create_time`	`timestamp`	When the asset was first generated. Output only.
`update_time`	`timestamp`	When the asset last changed. Output only.

#ResourceMeta

Field	Type	What it is
`generation`	`int64`	Increases by one on every change to `spec`. Output only.
`etag`	`string`	Strong ETag (AIP-154): changes on any change to spec, status, or metadata. Send it back as `If-Match` or `etag` to make Update and Delete conditional; a mismatch fails with ABORTED / 409 `ETAG_MISMATCH`. Output only.
`create_time`	`timestamp`	When the Resource was created. Output only.
`update_time`	`timestamp`	When the Resource last changed. Output only.
`delete_time`	`timestamp`	Set while the Resource is being deleted. Output only.
`labels`	`map<string, string>`	Caller-writable, indexed labels (AIP-122 label rules).
`annotations`	`map<string, string>`	Caller-writable, unindexed annotations.
`display_name`	`string`	Caller-writable human-readable name.
`creator`	`string`	The principal that created the Resource. Output only.

#AssetRecipe

Field	Type	What it is
`kind`	`AssetKind`	What kind of asset to make. Required. One of `image`, `sfx`, `music`, `video`, `character`, `voice`.
`prompt`	`string`	What to make, at most 8000 bytes. Empty only for `ASSET_KIND_CHARACTER`. Required.
`locale`	`string`	The locale of the asset, a BCP 47 tag; empty for images.
`character_id`	`string`	The character this asset shows; only for `ASSET_KIND_CHARACTER`, encoded in the canonical text as `id=`.
`params`	`map<string, string>`	Kind-specific parameters in canonical text form, such as `"2"`, `"1024x768"`, `"true"` or a 16-hex key. At most 16 pairs; keys are `[a-z_]` up to 32 characters, values up to 256 characters.
`key`	`string`	The key the caller computed, 16 lowercase hex characters. When it differs from the server's, the call is refused with `INVALID_FIELD` and the problem carries the server's canonical text, which catches encoder drift.

#Condition

Field	Type	What it is
`type`	`string`	The condition type, for example `Ready`.
`status`	`ConditionStatus`	Whether the condition holds. One of `true`, `false`, `unknown`.
`observed_generation`	`int64`	The generation this observation was made against.
`reason`	`string`	A machine-readable UpperCamelCase reason.
`message`	`string`	A customer-safe human-readable message.
`severity`	`Severity`	How severe a FALSE condition is. One of `info`, `warning`, `error`.
`transition_time`	`timestamp`	When `status` last changed.

#Variant

Field	Type	What it is
`slot`	`int32`	The slot the variant fills, from 0. Output only.
`content_hash`	`string`	The SHA-256 of the file's bytes, 64 lowercase hex characters. Output only.
`url`	`string`	The immutable public URL: the project's base URL, then the content hash and extension. Output only.
`media_type`	`string`	The file's media type, such as `image/png`. Output only.
`ext`	`string`	The file's extension without the dot, such as `png`. Output only.
`width`	`int32`	Width in pixels. Output only.
`height`	`int32`	Height in pixels. Output only.
`bytes`	`int64`	The file's size in bytes. Output only.
`model`	`string`	The model that made this variant. Output only.
`seed`	`string`	The seed this variant was made with, a decimal integer as a string. Output only.
`review_state`	`ReviewState`	The human review of the variant. Output only. One of `unreviewed`, `approved`, `rejected`, `retired`.
`qa_state`	`QaState`	The result of QA on the file. Output only. One of `passed`, `warning`, `failed`.
`findings`	`QaFinding[]`	What QA found. Output only.
`content_credentials`	`bool`	Whether the file carries content credentials. Output only.
`approved_by`	`string`	The principal that approved the variant; empty until it is approved. Output only.
`create_time`	`timestamp`	When the variant was stored. Output only.

#QaFinding

Field	Type	What it is
`check`	`QaCheck`	The check that found it. Output only. One of `format`, `size`, `content_credentials`, `moderation`.
`severity`	`QaSeverity`	How serious it is. Output only. One of `error`, `warning`.
`message`	`string`	What is wrong. Output only.

#Errors

UNAUTHENTICATED — No valid key or token was presented.
PERMISSION_DENIED — The key lacks the method's permission.
INVALID_FIELD — A field failed validation.
PAGE_TOKEN_MISMATCH — A page token was reused with different parameters.

Every error arrives in the body Errors describes.

#Examples

curl "https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/assets" \
  -H "Authorization: Bearer $SYLPHX_API_KEY"

Was this page helpful?

Tell us what is missing, wrong, or unclear — this opens a real inbox.

Send feedback

Platform links