Thanks to visit codestin.com
Credit goes to sprites.dev

Sprites Sprites

Sprites

Persistent Linux environments that hibernate when idle and wake automatically on demand.

Create Sprites for development environments, CI runners, code execution sandboxes, or any workload that benefits from fast startup with preserved state. Each Sprite gets a unique URL for HTTP access, configurable as public or authenticated.

Base URL

All requests are made against:

https://api.sprites.dev/v1

Authentication

Authenticate every request with a Sprites API token using the Authorization: Bearer <token> header.

Resources

Start with the core sprite management endpoints.

Create Sprite POST List Sprites GET Get Sprite GET Destroy Sprite DELETE Update Sprite PUT

Sprites

Create Sprite

Create a new sprite with a unique name in your organization

POST /sprites

Request Body

application/json
name* string

Unique name for the sprite within the organization

url_settings?

URL access configuration

auth? "sprite" | "public"

Authentication type (default: sprite)

Response Body

application/json
id* string

Unique sprite identifier

name* string

Sprite name within the organization

organization* string

Organization slug

url* string

Sprite HTTP endpoint URL

url_settings?

URL access configuration

auth* "sprite" | "public"

Authentication type

private_access? "admins" | "organization"

Who may access a sprite-authenticated URL.

status* "cold" | "warm" | "running"

Runtime status

created_at* string

Creation timestamp (ISO 8601)

updated_at* string

Last update timestamp (ISO 8601)

version? string

Version configured for or currently running on the sprite.

environment_version? string

Version of the sprite environment image.

last_running_at? string

When the sprite was last observed running (ISO 8601), null if not tracked

last_warming_at? string

When the sprite was last observed warming (ISO 8601), null if not tracked

labels? string

Labels assigned to the sprite. Omitted when empty.

Response Codes

201

Created
400

Invalid request parameters
401

Missing or invalid authentication
bash 
curl -X POST \
  "https://api.sprites.dev/v1/sprites" \
  -H "Authorization: Bearer $SPRITES_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"my-sprite","url_settings":{"auth":"public"}}'
200 Response 
{
  "id": "sprite-01234567-89ab-cdef-0123-456789abcdef",
  "name": "my-dev-sprite",
  "status": "cold",
  "version": "v0.0.1-rc48",
  "url": "https://name-random-alphanumeric.sprites.app",
  "labels": [
    "production"
  ],
  "url_settings": {
    "auth": "sprite"
  },
  "updated_at": "2024-01-15T14:22:00Z",
  "created_at": "2024-01-15T10:30:00Z",
  "organization": "my-org",
  "last_running_at": "2024-01-15T14:20:00Z",
  "last_warming_at": "2024-01-15T14:22:00Z",
  "environment_version": "v0.0.1-rc48"
}

Sprites

List Sprites

List all sprites for the authenticated organization

GET /sprites

Query Parameters

prefix? string

Filter sprites by name prefix

max_results? number

Maximum number of results (1-500, default: 50)

continuation_token? string

Token from previous response for pagination

Response Body

application/json
sprites* SpriteResponse[]

List of sprite resources

id* string

Unique sprite identifier

name* string

Sprite name within the organization

organization* string

Organization slug

url* string

Sprite HTTP endpoint URL

url_settings?

URL access configuration

auth* "sprite" | "public"

Authentication type

private_access? "admins" | "organization"

Who may access a sprite-authenticated URL.

status* "cold" | "warm" | "running"

Runtime status

created_at* string

Creation timestamp (ISO 8601)

updated_at* string

Last update timestamp (ISO 8601)

version? string

Version configured for or currently running on the sprite.

environment_version? string

Version of the sprite environment image.

last_running_at? string

When the sprite was last observed running (ISO 8601), null if not tracked

last_warming_at? string

When the sprite was last observed warming (ISO 8601), null if not tracked

labels? string

Labels assigned to the sprite. Omitted when empty.

has_more* boolean

Whether more results are available

next_continuation_token? string

Token for fetching the next page of results

running* number

Number of returned sprites currently running.

warm* number

Number of returned sprites currently warm.

cold* number

Number of returned sprites currently cold.

name* string

Organization slug.

running_limit? number

Organization-wide active sprite limit.

warm_limit? number

Organization-wide warm sprite limit.

Response Codes

200

Success
401

Missing or invalid authentication
bash 
curl -X GET \
  "https://api.sprites.dev/v1/sprites" \
  -H "Authorization: Bearer $SPRITES_TOKEN"
200 Response 
{
  "name": "my-org",
  "running": 1,
  "sprites": [
    {
      "id": "sprite-abc123",
      "name": "my-dev-sprite",
      "status": "running"
    }
  ],
  "next_continuation_token": "eyJsYXN0IjoibXktZGV2LXNwcml0ZSJ9",
  "warm": 2,
  "cold": 3,
  "running_limit": 10,
  "warm_limit": 10,
  "has_more": true
}

Sprites

Get Sprite

Get details for a specific sprite

GET /sprites/{name}

Path Parameters

name* string

Unique sprite name

Response Body

application/json
id* string

Unique sprite identifier

name* string

Sprite name within the organization

organization* string

Organization slug

url* string

Sprite HTTP endpoint URL

url_settings?

URL access configuration

auth* "sprite" | "public"

Authentication type

private_access? "admins" | "organization"

Who may access a sprite-authenticated URL.

status* "cold" | "warm" | "running"

Runtime status

created_at* string

Creation timestamp (ISO 8601)

updated_at* string

Last update timestamp (ISO 8601)

version? string

Version configured for or currently running on the sprite.

environment_version? string

Version of the sprite environment image.

last_running_at? string

When the sprite was last observed running (ISO 8601), null if not tracked

last_warming_at? string

When the sprite was last observed warming (ISO 8601), null if not tracked

labels? string

Labels assigned to the sprite. Omitted when empty.

Response Codes

200

Success
401

Missing or invalid authentication
404

Sprite not found
bash 
curl -X GET \
  "https://api.sprites.dev/v1/sprites/{name}" \
  -H "Authorization: Bearer $SPRITES_TOKEN"
200 Response 
{
  "id": "sprite-01234567-89ab-cdef-0123-456789abcdef",
  "name": "my-dev-sprite",
  "status": "cold",
  "version": "v0.0.1-rc48",
  "url": "https://name-random-alphanumeric.sprites.app",
  "labels": [
    "production"
  ],
  "url_settings": {
    "auth": "sprite"
  },
  "updated_at": "2024-01-15T14:22:00Z",
  "created_at": "2024-01-15T10:30:00Z",
  "organization": "my-org",
  "last_running_at": "2024-01-15T14:20:00Z",
  "last_warming_at": "2024-01-15T14:22:00Z",
  "environment_version": "v0.0.1-rc48"
}

Sprites

Destroy Sprite

Delete a sprite and all associated resources

DELETE /sprites/{name}

Path Parameters

name* string

Unique sprite name

Response Body

application/json

Response Codes

204

No content
401

Missing or invalid authentication
404

Sprite not found
bash 
curl -X DELETE \
  "https://api.sprites.dev/v1/sprites/{name}" \
  -H "Authorization: Bearer $SPRITES_TOKEN"
200 Response

Sprites

Update Sprite

Update sprite settings such as URL authentication

PUT /sprites/{name}

Path Parameters

name* string

Unique sprite name

Request Body

application/json
url_settings*

URL access configuration to update

auth? "sprite" | "public"

Authentication type (default: sprite)

Response Body

application/json
id* string

Unique sprite identifier

name* string

Sprite name within the organization

organization* string

Organization slug

url* string

Sprite HTTP endpoint URL

url_settings?

URL access configuration

auth* "sprite" | "public"

Authentication type

private_access? "admins" | "organization"

Who may access a sprite-authenticated URL.

status* "cold" | "warm" | "running"

Runtime status

created_at* string

Creation timestamp (ISO 8601)

updated_at* string

Last update timestamp (ISO 8601)

version? string

Version configured for or currently running on the sprite.

environment_version? string

Version of the sprite environment image.

last_running_at? string

When the sprite was last observed running (ISO 8601), null if not tracked

last_warming_at? string

When the sprite was last observed warming (ISO 8601), null if not tracked

labels? string

Labels assigned to the sprite. Omitted when empty.

Response Codes

200

Success
400

Invalid request parameters
401

Missing or invalid authentication
404

Sprite not found
bash 
curl -X PUT \
  "https://api.sprites.dev/v1/sprites/{name}" \
  -H "Authorization: Bearer $SPRITES_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url_settings":{"auth":"public"}}'
200 Response 
{
  "id": "sprite-01234567-89ab-cdef-0123-456789abcdef",
  "name": "my-dev-sprite",
  "status": "cold",
  "version": "v0.0.1-rc48",
  "url": "https://name-random-alphanumeric.sprites.app",
  "labels": [
    "production"
  ],
  "url_settings": {
    "auth": "sprite"
  },
  "updated_at": "2024-01-15T14:22:00Z",
  "created_at": "2024-01-15T10:30:00Z",
  "organization": "my-org",
  "last_running_at": "2024-01-15T14:20:00Z",
  "last_warming_at": "2024-01-15T14:22:00Z",
  "environment_version": "v0.0.1-rc48"
}