Create app

Install an app from an image, in the scope of one handle. It is a fresh instance — its own database, its own blobs, its own secret values — and it serves whatever release that image points at, now and after every later deploy.

post/api/apps/{handle}

Request

  • Base URL: https://reduck.ai
  • URL: https://reduck.ai/api/apps/{handle}
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

handlestring required

The owner a resource is addressed under: "@username" for a personal scope, or a bare slug for a project.

Request body

namestring

A display name. Apps are addressed by id, so this is free to change and two apps may share one.

configobject

Settings to start from, merged over the image's authored defaults.

secretsobject

Values for the secrets the image's grant refers to by name. Sealed on the way in and never readable again; each one is closed to the page until opened.

Response

Created

idstring required
namestring required

The installer's label, and the only text an app has of its own: what the thing IS belongs to the image, which is where a listing reads its description from.

current_releasenumber nullable required

The release this app is actually serving: the newest one of its image whose migrations have all run against this app's own database. Behind image.current_release means an update has not landed here yet.

released_atstring nullable required

When the served release was deployed, null while there is none.

pending_decisionsnumber required

How many of the app's decisions are waiting for a ruling.

created_atstring required
updated_atstring required
configunknown required
api_grantunknown required
release_countnumber required

How many releases the IMAGE has shipped. An app has none of its own.

Changes

No recorded changes to this operation across all 1 revision of this API.