Base images

A base image is the starting disk that an instance is created from — a chunked ext4 filesystem stored in object storage, addressable by id or by family + version. New instances either pin a specific base_image_id or pick a base_image_family (latest version of that family).

Firecase ships a default set of families: base, python, rust, node, deepcontext. Each family is independently versioned and can be rolled back.

Endpoints

• GET /v1/base-images — list all images
• GET /v1/base-images/:id — read one
• DELETE /v1/base-images/:id — delete a specific version
• GET /v1/base-images/default — the org-default image new instances inherit

Family operations

• GET /v1/base-images/family/:family — current image for a family
• GET /v1/base-images/family/:family/versions — every version of a family
• POST /v1/base-images/family/:family/rollback — promote a prior version to current

Related

• Instances — created from a base image
• Custom base images guide — building and publishing your own