Applications Management

post

Register External Apps or App Runners. This endpoint is used to register a brand new app, or to update an existing one with more Runners

Path parameters
environmentstringRequired
Body
namestringRequired

name should be unique, alphanumeric set of characters

Responses
200Success

No content

post
/api/v1/environments/{environment}/proxy/api/v1/apps/external
POST /api/v1/environments/{environment}/proxy/api/v1/apps/external HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 252

{
  "name": "text",
  "metadata": {
    "version": "text",
    "description": "text",
    "owner": "text",
    "appType": "text",
    "tags": [
      "text"
    ],
    "deployment": "text"
  },
  "input": [
    {
      "name": "text"
    }
  ],
  "output": [
    {
      "name": "text"
    }
  ],
  "runners": [
    {
      "url": "text",
      "name": "text",
      "healthCheckInterval": 1
    }
  ]
}

No content

delete

Remove External Apps. This action will remove the external app as well as all the instances of the App

Path parameters
environmentstringRequired
appNamestringRequired

The unique identifier for the app

Responses
200Success

No content

delete
/api/v1/environments/{environment}/proxy/api/v1/apps/external/{appName}
DELETE /api/v1/environments/{environment}/proxy/api/v1/apps/external/{appName} HTTP/1.1
Host: 
Accept: */*

No content

delete

Remove External App Runners. This action will remove the runners from its App

Path parameters
environmentstringRequired
appNamestringRequired

The unique identifier for the app

Body
runnersstring[] · min: 1Required

A list of runners urls

Responses
200Success

No content

delete
/api/v1/environments/{environment}/proxy/api/v1/apps/external/{appName}/runners
DELETE /api/v1/environments/{environment}/proxy/api/v1/apps/external/{appName}/runners HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 20

{
  "runners": [
    "text"
  ]
}

No content

put

Sets an application description. Will respond with a bad request if a blank description is supplied

Path parameters
environmentstringRequired
applicationIdstring · min: 1RequiredExample: application-id
Body
descriptionstring · min: 1Optional
Responses
204Success

No content

put
/api/v1/environments/{environment}/proxy/api/v1/apps/{applicationId}/description
PUT /api/v1/environments/{environment}/proxy/api/v1/apps/{applicationId}/description HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 48

{
  "description": "Aggregates distances by driver"
}

No content

get

Get applications tags filtered by a matching supplied query

Path parameters
environmentstringRequired
Query parameters
querystringOptional

Match tag by keyword

Example: user
Responses
200Success
application/json
get
/api/v1/environments/{environment}/proxy/api/v1/apps/tags
GET /api/v1/environments/{environment}/proxy/api/v1/apps/tags HTTP/1.1
Host: 
Accept: */*
{
  "tags": [
    "user-generated-content",
    "user-details",
    "testuser"
  ]
}
put

Annotates an application with a list of tags. Will respond with a bad request if tags are empty, contain whitespaces or ar longer than 255

Path parameters
environmentstringRequired
applicationIdstring · min: 1RequiredExample: application-id
Body
tagsstring[]Optional
Responses
204Success

No content

put
/api/v1/environments/{environment}/proxy/api/v1/apps/{applicationId}/tags
PUT /api/v1/environments/{environment}/proxy/api/v1/apps/{applicationId}/tags HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "tags": [
    "aggregation"
  ]
}

No content

Last updated

Was this helpful?