Resolve an app image API Reference

POST

/tenants/{tenant}/app-images/resolve

curl --request POST \
  --url https://api.kupe.cloud/api/v1/tenants/example/app-images/resolve \
  --header 'Authorization: <Authorization>' \
  --header 'Content-Type: application/json' \
  --data '{ "image": "nginxinc/nginx-unprivileged:1.27" }'

Resolve an image from an approved public registry or the tenant’s container registry to an immutable digest. The image must support linux/amd64 and set a non-root numeric USER. Answers 404 while the platform has apps switched off.

Authorizations

• BearerAuth

Parameters

Path Parameters

tenant

required

string

Tenant name

Request Body

Image to resolve

Media type application/json

object

image

string

Example

nginxinc/nginx-unprivileged:1.27

Responses

200

OK

Media type application/json

object

exposedPorts

Array<integer>

platforms

Array<object>

object

architecture

string

digest

Digest is the platform image’s digest (for a single image, its own).

string

os

string

variant

string

reference

string

user

string

Example

{
  "exposedPorts": [
    8080
  ],
  "platforms": [
    {
      "architecture": "amd64",
      "digest": "sha256:9a8b7c6d5e4f3a2b1c0d9e8f7a6b5c4d3e2f1a0b9c8d7e6f5a4b3c2d1e0f9a8b",
      "os": "linux",
      "variant": ""
    }
  ],
  "user": "101"
}

400

Bad Request

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

401

Unauthorized

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

403

Forbidden

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

404

Not Found

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

413

Request Entity Too Large

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

429

Too Many Requests

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

503

Service Unavailable

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}