{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"978b4d1f-0bda-4639-b5a8-a1ff201d7b48","name":"LetsCloud API","description":"## Introduction\n\nWith our API, you can easily perform actions or retrieve information from your instances and containers through HTTP requests to the endpoints described in this documentation.\n\n## Get Started\n\nFirst, you need to generate the token for authentication in the API. You can do this in the **profile** tab of your account, we'll show you how:\n\n![Enabling LetsCloud API](https://cm-static.letscloud.io/letscloud/enabling-letscloud-api.gif)\n\n\n## Requests\n\nThe API accepts that any tool make queries, for that it is necessary that the requests are made in HTTPS so that they are encrypted. It responds to different methods, let's see them:\n\n| **Method** | **Usage** |\n|------------|----------|\n| *GET* | For simple retrieval of information about your account and instances, you should use the GET method.<br>The information you request will be returned to you as a JSON object.<br> Any request using the GET method is read-only and will not affect any of the objects you are querying. |\n| *POST* | To create a new object, your request should specify the POST method.<br> The POST request includes all of the attributes necessary to create a new object. |\n| *PUT* | To update the information about a resource in your account, the PUT method is available.<br> It sets the state of the target using the provided values, regardless of their current values. |\n| *DELETE* | To destroy a resource and remove it from your account and environment, the DELETE method should be used.<br> This will remove the specified object if it is found. If it is not found, the operation will return a response indicating that the object was not found. |\n\n## HTTP Statuses\n\nREST APIs use the Status-Line part of an HTTP response message to inform clients of their request’s overarching result. RFC 2616 defines the Status-Line syntax.\n\nLetsCould API will return a maximum of 5 responses divided into two groups:\n\n- Successful Requisitions:\n\t- All successful requests return **HTTP Status 200**.\n\n\n- Unsuccessful Requisitions:\n\t- Unsuccessful requests can return **HTTP Status 400**, **401**, **500** or **503**.\n\n\nThe table below shows in detail the definitions of each request:\n\n\n|Status HTTP| Description |\n|   :---:   |    :---:    |\n| *200 OK* | Standard response for successful HTTP requests. The actual response will depend on the request method used.<br> In a GET request, the response will contain an entity corresponding to the requested resource.<br> In a POST request, the response will contain an entity describing or containing the result of the action.           |\n| 400 Bad Request | The server cannot or will not process the request due to an apparent client error (e.g., malformed request syntax, size too large, invalid request message framing, or deceptive request routing).          |\n| *401 Unauthorized* | specifically for use when authentication is required and has failed or has not yet been provided. |\n| *500 Internal Server Error* | A generic error message, given when an unexpected condition was encountered and no more specific message is suitable. |\n| *503 Service Unavailable* | The server is currently unavailable (because it is overloaded or down for maintenance). Generally, this is a temporary state. |\n\n## Responses\n\nThe return of requests is in **JSON**, always with two properties, `success`, `message`.\n\n**Success example:**\n\n```json\n{\n\t\"success\": true,\n\t\"data\": { }\n}\n```\n\nor \n\n```json\n{\n\t\"success\": true,\n\t\"message\": 'string'\n}\n```\n\n**Error example:**\n\n```json\n{\n\t\"success\": false,\n\t\"message\": 'string'\n}\n```\n\n## Rate Limit\n\nRate limits determine how frequently you can call a particular endpoint. The number of requests that can be made through the API is currently limited to 5,000 per hour in total of 120,000 per day per API token.\n\nThis rate can vary per resource but the current value is returned in the HTTP headers of your request. For the most recent rate limiting of your requests please view the information in the headers of your response.\n\n## Endpoints\n\nThe stable HTTP endpoint for the latest version is:\n\n**{{url-core-api}}**\n\n## Version\n\n**Default version: v1**\n\nTo select the version of the endpoint just send the example below in the header. If you don't send a version, the default version is used.\n\n`application/vnd.letscloud.v1+json`","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"3701600","team":158459,"collectionId":"978b4d1f-0bda-4639-b5a8-a1ff201d7b48","publishedId":"RWEaw2n1","public":true,"publicUrl":"https://developers.letscloud.io","privateUrl":"https://go.postman.co/documentation/3701600-978b4d1f-0bda-4639-b5a8-a1ff201d7b48","customColor":{"top-bar":"04091A","right-sidebar":"343A40","highlight":"00A4E6"},"documentationLayout":"classic-double-column","version":"8.10.1","publishDate":"2019-09-05T22:33:30.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{},"logos":{}},"statusCode":200},"environments":[{"name":"PRODUCTION-API","id":"a5f5da0d-afba-4053-81db-d5a74a4de389","owner":"3701600","values":[{"key":"url-core-api","value":"https://core.letscloud.io/api","enabled":true},{"key":"token-core-api","value":"your-token-here","enabled":true}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/879f9cc796c1664df899d2283f8d0bfa952996159d349a805cb6ec056e18b8c5","favicon":"https://res.cloudinary.com/postman/image/upload/v1567618986/team/nqiqei9mzkgxnxkqlczs.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"PRODUCTION-API","value":"3701600-a5f5da0d-afba-4053-81db-d5a74a4de389"}],"canonicalUrl":"https://developers.letscloud.io/view/metadata/RWEaw2n1"}