Team

The "Team" section includes endpoints for team management and all associated information. It serves as the central hub for handling teams, offering functions like team creation, modification, and access to all team-related data.

The user must set the current command to pass validation when performing actions. It is important to note that if a user is a member of a command, but it is not marked as current for that user, the user will not be able to perform any actions in it. Typically this item is used to switch between the user's commands.

Set current team

POST {{BASE_URL}}/api/teams/current

Assign the user to their active team, allowing them to collaborate within that specific team's context

Headers

Name	Type	Description
Authorization*	String	Bearer Token

Request Body

Name	Type	Description
teamId*	String	Team ID

200: OK

{
    "userToken": "eyJ0eXAiOiJqd3QiLCJhbGciOiJFUzI1NiIsImtpZCI6IlBWdjZpMjBBNEZmdXJXVWtKRkYzMUV5WW5sdnJTVjFQRTNOUTI4TTUxLUUifQ.eyJhdWQiOiJlbmNsYWl2ZS1rZXlzdG9yZSIsImlzcyI6ImVuY2xhaXZlLWNvbnNvbGUiLCJzdWIiOiJlbmNsYWl2ZS1jdXN0b21lciIsImN1c3RvbWVyIjoiNjU0OGE0MTEzODQwNmMxNGRiMzNiNjA2IiwiZXhwIjoxNjk5NDM0NzczLCJpYXQiOjE2OTkzNDgzNzMsIm5iZiI6MTY5OTM0ODM3M30.chONgqM6AJeX5DvBUOGyq0PutoiEn5F7p3PiiP3JW5ugTQ9hk8zMlJKAdgVML-Y-qzaIhhRWFdb6pQaGmapdIQ",
    "vaultToken": "eyJ0eXAiOiJqd3QiLCJhbGciOiJFUzI1NiIsImtpZCI6IlBWdjZpMjBBNEZmdXJXVWtKRkYzMUV5WW5sdnJTVjFQRTNOUTI4TTUxLUUifQ.eyJhdWQiOiJlbmNsYWl2ZS1rZXlzdG9yZSIsImlzcyI6ImVuY2xhaXZlLWNvbnNvbGUiLCJzdWIiOiJlbmNsYWl2ZS1jdXN0b21lciIsImN1c3RvbWVyIjoiNjU0OGE0MWYzODQwNmMxNGRiMzNiNjFlIiwiZXhwIjoxNjk5NDM0NzczLCJpYXQiOjE2OTkzNDgzNzMsIm5iZiI6MTY5OTM0ODM3M30.CdVESfmO46Aczw0jufmDs9eKx1c1t06zn_pRC3m6_l69aQpe_mrE-ZnMkNfsklKvbHanrauujE2trmaVW9AAYw"
}

Get current team

GET {{BASE_URL}}/api/teams/current

Retrieve information about the user's currently active team, enabling them to access and interact with their team's resources.

Headers

Name	Type	Description
Authorization*	String	Bearer Token

200: OK

{
    "_id": "6548a41f38406c14db33b61e",
    "name": "My Team",
    "email": "[e-mail]",
    "members": [
        {
            "user": {
                "_id": "6548a41138406c14db33b606",
                "status": 0,
                "name": "John Doe",
                "email": "[e-mail]"
            },
            "role": 0
        }
    ],
    "createdAt": "2023-11-06T08:30:23.529Z",
    "updatedAt": "2023-11-06T12:56:06.337Z",
    "billingSettings": "6548e2660919dc0442dc2ec7",
    "quotas": [
        {
            "_id": "6548a41f38406c14db33b624",
            "cloudProvider": "6548a383e2442d14b6bf9681",
            "apps": {
                "nextCloud": 0,
                "gitlab": 0
            },
            "databases": {
                "mongo": 0,
                "postgres": 0,
                "maria": 0,
                "redis": 0
            },
            "vm": 4,
            "k8s": {
                "masterNode": 2,
                "workerNode": 2
            },
            "createdAt": "2023-11-06T08:27:47.146Z",
            "updatedAt": "2023-11-06T08:27:47.146Z",
            "team": "6548a41f38406c14db33b61e"
        },
        {
            "_id": "6548a41f38406c14db33b625",
            "cloudProvider": "6548a383e2442d14b6bf9682",
            "apps": {
                "nextCloud": 0,
                "gitlab": 0
            },
            "databases": {
                "mongo": 0,
                "postgres": 0,
                "maria": 0,
                "redis": 0
            },
            "vm": 4,
            "k8s": {
                "masterNode": 2,
                "workerNode": 2
            },
            "createdAt": "2023-11-06T08:27:47.146Z",
            "updatedAt": "2023-11-06T08:27:47.146Z",
            "team": "6548a41f38406c14db33b61e"
        },
        {
            "_id": "6548a41f38406c14db33b626",
            "cloudProvider": "6548a383e2442d14b6bf9683",
            "apps": {
                "nextCloud": 0,
                "gitlab": 0
            },
            "databases": {
                "mongo": 0,
                "postgres": 0,
                "maria": 0,
                "redis": 0
            },
            "vm": 4,
            "k8s": {
                "masterNode": 2,
                "workerNode": 2
            },
            "createdAt": "2023-11-06T08:27:47.146Z",
            "updatedAt": "2023-11-06T08:27:47.146Z",
            "team": "6548a41f38406c14db33b61e"
        },
        {
            "_id": "6548a41f38406c14db33b627",
            "cloudProvider": "6548a383e2442d14b6bf9684",
            "apps": {
                "nextCloud": 0,
                "gitlab": 0
            },
            "databases": {
                "mongo": 0,
                "postgres": 0,
                "maria": 0,
                "redis": 0
            },
            "vm": 4,
            "k8s": {
                "masterNode": 2,
                "workerNode": 2
            },
            "createdAt": "2023-11-06T08:27:47.146Z",
            "updatedAt": "2023-11-06T08:27:47.146Z",
            "team": "6548a41f38406c14db33b61e"
        },
        {
            "_id": "6548a41f38406c14db33b628",
            "cloudProvider": "6548a383e2442d14b6bf9685",
            "apps": {
                "nextCloud": 4,
                "gitlab": 4
            },
            "databases": {
                "mongo": 4,
                "postgres": 4,
                "maria": 4,
                "redis": 4
            },
            "vm": 4,
            "k8s": {
                "masterNode": 2,
                "workerNode": 2
            },
            "createdAt": "2023-11-06T08:27:47.146Z",
            "updatedAt": "2023-11-06T08:27:47.146Z",
            "team": "6548a41f38406c14db33b61e"
        }
    ]
}

Get resources by team

GET {{BASE_URL}}/api/teams/{id}/resources

Get all active resources on a specific team.

Path Parameters

Name	Type	Description
id*	String	Team ID

Headers

Name	Type	Description
Authorization*	String	Bearer Token

200: OK

{
    "vms": [
        {
            "_id": "654a002170c99a149c791cb6",
            "name": "kraud-cloud-ubuntu-1vcpu-4gb-berlin-01",
            "type": "vm"
        }
    ],
    "dbs": [],
    "apps": []
}

When creating a new project, the user has the option of transferring previously created resources to the new project.

Move resources

POST {{BASE_URL}}/api/teams/{id}/move-resources

Transfer active resources (VMs, databases, applications, Kubernetes resources) from one project to another, providing flexibility in resource allocation.

Headers

Name	Type	Description
Authorization*	String	Bearer Token

Request Body

Name	Type	Description
data*	Object

200: OK

{"message":"ok"}

Request payload

{
    "project": "654a052370c99a149c791ce7",
    "resources": [
        {
            "_id": "654a002170c99a149c791cb6",
            "name": "kraud-cloud-ubuntu-1vcpu-4gb-berlin-01",
            "type": "vm"
        }
    ]
}

---

Get Team

GET {{BASE_URL}}/api/teams/{id}

Get information about a specific team.

Path Parameters

Name	Type	Description
id*	String	Team ID

Headers

Name	Type	Description
Authorization*	String	Bearer Token

200: OK

{
    "_id": "6549ff7ce58641429600ac91",
    "name": "DEV Team",
    "email": "[e-mail]",
    "members": [
        {
            "user": {
                "_id": "6548a41138406c14db33b606",
                "status": 0,
                "name": "John Doe",
                "email": "[e-mail]"
            },
            "role": 0
        }
    ],
    "createdAt": "2023-11-06T08:30:23.529Z",
    "updatedAt": "2023-11-06T12:56:06.337Z",
    "billingSettings": "6548e2660919dc0442dc2ec7"
}

Updated Team

PUT {{BASE_URL}}/api/teams/{id}

Update details and information about a specific team, ensuring accurate and up-to-date team information.

Path Parameters

Name	Type	Description
id*	String	Team ID

Headers

Name	Type	Description
Authorization*	String	Bearer Token

200: OK

{
    "_id": "6549ff7ce58641429600ac91",
    "name": "DEV Team1",
    "email": "[e-mail]",
    "members": [
        {
            "user": {
                "_id": "6548a41138406c14db33b606",
                "name": "John Doe",
                "email": "[e-mail]"
            },
            "role": 0
        }
    ],
    "createdAt": "2023-11-06T08:30:23.529Z",
    "updatedAt": "2023-11-07T09:41:38.504Z",
    "billingSettings": "6548e2660919dc0442dc2ec7"
}

Delete Team

DELETE {{BASE_URL}}/api/teams/{id}

Delete a team. You can only delete a team if there are no active resources in the team.

Path Parameters

Name	Type	Description
id*	String	Team ID

Headers

Name	Type	Description
Authorization*	String	Bearer Token

200: OK

{"message":"Sorry, functionality in development..."}

Delete member

DELETE {{BASE_URL}}/api/teams/{id}/members/{memberId}

Deleting a team member. This can only be done by the team administrator

Path Parameters

Name	Type	Description
id*	String	Team ID
memberId*	String	User id

Headers

Name	Type	Description
Authorization*	String	Bearer Token

200: OK

{
    "name": "DEV Team1",
    "_id": "6549ff7ce58641429600ac91",
    "email": "[e-mail]",
    "members": [
        {
            "user": "6548a41138406c14db33b606",
            "role": 0
        }
    ],
    "createdAt": "2023-11-06T08:30:23.529Z",
    "updatedAt": "2023-11-07T09:55:26.348Z",
    "billingSettings": "6548e2660919dc0442dc2ec7"
}