Skip to content
Console
Menu

Alerts and status pages

App store purchases

Credits

Knowledge

KV

Notifications

Organizations

Storage

Workflows

API reference

Getting Started

Authentication

KV Store

Upsert a chat sticker pack

Publishes the trusted backend's complete sticker pack catalog.

Publishes the trusted backend's complete sticker pack catalog.

  • Path POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/chat_sticker_packs/chat-sticker-pack:upsert
  • Scope events:chat:admin
  • Effect write — a successful call changes state.
  • Collection chat_sticker_packs

#Request

FieldTypeWhat it is
namestringPack resource name. Required.
display_namestringDisplay name. Required.
assetsChatStickerAsset[]Complete catalog, one to 256 distinct assets. All pack_ids must match name. Required.

#ChatStickerAsset

FieldTypeWhat it is
stickerChatStickerImmutable content identity and delivery location. Required.
labelstringAccessible human-readable asset label, at most 200 bytes. Required.

#ChatSticker

FieldTypeWhat it is
pack_idstringCatalog pack identifier; the complete Money feature key is at most 64 bytes. Required.
sticker_idstringIdentifier inside the pack. Required.
content_uristringOptional on send; if supplied must match the catalog. Output is authoritative.
sha256stringOptional on send; exact lowercase SHA-256 from the catalog.
mime_typestringOptional on send; exact catalog image MIME type.

#Response

FieldTypeWhat it is
namestringResource name; last segment is the pack_id in the Money feature key.
uidstringStable identifier. Output only.
metaResourceMetaResource metadata.
display_namestringDisplay name, at most 200 bytes. Output only.
assetsChatStickerAsset[]Catalog assets in sticker-id order. Output only.
revisionint64Monotonic revision; serialized as a decimal string. Output only.

#ResourceMeta

FieldTypeWhat it is
generationint64Increases by one on every change to spec. Output only.
etagstringStrong 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_timetimestampWhen the Resource was created. Output only.
update_timetimestampWhen the Resource last changed. Output only.
delete_timetimestampSet while the Resource is being deleted. Output only.
labelsmap<string, string>Caller-writable, indexed labels (AIP-122 label rules).
annotationsmap<string, string>Caller-writable, unindexed annotations.
display_namestringCaller-writable human-readable name.
creatorstringThe principal that created the Resource. Output only.

#ChatStickerAsset

FieldTypeWhat it is
stickerChatStickerImmutable content identity and delivery location. Required.
labelstringAccessible human-readable asset label, at most 200 bytes. Required.

#ChatSticker

FieldTypeWhat it is
pack_idstringCatalog pack identifier; the complete Money feature key is at most 64 bytes. Required.
sticker_idstringIdentifier inside the pack. Required.
content_uristringOptional on send; if supplied must match the catalog. Output is authoritative.
sha256stringOptional on send; exact lowercase SHA-256 from the catalog.
mime_typestringOptional on send; exact catalog image MIME type.

#Errors

Every error arrives in the body Errors describes.

#Examples

curl -X POST "https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/chat_sticker_packs/chat-sticker-pack:upsert" \
  -H "Authorization: Bearer $SYLPHX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"assets":[{"label":"…","sticker":{"pack_id":"…","sticker_id":"…"}}],"display_name":"…"}'