Application

The "Application" section allows the management of application resources, providing endpoints for creating, deleting, updating, and retrieving application details. It also includes a "DNS" subsection for verifying correct DNS configuration during application creation.

Applications can only be created with the Kraud.Cloud provider. Only Next Cloud can be created at this time.

Create app

POST {{BASE_URL}}/api/apps

Application Creation. Currently, only Next Cloud can be created.

Path Parameters

Name	Type	Description
team*	String	Team ID
project*	String	Project ID

Headers

Name	Type	Description
Authorization*	String	Bearer Token

Request Body

Name	Type	Description
app*	Object

201: Created

{
    "region": {
        "datacenter": {
            "name": "berlin",
            "displayName": "Berlin"
        },
        "physicalLocation": "Germany"
    },
    "image": {
        "version": {
            "name": "nextcloud_latest",
            "displayName": "latest"
        },
        "distribution": "Nextcloud"
    },
    "status": 0,
    "urlAddress": "",
    "attestationId": "",
    "_id": "6548c71a984ffc044f8ebc41",
    "name": "kraud-cloud-nextcloud-berlin-01",
    "provider": "6548a383e2442d14b6bf968d",
    "size": "6548a383e2442d14b6bf973e",
    "price": "6548a383e2442d14b6bf96fc",
    "project": "6548a41f38406c14db33b62c",
    "team": "6548a41f38406c14db33b61e",
    "createdAt": "2023-11-06T10:59:38.121Z",
    "updatedAt": "2023-11-06T10:59:38.121Z"
}

Request payload

{
    "team": "6548a41f38406c14db33b61e",
    "project": "6548a41f38406c14db33b62c",
    "name": "kraud-cloud-nextcloud-berlin-01",
    "provider": "6548a383e2442d14b6bf968d",
    "cloudProvider": "6548a383e2442d14b6bf9685",
    "region": {
        "physicalLocation": "Germany",
        "datacenter": {
            "name": "berlin",
            "displayName": "Berlin"
        }
    },
    "image": {
        "distribution": "Nextcloud",
        "version": {
            "name": "nextcloud_latest",
            "displayName": "latest"
        }
    },
    "type": "nextCloud",
    "size": "6548a383e2442d14b6bf973e",
    "price": "6548a383e2442d14b6bf96fc",
    "domainName": "m4rgdmtr.1d.pt",
}

---

Get apps

GET {{BASE_URL}}/api/teams/{team}/projects/{project}/apps

Get all active applications for a specific project.

Path Parameters

Name	Type	Description
team*	String	Team ID
project*	String	Project ID

Headers

Name	Type	Description
Authorization*	String	Bearer Token

200: OK

[
    {
        "_id": "6548d4f261cabb0308b984ee",
        "region": {
            "datacenter": {
                "name": "berlin",
                "displayName": "Berlin"
            },
            "physicalLocation": "Germany"
        },
        "image": {
            "version": {
                "name": "nextcloud_latest",
                "displayName": "latest"
            },
            "distribution": "Nextcloud"
        },
        "status": 0,
        "urlAddress": "",
        "attestationId": "",
        "name": "kraud-cloud-nextcloud-berlin-01",
        "provider": {
            "_id": "6548a383e2442d14b6bf968d",
            "type": "app",
            "isDisabled": false,
            "cloudProvider": {
                "_id": "6548a383e2442d14b6bf9685",
                "name": "Kraud.Cloud",
                "isDisabled": false
            }
        },
        "size": {
            "_id": "6548a383e2442d14b6bf973e",
            "provider": "6548a383e2442d14b6bf968d",
            "location": "berlin",
            "name": "Standart_berlin_1_1_500",
            "vCPUs": 1,
            "memoryGB": 1,
            "spaceGB": 500,
            "group": 0
        },
        "price": {
            "_id": "6548a383e2442d14b6bf96fc",
            "provider": "6548a383e2442d14b6bf968d",
            "locationName": "berlin",
            "sizeName": "Standart_berlin_1_1_500",
            "imageName": "Nextcloud",
            "pricePerHour": 0.0694,
            "pricePerMonth": 50,
            "currencyCode": "EUR",
            "createdAt": "2023-11-06T08:27:47.132Z",
            "updatedAt": "2023-11-06T08:27:47.132Z"
        },
        "owner": "6548a41138406c14db33b606",
        "project": "6548a41f38406c14db33b62c",
        "team": "6548a41f38406c14db33b61e",
        "createdAt": "2023-11-06T11:58:42.399Z",
        "updatedAt": "2023-11-06T11:58:42.399Z",
        "attestation": null
    }
]

Get app by ID

GET {{BASE_URL}}/api/apps/{id}

Get a specific application by unique id.

Path Parameters

Name	Type	Description
id*	String	App ID

Headers

Name	Type	Description
Authorization*	String	Bearer Token

200: OK

{
    "_id": "6548d4f261cabb0308b984ee",
    "region": {
        "datacenter": {
            "name": "berlin",
            "displayName": "Berlin"
        },
        "physicalLocation": "Germany"
    },
    "image": {
        "version": {
            "name": "nextcloud_latest",
            "displayName": "latest"
        },
        "distribution": "Nextcloud"
    },
    "status": 2,
    "urlAddress": "",
    "attestationId": "f7c3d3a8-8593-4516-8b77-0a72e6cce330",
    "name": "kraud-cloud-nextcloud-berlin-01",
    "provider": {
        "_id": "6548a383e2442d14b6bf968d",
        "type": "app",
        "isDisabled": false,
        "cloudProvider": {
            "_id": "6548a383e2442d14b6bf9685",
            "name": "Kraud.Cloud",
            "isDisabled": false
        }
    },
    "size": {
        "_id": "6548a383e2442d14b6bf973e",
        "provider": "6548a383e2442d14b6bf968d",
        "location": "berlin",
        "name": "Standart_berlin_1_1_500",
        "vCPUs": 1,
        "memoryGB": 1,
        "spaceGB": 500,
        "group": 0
    },
    "price": {
        "_id": "6548a383e2442d14b6bf96fc",
        "provider": "6548a383e2442d14b6bf968d",
        "locationName": "berlin",
        "sizeName": "Standart_berlin_1_1_500",
        "imageName": "Nextcloud",
        "pricePerHour": 0.0694,
        "pricePerMonth": 50,
        "currencyCode": "EUR",
        "createdAt": "2023-11-06T08:27:47.132Z",
        "updatedAt": "2023-11-06T08:27:47.132Z"
    },
    "owner": "6548a41138406c14db33b606",
    "project": {
        "_id": "6548a41f38406c14db33b62c",
        "name": "first-project",
        "description": "Update your project information under Settings",
        "environment": "Development",
        "purpose": "Just trying out Enclaive",
        "isDefault": false,
        "icon": 1,
        "owner": "6548a41138406c14db33b606",
        "team": "6548a41f38406c14db33b61e",
        "createdAt": "2023-11-06T08:30:23.552Z",
        "updatedAt": "2023-11-06T08:30:23.552Z"
    },
    "team": {
        "_id": "6548a41f38406c14db33b61e",
        "name": "My Team",
        "email": "[e-mail]",
        "members": [
            {
                "user": "6548a41138406c14db33b606",
                "role": 0
            }
        ],
        "createdAt": "2023-11-06T08:30:23.529Z",
        "updatedAt": "2023-11-06T12:56:06.337Z",
        "billingSettings": "6548e2660919dc0442dc2ec7"
    },
    "createdAt": "2023-11-06T11:58:42.399Z",
    "updatedAt": "2023-11-06T12:04:48.200Z",
    "deletedAt": "2023-11-06T12:04:48.199Z"
}

Delete app by ID

DELETE {{BASE_URL}}/api/apps/{id}

Delete a specific application by unique id.

Path Parameters

Name	Type	Description
id*	String	App ID

Headers

Name	Type	Description
Authorization*	String	Bearer Token

200: OK

{"message":"App deleted","appId":"6548d4f261cabb0308b984ee"}