Upload files to your CARTO account and manipulate them by using a set of HTTP commands.

This component is still under support but it will not be further developed. We don’t recommend starting new projects with it as it will eventually become deprecated. Instead, learn more about our new APIs here

General Concepts

The following concepts are the same for every endpoint in the API except when it is noted explicitly.

Auth

Manipulating data on a CARTO account requires prior authentication using a unique identifier as a password. For the import API, a special identifier known as the API Key is used as a proof of authentication for each user account to authorize access to its data.

To execute an authorized request, api_key=YOURAPIKEY should be added to the request URL. This parameter can be also passed as a POST parameter. We strongly advise using HTTPS when you are performing requests that include your api_key.


Errors

Errors are reported using standard HTTP codes and extended information encoded in the HTML language, as shown in the following example:

1
2
3
4
5
6
7
8
9
10
11
12
<html>
  <head>
    <title>411 Length Required</title>
  </head>
  <body bgcolor="white">
    <center>
      <h1>411 Length Required</h1>
    </center>
    <hr>
    <center>nginx</center>
  </body>
</html>

Depending on the specific case, additional information regarding the error may be presented. See support section for details about known error codes and solutions.