The versions of an application

GET

/v1/apps/{app}/versions

const url = 'https://api.eu.apigami.com/v1/apps/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/versions?limit=100&offset=0';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.eu.apigami.com/v1/apps/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/versions?limit=100&offset=0' \
  --header 'Authorization: Bearer <token>'

Newest first. The first deployed one outside production is what the --staging address serves; the one with production: true is what everyone else calls.

Authorizations

personalAccessToken
agentToken

Parameters

Path Parameters

app

required

string format: uuid

Query Parameters

limit

integer

default: 100 >= 1 <= 100

offset

integer

Responses

200

The versions.

application/json

object

versions

required

Array<object>

Where one version stands. publish.next is the one sentence to act on.

object

version_id

required

string format: uuid

app_id

required

string format: uuid

base_version_id

string | null format: uuid

state

required

ready once written, deployed, pending_review, rejected, among others.

string

validation

required

object

status

string

Allowed values: valid invalid

errors

integer

diagnostics

Array<object>

object

code

required

string

file

required

string | null

pointer

required

A JSON pointer into the file.

string | null

message

required

The fix.

string

level

Present on a warning, which blocks nothing.

string

Allowed values: warning

version

The info.version of its manifest.

string | null

production

boolean

deployed

boolean

address

Where its pages answer, from the slug of its manifest.

object

production

string format: uri

staging

string format: uri

health

object

state

string | null

checked_at

string | null format: date-time

error

string | null

tried_at

When one of its actions first answered below 500 on its own deployment, which publication requires.

string | null format: date-time

publish

required

object

publishable

required

boolean

production

required

boolean

review_required

boolean

blockers

required

Array<object>

object

code

required

string

message

required

string

next

required

string

created_at

string format: date-time

published_at

string | null format: date-time

Example

{
  "versions": [
    {
      "validation": {
        "status": "valid",
        "diagnostics": [
          {
            "level": "warning"
          }
        ]
      }
    }
  ]
}

404

Not an application of your team.

application/json

object

error

required

string

consentPending

Present and true when the approval window is open and the user has not answered within 45 s.

boolean

Example

{
  "error": "not found"
}