Hand an app over from the App controller to its cluster's agent: its next run goes through the agent, which adopts the app's workloads in place (no new pods), and every later run follows. Only toward the agent; the cluster needs a linked agent that carries applications.

POST

/api/v1/projects/{project}/environments/{environment}/apps/{app}/handover

const url = 'https://example.com/api/v1/projects/example/environments/example/apps/example/handover';
const options = {method: 'POST'};

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

curl --request POST \
  --url https://example.com/api/v1/projects/example/environments/example/apps/example/handover

Parameters

Path Parameters

project

required

string

Project name

environment

required

string

Environment short name

app

required

string

App name

Responses

202

Handover scheduled

404

application/json

Problem Details body.

object

code

required

Stable machine-readable code, e.g. forbidden.

string

title

required

Short human readable title.

string

status

required

HTTP status.

integer format: int32

detail

Details, if safe to expose.

string | null

Example

{
  "code": "forbidden"
}

409

Delivered by the agent already, being deleted, or no agent to take it

application/json

Problem Details body.

object

code

required

Stable machine-readable code, e.g. forbidden.

string

title

required

Short human readable title.

string

status

required

HTTP status.

integer format: int32

detail

Details, if safe to expose.

string | null

Example

{
  "code": "forbidden"
}