> For the complete documentation index, see [llms.txt](https://docs.carto.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.carto.com/carto-for-developers.md).

# CARTO for Developers

- [Overview](https://docs.carto.com/carto-for-developers/overview.md)
- [Key concepts](https://docs.carto.com/carto-for-developers/key-concepts.md)
- [Architecture](https://docs.carto.com/carto-for-developers/key-concepts/architecture.md)
- [Libraries and APIs](https://docs.carto.com/carto-for-developers/key-concepts/apis.md): The set of tools you will use to develop custom applications with CARTO
- [Authentication methods](https://docs.carto.com/carto-for-developers/key-concepts/authentication-methods.md)
- [API Access Tokens](https://docs.carto.com/carto-for-developers/key-concepts/authentication-methods/api-access-tokens.md)
- [OAuth Access Tokens](https://docs.carto.com/carto-for-developers/key-concepts/authentication-methods/oauth-access-tokens.md)
- [OAuth Clients](https://docs.carto.com/carto-for-developers/key-concepts/authentication-methods/applications.md)
- [Connections](https://docs.carto.com/carto-for-developers/key-concepts/connections.md)
- [Data sources](https://docs.carto.com/carto-for-developers/key-concepts/data-sources.md)
- [Visualization with deck.gl](https://docs.carto.com/carto-for-developers/key-concepts/carto-for-deck.gl.md)
- [Basemaps](https://docs.carto.com/carto-for-developers/key-concepts/carto-for-deck.gl/basemaps.md): CARTO is basemap-agnostic and is compatible with MapLibre, Google Maps, Amazon Location and Mapbox GL.
- [CARTO Basemap](https://docs.carto.com/carto-for-developers/key-concepts/carto-for-deck.gl/basemaps/carto-basemap.md)
- [Google Maps](https://docs.carto.com/carto-for-developers/key-concepts/carto-for-deck.gl/basemaps/carto-google-maps.md)
- [Examples](https://docs.carto.com/carto-for-developers/key-concepts/carto-for-deck.gl/basemaps/carto-google-maps/readme-1.md)
- [Gallery](https://docs.carto.com/carto-for-developers/key-concepts/carto-for-deck.gl/basemaps/carto-google-maps/readme-1/gallery.md)
- [Getting Started](https://docs.carto.com/carto-for-developers/key-concepts/carto-for-deck.gl/basemaps/carto-google-maps/readme-1/getting-started.md)
- [Basic Examples](https://docs.carto.com/carto-for-developers/key-concepts/carto-for-deck.gl/basemaps/carto-google-maps/readme-1/basic-examples.md)
- [Hello World](https://docs.carto.com/carto-for-developers/key-concepts/carto-for-deck.gl/basemaps/carto-google-maps/readme-1/basic-examples/hello-world.md)
- [BigQuery Tileset Layer](https://docs.carto.com/carto-for-developers/key-concepts/carto-for-deck.gl/basemaps/carto-google-maps/readme-1/basic-examples/bigquery-tileset-layer.md)
- [Data Observatory Tileset Layer](https://docs.carto.com/carto-for-developers/key-concepts/carto-for-deck.gl/basemaps/carto-google-maps/readme-1/basic-examples/data-observatory-tileset-layer.md)
- [Advanced Examples](https://docs.carto.com/carto-for-developers/key-concepts/carto-for-deck.gl/basemaps/carto-google-maps/readme-1/advanced-examples.md)
- [Arc Layer](https://docs.carto.com/carto-for-developers/key-concepts/carto-for-deck.gl/basemaps/carto-google-maps/readme-1/advanced-examples/arc-layer.md)
- [Extrusion](https://docs.carto.com/carto-for-developers/key-concepts/carto-for-deck.gl/basemaps/carto-google-maps/readme-1/advanced-examples/extrusion.md)
- [Trips Layer](https://docs.carto.com/carto-for-developers/key-concepts/carto-for-deck.gl/basemaps/carto-google-maps/readme-1/advanced-examples/trips-layer.md)
- [What's New](https://docs.carto.com/carto-for-developers/key-concepts/carto-for-deck.gl/basemaps/carto-google-maps/whats-new.md)
- [Amazon Location](https://docs.carto.com/carto-for-developers/key-concepts/carto-for-deck.gl/basemaps/carto-amazon-location.md)
- [Examples](https://docs.carto.com/carto-for-developers/key-concepts/carto-for-deck.gl/basemaps/carto-amazon-location/readme-1.md)
- [Hello World](https://docs.carto.com/carto-for-developers/key-concepts/carto-for-deck.gl/basemaps/carto-amazon-location/readme-1/hello-world.md)
- [CartoLayer](https://docs.carto.com/carto-for-developers/key-concepts/carto-for-deck.gl/basemaps/carto-amazon-location/readme-1/cartolayer.md)
- [What's New](https://docs.carto.com/carto-for-developers/key-concepts/carto-for-deck.gl/basemaps/carto-amazon-location/whats-new.md)
- [Charts and widgets](https://docs.carto.com/carto-for-developers/key-concepts/charts-and-widgets.md)
- [Filtering and interactivity](https://docs.carto.com/carto-for-developers/key-concepts/filtering-and-interactivity.md)
- [AI-powered map interaction](https://docs.carto.com/carto-for-developers/key-concepts/ai-powered-map-interaction.md)
- [Integrating Builder maps in your application](https://docs.carto.com/carto-for-developers/key-concepts/rapid-map-prototyping.md)
- [Hosted Apps](https://docs.carto.com/carto-for-developers/key-concepts/hosting-your-application.md): Let CARTO host and serve your application behind your organization's login
- [Summary](https://docs.carto.com/carto-for-developers/key-concepts/summary.md)
- [Quickstart](https://docs.carto.com/carto-for-developers/quickstart.md)
- [Make your first API call](https://docs.carto.com/carto-for-developers/quickstart/how-to-make-my-first-api-call.md)
- [Visualize your first dataset](https://docs.carto.com/carto-for-developers/quickstart/visualize-your-first-dataset.md)
- [Create your first widget](https://docs.carto.com/carto-for-developers/quickstart/create-your-first-widget.md)
- [Hosting your first application](https://docs.carto.com/carto-for-developers/quickstart/hosting-your-first-application.md): Deploy a one-file application to CARTO and open it with your CARTO login
- [Guides](https://docs.carto.com/carto-for-developers/guides.md)
- [Build a public application](https://docs.carto.com/carto-for-developers/guides/build-a-public-application.md): Create a basic web application in CARTO compatible with any Javascript Framework
- [Build a private application](https://docs.carto.com/carto-for-developers/guides/build-a-private-application.md): How to build a basic private application with CARTO login
- [Build a private application using SSO](https://docs.carto.com/carto-for-developers/guides/build-a-private-application-using-sso.md): Use your company's identity management system to seamlessly control access to your application
- [Hosting your application in CARTO](https://docs.carto.com/carto-for-developers/guides/build-a-hosted-application.md): Build an application that CARTO hosts and serves behind your organization's login
- [Visualize massive datasets](https://docs.carto.com/carto-for-developers/guides/visualize-massive-datasets.md): Learn how to visualize massive datasets in a performance and cost-effective way (up to billions of rows)
- [Integrate CARTO in your existing application](https://docs.carto.com/carto-for-developers/guides/integrate-carto-in-your-existing-application.md): Learn how to securely embed CARTO into your existing architecture providing fine-grained data access
- [Use Boundaries in your application](https://docs.carto.com/carto-for-developers/guides/use-boundaries-in-your-application.md)
- [Avoid exposing SQL queries with Named Sources](https://docs.carto.com/carto-for-developers/guides/avoid-exposing-sql-queries-with-named-sources.md): Maintain a lightweight, modern and efficient architecture while avoiding the exposure of SQL queries in your application
- [Managing cache in your CARTO applications](https://docs.carto.com/carto-for-developers/guides/managing-cache-in-your-carto-applications.md)
- [Build an AI-powered map application](https://docs.carto.com/carto-for-developers/guides/build-an-ai-powered-map-application.md): Add natural language map interaction to your CARTO + deck.gl application using AI-powered tool calling
- [Reference](https://docs.carto.com/carto-for-developers/reference.md)
- [Data Sources](https://docs.carto.com/carto-for-developers/reference/data-sources.md)
- [vectorTableSource](https://docs.carto.com/carto-for-developers/reference/data-sources/vectortablesource.md)
- [vectorQuerySource](https://docs.carto.com/carto-for-developers/reference/data-sources/vectorquerysource.md)
- [vectorTilesetSource](https://docs.carto.com/carto-for-developers/reference/data-sources/vectortilesetsource.md)
- [h3TableSource](https://docs.carto.com/carto-for-developers/reference/data-sources/h3tablesource.md)
- [h3QuerySource](https://docs.carto.com/carto-for-developers/reference/data-sources/h3querysource.md)
- [h3TilesetSource](https://docs.carto.com/carto-for-developers/reference/data-sources/h3tilesetsource.md)
- [quadbinTableSource](https://docs.carto.com/carto-for-developers/reference/data-sources/quadbintablesource.md)
- [quadbinQuerySource](https://docs.carto.com/carto-for-developers/reference/data-sources/quadbinquerysource.md)
- [quadbinTilesetSource](https://docs.carto.com/carto-for-developers/reference/data-sources/quadbintilesetsource.md)
- [rasterSource](https://docs.carto.com/carto-for-developers/reference/data-sources/rastersource.md)
- [boundaryTableSource](https://docs.carto.com/carto-for-developers/reference/data-sources/boundarytablesource.md)
- [boundaryQuerySource](https://docs.carto.com/carto-for-developers/reference/data-sources/boundaryquerysource.md)
- [Widgets](https://docs.carto.com/carto-for-developers/reference/carto-widgets-reference.md)
- [Data Sources](https://docs.carto.com/carto-for-developers/reference/carto-widgets-reference/data-sources.md)
- [Server-side vs. client-side](https://docs.carto.com/carto-for-developers/reference/carto-widgets-reference/server-side-vs.-client-side.md)
- [Models](https://docs.carto.com/carto-for-developers/reference/carto-widgets-reference/models.md)
- [getFormula](https://docs.carto.com/carto-for-developers/reference/carto-widgets-reference/models/getformula.md)
- [getCategories](https://docs.carto.com/carto-for-developers/reference/carto-widgets-reference/models/getcategories.md)
- [getHistogram](https://docs.carto.com/carto-for-developers/reference/carto-widgets-reference/models/gethistogram.md)
- [getRange](https://docs.carto.com/carto-for-developers/reference/carto-widgets-reference/models/getrange.md)
- [getScatter](https://docs.carto.com/carto-for-developers/reference/carto-widgets-reference/models/getscatter.md)
- [getTimeSeries](https://docs.carto.com/carto-for-developers/reference/carto-widgets-reference/models/gettimeseries.md)
- [getTable](https://docs.carto.com/carto-for-developers/reference/carto-widgets-reference/models/gettable.md)
- [Filters](https://docs.carto.com/carto-for-developers/reference/filters.md)
- [Column filters](https://docs.carto.com/carto-for-developers/reference/filters/column-filters.md)
- [Spatial filters](https://docs.carto.com/carto-for-developers/reference/filters/spatial-filters.md)
- [fetchMap](https://docs.carto.com/carto-for-developers/reference/fetchmap.md)
- [@carto/agentic-deckgl](https://docs.carto.com/carto-for-developers/reference/agentic-deckgl.md)
- [Hosted Apps](https://docs.carto.com/carto-for-developers/reference/hosted-apps.md): The Hosted Apps contract, covering the manifest, the runtime, the bundle rules and the limits
- [App manifest (carto.json)](https://docs.carto.com/carto-for-developers/reference/hosted-apps/app-manifest.md): The carto.json file a hosted app ships to declare the Named Sources CARTO registers when it is deployed
- [Runtime and authentication](https://docs.carto.com/carto-for-developers/reference/hosted-apps/runtime-and-authentication.md): How a hosted app is opened, the carto-info.json contract, sessions, sharing and versions
- [Bundle requirements and limits](https://docs.carto.com/carto-for-developers/reference/hosted-apps/bundle-requirements-and-limits.md): What a valid hosted app bundle looks like, the limits CARTO enforces, and the headers and CSP it serves
- [Limitations](https://docs.carto.com/carto-for-developers/reference/hosted-apps/limitations.md): What Hosted Apps supports and does not support
- [CARTO API Reference](https://docs.carto.com/carto-for-developers/reference/carto-api.md): Reference for the CARTO API
- [Maps API](https://docs.carto.com/carto-for-developers/reference/carto-api/maps-api.md): Create map layers from queries, tables and tilesets.
- [SQL API](https://docs.carto.com/carto-for-developers/reference/carto-api/sql-api.md): Run SQL queries in your data warehouse.
- [Tokens API](https://docs.carto.com/carto-for-developers/reference/carto-api/tokens-api.md): Create and manage API Access Tokens.
- [Imports API](https://docs.carto.com/carto-for-developers/reference/carto-api/imports-api.md): Import geospatial files into your data warehouse.
- [Exports API](https://docs.carto.com/carto-for-developers/reference/carto-api/exports-api.md): Export tables and query results to a file.
- [Location Data Services API](https://docs.carto.com/carto-for-developers/reference/carto-api/lds-api.md): Geocoding, isolines and routing.
- [Named Sources API](https://docs.carto.com/carto-for-developers/reference/carto-api/named-sources-api.md): Server-side aliases for SQL queries.
- [Resources API](https://docs.carto.com/carto-for-developers/reference/carto-api/resources-api.md): Manage maps, workflows and connections.
- [Connections](https://docs.carto.com/carto-for-developers/reference/carto-api/resources-api/connections.md): Manage connections to your data warehouses.
- [Maps and workflows](https://docs.carto.com/carto-for-developers/reference/carto-api/resources-api/maps-and-workflows.md): List and delete the maps and workflows you can access.
- [Organization resources](https://docs.carto.com/carto-for-developers/reference/carto-api/resources-api/organization-resources.md): Administer every resource in the organization.
- [Activity Data API](https://docs.carto.com/carto-for-developers/reference/carto-api/activity-data-api.md): Export activity and API usage data.
- [Release Notes](https://docs.carto.com/carto-for-developers/release-notes.md)
- [Examples](https://docs.carto.com/carto-for-developers/examples.md)
- [CARTO for React](https://docs.carto.com/carto-for-developers/carto-for-react.md)
- [Guides](https://docs.carto.com/carto-for-developers/carto-for-react/guides.md)
- [Getting Started](https://docs.carto.com/carto-for-developers/carto-for-react/guides/getting-started.md)
- [Views](https://docs.carto.com/carto-for-developers/carto-for-react/guides/views.md)
- [Data Sources](https://docs.carto.com/carto-for-developers/carto-for-react/guides/data-sources.md)
- [Layers](https://docs.carto.com/carto-for-developers/carto-for-react/guides/layers.md)
- [Widgets](https://docs.carto.com/carto-for-developers/carto-for-react/guides/widgets.md)
- [Authentication and Authorization](https://docs.carto.com/carto-for-developers/carto-for-react/guides/authentication-and-authorization.md)
- [Basemaps](https://docs.carto.com/carto-for-developers/carto-for-react/guides/basemaps.md)
- [Look and Feel](https://docs.carto.com/carto-for-developers/carto-for-react/guides/look-and-feel.md)
- [Query Parameters](https://docs.carto.com/carto-for-developers/carto-for-react/guides/query-parameters.md)
- [Code Generator](https://docs.carto.com/carto-for-developers/carto-for-react/guides/code-generator.md)
- [Sample Applications](https://docs.carto.com/carto-for-developers/carto-for-react/guides/sample-applications.md)
- [Deployment](https://docs.carto.com/carto-for-developers/carto-for-react/guides/deployment.md)
- [Upgrade Guide](https://docs.carto.com/carto-for-developers/carto-for-react/guides/upgrade-guide.md)
- [Examples](https://docs.carto.com/carto-for-developers/carto-for-react/examples.md)
- [Library Reference](https://docs.carto.com/carto-for-developers/carto-for-react/library-reference.md)
- [Introduction](https://docs.carto.com/carto-for-developers/carto-for-react/library-reference/introduction.md)
- [API](https://docs.carto.com/carto-for-developers/carto-for-react/library-reference/api.md)
- [Auth](https://docs.carto.com/carto-for-developers/carto-for-react/library-reference/auth.md)
- [Basemaps](https://docs.carto.com/carto-for-developers/carto-for-react/library-reference/basemaps.md)
- [Core](https://docs.carto.com/carto-for-developers/carto-for-react/library-reference/core.md)
- [Redux](https://docs.carto.com/carto-for-developers/carto-for-react/library-reference/redux.md)
- [UI](https://docs.carto.com/carto-for-developers/carto-for-react/library-reference/ui.md)
- [Widgets](https://docs.carto.com/carto-for-developers/carto-for-react/library-reference/widgets.md)
- [Release Notes](https://docs.carto.com/carto-for-developers/carto-for-react/release-notes.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.carto.com/carto-for-developers.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.