Tileset Management

Manage your tileset collection — create, read, update, delete, assign to projects, and export.

Endpoints

Operation	Method	Endpoint
List tilesets	`GET`	`/api/tilesets`
Show tileset	`GET`	`/api/tilesets/\{id\}`
Update tileset	`PUT`	`/api/tilesets/\{id\}`
Delete tileset	`DELETE`	`/api/tilesets/\{id\}`
Export as ZIP	`GET`	`/api/tilesets/\{id\}/export-zip`

Update Tileset

Parameters

Name	Type	Required	Description
`name`	string	No	Tileset name
`description`	string	No	Tileset description
`type`	string	No	Type: `top_down`, `sidescroller`, `isometric`
`project_id`	string	No	Project to assign tileset to

Example

curl -X PUT https://api.spritesynth.com/api/tilesets/ts_xyz \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Dungeon Floor Set",
    "description": "Stone and dirt tiles for dungeon environments",
    "project_id": "proj_123"
  }'

Export as ZIP

Download tileset assets as a single ZIP file for use in game engines.

curl -X GET https://api.spritesynth.com/api/tilesets/ts_xyz/export-zip \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --output tileset_export.zip

ZIP Contents

tileset_export/
├── metadata.json
├── tiles/
│   ├── inner_001.png
│   ├── inner_002.png
│   └── outer_001.png
├── atlas.json
└── tiled/
    └── tileset.tsj

Tips

Assign tilesets to projects to keep related assets organized.
Export includes Tiled-compatible JSON for direct import.
Use the atlas.json for custom engine integrations.

Need help?

Join our Discord community for support and tips.

Tileset Management

On this page