Layers

APIs to visualize spatial data

Layers enable you to visualize, style and interact with your spatial data.

With these APIs, you can upload data, manage layer styling, publish and refresh live data layers.

Get map layer group

get

Retrieve detailed information about a specific layer group including its layers and configuration.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

map_idstringRequired

layer_group_idstringRequired

Responses

200

Layer Group

application/json

captionstring · nullableRequired

idstring · felt_idRequiredExample: luCHyMruTQ6ozGk3gPJfEB

legend_visibilitystring · enum · nullableOptional

Controls how the layer group is displayed in the legend. Defaults to "show".

Possible values:

namestringRequired

ordering_keyintegerOptional

A sort order key used for ordering layers and layer groups in the legend

subtitlestring · nullableOptionalDeprecated

Deprecated: use caption instead.

typestring · enumRequiredPossible values:

visibility_interactionstring · enumRequired

Controls how the layer group is displayed in the legend. Defaults to "default".

Possible values:

401

UnauthorizedError

application/json

403

UnauthorizedError

application/json

404

NotFoundError

application/json

422

Unprocessable Entity

application/json

429

Unprocessable Entity

application/json

500

InternalServerError

application/json

get/api/v2/maps/{map_id}/layer_groups/{layer_group_id}

HTTPcURLJavaScriptPython

GET /api/v2/maps/{map_id}/layer_groups/{layer_group_id} HTTP/1.1
Host: felt.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "caption": "text",
  "id": "luCHyMruTQ6ozGk3gPJfEB",
  "layers": [
    {
      "attributes": [
        {
          "name": "text",
          "type": "INTEGER"
        }
      ],
      "caption": "text",
      "geometry_type": "Line",
      "hide_from_legend": true,
      "id": "luCHyMruTQ6ozGk3gPJfEB",
      "is_spreadsheet": true,
      "last_refreshed_at": "2026-07-13T18:48:56.070Z",
      "legend_display": "default",
      "legend_visibility": "hide",
      "links": {
        "self": "https://felt.com/api/v2/maps/V0dnOMOuTd9B9BOsL9C0UjmqC/layers/k441enUxQUOnZqc1ZvNsDA"
      },
      "metadata": {
        "attribution_text": "text",
        "attribution_url": "text",
        "description": "text",
        "license": "text",
        "source_abbreviation": "text",
        "source_name": "text",
        "source_url": "text",
        "updated_at": "2025-03-24"
      },
      "name": "text",
      "next_refresh_at": "2026-07-13T18:48:56.070Z",
      "ordering_key": 1,
      "paused_reason": "consecutive_failures",
      "progress": 1,
      "refresh_period": "15 min",
      "refresh_status": "active",
      "status": "uploading",
      "style": {},
      "tile_url": "text",
      "type": "layer"
    }
  ],
  "legend_visibility": "hide",
  "links": {
    "self": "https://felt.com/api/v2/maps/V0dnOMOuTd9B9BOsL9C0UjmqC/layer_groups/v13k4Ae9BRjCHHdPP5Fcm6D"
  },
  "name": "text",
  "ordering_key": 1,
  "type": "layer_group",
  "visibility_interaction": "default"
}

Update map layer group

post

Update layer group properties including name, visibility, and organization settings.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

map_idstringRequired

layer_group_idstringRequired

Body

application/json

captionstringOptionalExample: A very interesting group

idstring · felt_idOptionalExample: luCHyMruTQ6ozGk3gPJfEB

legend_visibilitystring · enumOptional

Controls how the layer group is displayed in the legend

Possible values:

namestringOptionalExample: My Layer Group

ordering_keyintegerOptional

subtitlestringOptionalDeprecated

Deprecated: use caption instead.

visibility_interactionstring · enum · nullableOptional

Controls how the layer group is displayed in the legend. Defaults to "default".

Possible values:

Responses

200

LayerGroup

application/json

captionstring · nullableRequired

idstring · felt_idRequiredExample: luCHyMruTQ6ozGk3gPJfEB

legend_visibilitystring · enum · nullableOptional

Controls how the layer group is displayed in the legend. Defaults to "show".

Possible values:

namestringRequired

ordering_keyintegerOptional

A sort order key used for ordering layers and layer groups in the legend

subtitlestring · nullableOptionalDeprecated

Deprecated: use caption instead.

typestring · enumRequiredPossible values:

visibility_interactionstring · enumRequired

Controls how the layer group is displayed in the legend. Defaults to "default".

Possible values:

401

UnauthorizedError

application/json

403

UnauthorizedError

application/json

404

NotFoundError

application/json

422

Unprocessable Entity

application/json

429

Unprocessable Entity

application/json

500

InternalServerError

application/json

post/api/v2/maps/{map_id}/layer_groups/{layer_group_id}

HTTPcURLJavaScriptPython

POST /api/v2/maps/{map_id}/layer_groups/{layer_group_id} HTTP/1.1
Host: felt.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 171

{
  "caption": "A very interesting group",
  "id": "luCHyMruTQ6ozGk3gPJfEB",
  "legend_visibility": "hide",
  "name": "My Layer Group",
  "ordering_key": 1,
  "visibility_interaction": "default"
}

{
  "caption": "text",
  "id": "luCHyMruTQ6ozGk3gPJfEB",
  "layers": [
    {
      "attributes": [
        {
          "name": "text",
          "type": "INTEGER"
        }
      ],
      "caption": "text",
      "geometry_type": "Line",
      "hide_from_legend": true,
      "id": "luCHyMruTQ6ozGk3gPJfEB",
      "is_spreadsheet": true,
      "last_refreshed_at": "2026-07-13T18:48:56.070Z",
      "legend_display": "default",
      "legend_visibility": "hide",
      "links": {
        "self": "https://felt.com/api/v2/maps/V0dnOMOuTd9B9BOsL9C0UjmqC/layers/k441enUxQUOnZqc1ZvNsDA"
      },
      "metadata": {
        "attribution_text": "text",
        "attribution_url": "text",
        "description": "text",
        "license": "text",
        "source_abbreviation": "text",
        "source_name": "text",
        "source_url": "text",
        "updated_at": "2025-03-24"
      },
      "name": "text",
      "next_refresh_at": "2026-07-13T18:48:56.070Z",
      "ordering_key": 1,
      "paused_reason": "consecutive_failures",
      "progress": 1,
      "refresh_period": "15 min",
      "refresh_status": "active",
      "status": "uploading",
      "style": {},
      "tile_url": "text",
      "type": "layer"
    }
  ],
  "legend_visibility": "hide",
  "links": {
    "self": "https://felt.com/api/v2/maps/V0dnOMOuTd9B9BOsL9C0UjmqC/layer_groups/v13k4Ae9BRjCHHdPP5Fcm6D"
  },
  "name": "text",
  "ordering_key": 1,
  "type": "layer_group",
  "visibility_interaction": "default"
}

Delete map layer group

delete

Permanently remove a layer group and all its contained layers from a map.

This action cannot be undone. The layer group and all its contained layers will be permanently removed from the map.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

map_idstringRequired

The ID of the map to delete the layer group from

layer_group_idstringRequired

The ID of the layer group to delete

Responses

204

No Content

No content

401

UnauthorizedError

application/json

403

UnauthorizedError

application/json

404

NotFoundError

application/json

422

Unprocessable Entity

application/json

429

Unprocessable Entity

application/json

500

InternalServerError

application/json

delete/api/v2/maps/{map_id}/layer_groups/{layer_group_id}

HTTPcURLJavaScriptPython

DELETE /api/v2/maps/{map_id}/layer_groups/{layer_group_id} HTTP/1.1
Host: felt.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

List map layers

get

Retrieve all layers from a map, including uploaded files and connected data sources.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

map_idstringRequired

Responses

200

Layers list

application/json

captionstring · nullableRequired

geometry_typestring · enum · nullableRequiredPossible values:

hide_from_legendbooleanRequired

idstring · felt_idRequiredExample: luCHyMruTQ6ozGk3gPJfEB

is_spreadsheetboolean · nullableOptional

last_refreshed_atstring · date-time · nullableOptional

ISO 8601 timestamp of when the layer's data was last updated. This includes scheduled refreshes, manual refreshes, and direct feature edits.

legend_displaystring · enum · nullableOptional

Controls how the layer is displayed in the legend.

Possible values:

legend_visibilitystring · enum · nullableOptional

Controls whether or not the layer is displayed in the legend. Defaults to "show".

Possible values:

namestringRequired

next_refresh_atstring · date-time · nullableOptional

ISO 8601 timestamp of when the next scheduled refresh will occur. Null if refresh is disabled or paused.

ordering_keyinteger · nullableOptional

A sort order key used for ordering layers and layer groups in the legend

paused_reasonstring · enum · nullableOptional

Why the layer's refresh is paused. Null when not paused.

Possible values:

progressnumber · floatRequired

refresh_periodstring · enumRequiredPossible values:

refresh_statusstring · enumRequired

Whether scheduled refresh is active, paused (due to failures), or disabled

Possible values:

statusstring · enumRequiredPossible values:

styleobjectRequired

The Felt Style Language style for the layer

subtitlestring · nullableOptionalDeprecated

Deprecated: use caption instead.

tile_urlstring · nullableOptional

The tile URL for this layer

typestring · enumRequiredPossible values:

401

UnauthorizedError

application/json

404

NotFoundError

application/json

500

InternalServerError

application/json

get/api/v2/maps/{map_id}/layers

HTTPcURLJavaScriptPython

GET /api/v2/maps/{map_id}/layers HTTP/1.1
Host: felt.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "attributes": [
      {
        "name": "text",
        "type": "INTEGER"
      }
    ],
    "caption": "text",
    "geometry_type": "Line",
    "hide_from_legend": true,
    "id": "luCHyMruTQ6ozGk3gPJfEB",
    "is_spreadsheet": true,
    "last_refreshed_at": "2026-07-13T18:48:56.070Z",
    "legend_display": "default",
    "legend_visibility": "hide",
    "links": {
      "self": "https://felt.com/api/v2/maps/V0dnOMOuTd9B9BOsL9C0UjmqC/layers/k441enUxQUOnZqc1ZvNsDA"
    },
    "metadata": {
      "attribution_text": "text",
      "attribution_url": "text",
      "description": "text",
      "license": "text",
      "source_abbreviation": "text",
      "source_name": "text",
      "source_url": "text",
      "updated_at": "2025-03-24"
    },
    "name": "text",
    "next_refresh_at": "2026-07-13T18:48:56.070Z",
    "ordering_key": 1,
    "paused_reason": "consecutive_failures",
    "progress": 1,
    "refresh_period": "15 min",
    "refresh_status": "active",
    "status": "uploading",
    "style": {},
    "tile_url": "text",
    "type": "layer"
  }
]

Update map layer

post

Update layer properties including styling, visibility, grouping, and other configuration options.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

map_idstringRequired

Bodyobject · LayerUpdateParams[]

application/json

captionstringOptionalExample: A very interesting dataset

idstring · felt_idRequiredExample: luCHyMruTQ6ozGk3gPJfEB

layer_group_idstring · felt_id · nullableOptionalExample: luCHyMruTQ6ozGk3gPJfEB

legend_displaystring · enumOptional

Controls how the layer is displayed in the legend.

Possible values:

legend_visibilitystring · enumOptional

Controls whether or not the layer is displayed in the legend.

Possible values:

namestringOptionalExample: My Layer

ordering_keyintegerOptional

refresh_periodstring · enumOptionalPossible values:

subtitlestringOptionalDeprecated

Deprecated: use caption instead.

Responses

200

Layer list

application/json

captionstring · nullableRequired

geometry_typestring · enum · nullableRequiredPossible values:

hide_from_legendbooleanRequired

idstring · felt_idRequiredExample: luCHyMruTQ6ozGk3gPJfEB

is_spreadsheetboolean · nullableOptional

last_refreshed_atstring · date-time · nullableOptional

ISO 8601 timestamp of when the layer's data was last updated. This includes scheduled refreshes, manual refreshes, and direct feature edits.

legend_displaystring · enum · nullableOptional

Controls how the layer is displayed in the legend.

Possible values:

legend_visibilitystring · enum · nullableOptional

Controls whether or not the layer is displayed in the legend. Defaults to "show".

Possible values:

namestringRequired

next_refresh_atstring · date-time · nullableOptional

ISO 8601 timestamp of when the next scheduled refresh will occur. Null if refresh is disabled or paused.

ordering_keyinteger · nullableOptional

A sort order key used for ordering layers and layer groups in the legend

paused_reasonstring · enum · nullableOptional

Why the layer's refresh is paused. Null when not paused.

Possible values:

progressnumber · floatRequired

refresh_periodstring · enumRequiredPossible values:

refresh_statusstring · enumRequired

Whether scheduled refresh is active, paused (due to failures), or disabled

Possible values:

statusstring · enumRequiredPossible values:

styleobjectRequired

The Felt Style Language style for the layer

subtitlestring · nullableOptionalDeprecated

Deprecated: use caption instead.

tile_urlstring · nullableOptional

The tile URL for this layer

typestring · enumRequiredPossible values:

401

UnauthorizedError

application/json

403

UnauthorizedError

application/json

404

NotFoundError

application/json

422

Unprocessable Entity

application/json

429

Unprocessable Entity

application/json

500

InternalServerError

application/json

post/api/v2/maps/{map_id}/layers

HTTPcURLJavaScriptPython

POST /api/v2/maps/{map_id}/layers HTTP/1.1
Host: felt.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 427

[
  {
    "caption": "A very interesting dataset",
    "id": "luCHyMruTQ6ozGk3gPJfEB",
    "layer_group_id": "luCHyMruTQ6ozGk3gPJfEB",
    "legend_display": "default",
    "legend_visibility": "hide",
    "metadata": {
      "attribution_text": "text",
      "attribution_url": "text",
      "description": "text",
      "license": "text",
      "source_abbreviation": "text",
      "source_name": "text",
      "source_url": "text",
      "updated_at": "2025-03-24"
    },
    "name": "My Layer",
    "ordering_key": 1,
    "refresh_period": "15 min"
  }
]

[
  {
    "attributes": [
      {
        "name": "text",
        "type": "INTEGER"
      }
    ],
    "caption": "text",
    "geometry_type": "Line",
    "hide_from_legend": true,
    "id": "luCHyMruTQ6ozGk3gPJfEB",
    "is_spreadsheet": true,
    "last_refreshed_at": "2026-07-13T18:48:56.070Z",
    "legend_display": "default",
    "legend_visibility": "hide",
    "links": {
      "self": "https://felt.com/api/v2/maps/V0dnOMOuTd9B9BOsL9C0UjmqC/layers/k441enUxQUOnZqc1ZvNsDA"
    },
    "metadata": {
      "attribution_text": "text",
      "attribution_url": "text",
      "description": "text",
      "license": "text",
      "source_abbreviation": "text",
      "source_name": "text",
      "source_url": "text",
      "updated_at": "2025-03-24"
    },
    "name": "text",
    "next_refresh_at": "2026-07-13T18:48:56.070Z",
    "ordering_key": 1,
    "paused_reason": "consecutive_failures",
    "progress": 1,
    "refresh_period": "15 min",
    "refresh_status": "active",
    "status": "uploading",
    "style": {},
    "tile_url": "text",
    "type": "layer"
  }
]

List map layer groups

get

Retrieve all layer groups from a map to see how layers are organized.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

map_idstringRequired

Responses

200

Layers Groups

application/json

captionstring · nullableRequired

idstring · felt_idRequiredExample: luCHyMruTQ6ozGk3gPJfEB

legend_visibilitystring · enum · nullableOptional

Controls how the layer group is displayed in the legend. Defaults to "show".

Possible values:

namestringRequired

ordering_keyintegerOptional

A sort order key used for ordering layers and layer groups in the legend

subtitlestring · nullableOptionalDeprecated

Deprecated: use caption instead.

typestring · enumRequiredPossible values:

visibility_interactionstring · enumRequired

Controls how the layer group is displayed in the legend. Defaults to "default".

Possible values:

401

UnauthorizedError

application/json

403

UnauthorizedError

application/json

404

NotFoundError

application/json

422

Unprocessable Entity

application/json

429

Unprocessable Entity

application/json

500

InternalServerError

application/json

get/api/v2/maps/{map_id}/layer_groups

HTTPcURLJavaScriptPython

GET /api/v2/maps/{map_id}/layer_groups HTTP/1.1
Host: felt.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "caption": "text",
    "id": "luCHyMruTQ6ozGk3gPJfEB",
    "layers": [
      {
        "attributes": [
          {
            "name": "text",
            "type": "INTEGER"
          }
        ],
        "caption": "text",
        "geometry_type": "Line",
        "hide_from_legend": true,
        "id": "luCHyMruTQ6ozGk3gPJfEB",
        "is_spreadsheet": true,
        "last_refreshed_at": "2026-07-13T18:48:56.070Z",
        "legend_display": "default",
        "legend_visibility": "hide",
        "links": {
          "self": "https://felt.com/api/v2/maps/V0dnOMOuTd9B9BOsL9C0UjmqC/layers/k441enUxQUOnZqc1ZvNsDA"
        },
        "metadata": {
          "attribution_text": "text",
          "attribution_url": "text",
          "description": "text",
          "license": "text",
          "source_abbreviation": "text",
          "source_name": "text",
          "source_url": "text",
          "updated_at": "2025-03-24"
        },
        "name": "text",
        "next_refresh_at": "2026-07-13T18:48:56.070Z",
        "ordering_key": 1,
        "paused_reason": "consecutive_failures",
        "progress": 1,
        "refresh_period": "15 min",
        "refresh_status": "active",
        "status": "uploading",
        "style": {},
        "tile_url": "text",
        "type": "layer"
      }
    ],
    "legend_visibility": "hide",
    "links": {
      "self": "https://felt.com/api/v2/maps/V0dnOMOuTd9B9BOsL9C0UjmqC/layer_groups/v13k4Ae9BRjCHHdPP5Fcm6D"
    },
    "name": "text",
    "ordering_key": 1,
    "type": "layer_group",
    "visibility_interaction": "default"
  }
]

Update map layer groups

post

Update properties for multiple layer groups in a single request for efficient bulk operations.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

map_idstringRequired

Bodyobject · LayerGroupParams[]

application/json

captionstringOptionalExample: A very interesting group

idstring · felt_idOptionalExample: luCHyMruTQ6ozGk3gPJfEB

legend_visibilitystring · enumOptional

Controls how the layer group is displayed in the legend

Possible values:

namestringRequiredExample: My Layer Group

ordering_keyintegerOptional

subtitlestringOptionalDeprecated

Deprecated: use caption instead.

visibility_interactionstring · enum · nullableOptional

Controls how the layer group is displayed in the legend. Defaults to "default".

Possible values:

Responses

200

LayerGroup list

application/json

captionstring · nullableRequired

idstring · felt_idRequiredExample: luCHyMruTQ6ozGk3gPJfEB

legend_visibilitystring · enum · nullableOptional

Controls how the layer group is displayed in the legend. Defaults to "show".

Possible values:

namestringRequired

ordering_keyintegerOptional

A sort order key used for ordering layers and layer groups in the legend

subtitlestring · nullableOptionalDeprecated

Deprecated: use caption instead.

typestring · enumRequiredPossible values:

visibility_interactionstring · enumRequired

Controls how the layer group is displayed in the legend. Defaults to "default".

Possible values:

401

UnauthorizedError

application/json

403

UnauthorizedError

application/json

404

NotFoundError

application/json

422

Unprocessable Entity

application/json

429

Unprocessable Entity

application/json

500

InternalServerError

application/json

post/api/v2/maps/{map_id}/layer_groups

HTTPcURLJavaScriptPython

POST /api/v2/maps/{map_id}/layer_groups HTTP/1.1
Host: felt.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 173

[
  {
    "caption": "A very interesting group",
    "id": "luCHyMruTQ6ozGk3gPJfEB",
    "legend_visibility": "hide",
    "name": "My Layer Group",
    "ordering_key": 1,
    "visibility_interaction": "default"
  }
]

[
  {
    "caption": "text",
    "id": "luCHyMruTQ6ozGk3gPJfEB",
    "layers": [
      {
        "attributes": [
          {
            "name": "text",
            "type": "INTEGER"
          }
        ],
        "caption": "text",
        "geometry_type": "Line",
        "hide_from_legend": true,
        "id": "luCHyMruTQ6ozGk3gPJfEB",
        "is_spreadsheet": true,
        "last_refreshed_at": "2026-07-13T18:48:56.070Z",
        "legend_display": "default",
        "legend_visibility": "hide",
        "links": {
          "self": "https://felt.com/api/v2/maps/V0dnOMOuTd9B9BOsL9C0UjmqC/layers/k441enUxQUOnZqc1ZvNsDA"
        },
        "metadata": {
          "attribution_text": "text",
          "attribution_url": "text",
          "description": "text",
          "license": "text",
          "source_abbreviation": "text",
          "source_name": "text",
          "source_url": "text",
          "updated_at": "2025-03-24"
        },
        "name": "text",
        "next_refresh_at": "2026-07-13T18:48:56.070Z",
        "ordering_key": 1,
        "paused_reason": "consecutive_failures",
        "progress": 1,
        "refresh_period": "15 min",
        "refresh_status": "active",
        "status": "uploading",
        "style": {},
        "tile_url": "text",
        "type": "layer"
      }
    ],
    "legend_visibility": "hide",
    "links": {
      "self": "https://felt.com/api/v2/maps/V0dnOMOuTd9B9BOsL9C0UjmqC/layer_groups/v13k4Ae9BRjCHHdPP5Fcm6D"
    },
    "name": "text",
    "ordering_key": 1,
    "type": "layer_group",
    "visibility_interaction": "default"
  }
]

Update layer style

post

Update the visual styling properties of a layer including colors, symbols, and rendering options.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

map_idstringRequired

The ID of the map where the layer is located

layer_idstringRequired

The ID of the layer to update the style of

Body

application/json

styleobjectRequired

The new layer style, specified in Felt Style Language format

Responses

200

Layer

application/json

captionstring · nullableRequired

geometry_typestring · enum · nullableRequiredPossible values:

hide_from_legendbooleanRequired

idstring · felt_idRequiredExample: luCHyMruTQ6ozGk3gPJfEB

is_spreadsheetboolean · nullableOptional

last_refreshed_atstring · date-time · nullableOptional

ISO 8601 timestamp of when the layer's data was last updated. This includes scheduled refreshes, manual refreshes, and direct feature edits.

legend_displaystring · enum · nullableOptional

Controls how the layer is displayed in the legend.

Possible values:

legend_visibilitystring · enum · nullableOptional

Controls whether or not the layer is displayed in the legend. Defaults to "show".

Possible values:

namestringRequired

next_refresh_atstring · date-time · nullableOptional

ISO 8601 timestamp of when the next scheduled refresh will occur. Null if refresh is disabled or paused.

ordering_keyinteger · nullableOptional

A sort order key used for ordering layers and layer groups in the legend

paused_reasonstring · enum · nullableOptional

Why the layer's refresh is paused. Null when not paused.

Possible values:

progressnumber · floatRequired

refresh_periodstring · enumRequiredPossible values:

refresh_statusstring · enumRequired

Whether scheduled refresh is active, paused (due to failures), or disabled

Possible values:

statusstring · enumRequiredPossible values:

styleobjectRequired

The Felt Style Language style for the layer

subtitlestring · nullableOptionalDeprecated

Deprecated: use caption instead.

tile_urlstring · nullableOptional

The tile URL for this layer

typestring · enumRequiredPossible values:

401

UnauthorizedError

application/json

403

UnauthorizedError

application/json

404

NotFoundError

application/json

422

Unprocessable Entity

application/json

429

Unprocessable Entity

application/json

500

InternalServerError

application/json

post/api/v2/maps/{map_id}/layers/{layer_id}/update_style

HTTPcURLJavaScriptPython

POST /api/v2/maps/{map_id}/layers/{layer_id}/update_style HTTP/1.1
Host: felt.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 12

{
  "style": {}
}

{
  "attributes": [
    {
      "name": "text",
      "type": "INTEGER"
    }
  ],
  "caption": "text",
  "geometry_type": "Line",
  "hide_from_legend": true,
  "id": "luCHyMruTQ6ozGk3gPJfEB",
  "is_spreadsheet": true,
  "last_refreshed_at": "2026-07-13T18:48:56.070Z",
  "legend_display": "default",
  "legend_visibility": "hide",
  "links": {
    "self": "https://felt.com/api/v2/maps/V0dnOMOuTd9B9BOsL9C0UjmqC/layers/k441enUxQUOnZqc1ZvNsDA"
  },
  "metadata": {
    "attribution_text": "text",
    "attribution_url": "text",
    "description": "text",
    "license": "text",
    "source_abbreviation": "text",
    "source_name": "text",
    "source_url": "text",
    "updated_at": "2025-03-24"
  },
  "name": "text",
  "next_refresh_at": "2026-07-13T18:48:56.070Z",
  "ordering_key": 1,
  "paused_reason": "consecutive_failures",
  "progress": 1,
  "refresh_period": "15 min",
  "refresh_status": "active",
  "status": "uploading",
  "style": {},
  "tile_url": "text",
  "type": "layer"
}

Get map layer

get

Retrieve detailed information about a specific layer including data source, styling, and configuration.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

map_idstringRequired

layer_idstringRequired

Responses

200

Layer

application/json

captionstring · nullableRequired

geometry_typestring · enum · nullableRequiredPossible values:

hide_from_legendbooleanRequired

idstring · felt_idRequiredExample: luCHyMruTQ6ozGk3gPJfEB

is_spreadsheetboolean · nullableOptional

last_refreshed_atstring · date-time · nullableOptional

ISO 8601 timestamp of when the layer's data was last updated. This includes scheduled refreshes, manual refreshes, and direct feature edits.

legend_displaystring · enum · nullableOptional

Controls how the layer is displayed in the legend.

Possible values:

legend_visibilitystring · enum · nullableOptional

Controls whether or not the layer is displayed in the legend. Defaults to "show".

Possible values:

namestringRequired

next_refresh_atstring · date-time · nullableOptional

ISO 8601 timestamp of when the next scheduled refresh will occur. Null if refresh is disabled or paused.

ordering_keyinteger · nullableOptional

A sort order key used for ordering layers and layer groups in the legend

paused_reasonstring · enum · nullableOptional

Why the layer's refresh is paused. Null when not paused.

Possible values:

progressnumber · floatRequired

refresh_periodstring · enumRequiredPossible values:

refresh_statusstring · enumRequired

Whether scheduled refresh is active, paused (due to failures), or disabled

Possible values:

statusstring · enumRequiredPossible values:

styleobjectRequired

The Felt Style Language style for the layer

subtitlestring · nullableOptionalDeprecated

Deprecated: use caption instead.

tile_urlstring · nullableOptional

The tile URL for this layer

typestring · enumRequiredPossible values:

401

UnauthorizedError

application/json

404

NotFoundError

application/json

500

InternalServerError

application/json

get/api/v2/maps/{map_id}/layers/{layer_id}

HTTPcURLJavaScriptPython

GET /api/v2/maps/{map_id}/layers/{layer_id} HTTP/1.1
Host: felt.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "attributes": [
    {
      "name": "text",
      "type": "INTEGER"
    }
  ],
  "caption": "text",
  "geometry_type": "Line",
  "hide_from_legend": true,
  "id": "luCHyMruTQ6ozGk3gPJfEB",
  "is_spreadsheet": true,
  "last_refreshed_at": "2026-07-13T18:48:56.070Z",
  "legend_display": "default",
  "legend_visibility": "hide",
  "links": {
    "self": "https://felt.com/api/v2/maps/V0dnOMOuTd9B9BOsL9C0UjmqC/layers/k441enUxQUOnZqc1ZvNsDA"
  },
  "metadata": {
    "attribution_text": "text",
    "attribution_url": "text",
    "description": "text",
    "license": "text",
    "source_abbreviation": "text",
    "source_name": "text",
    "source_url": "text",
    "updated_at": "2025-03-24"
  },
  "name": "text",
  "next_refresh_at": "2026-07-13T18:48:56.070Z",
  "ordering_key": 1,
  "paused_reason": "consecutive_failures",
  "progress": 1,
  "refresh_period": "15 min",
  "refresh_status": "active",
  "status": "uploading",
  "style": {},
  "tile_url": "text",
  "type": "layer"
}

Delete map layer

delete

Permanently remove a layer from a map.

This action cannot be undone. The layer and all its data will be permanently removed from the map.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

map_idstringRequired

The ID of the map to delete the layer from

layer_idstringRequired

The ID of the layer to delete

Responses

204

No Content

No content

401

UnauthorizedError

application/json

403

UnauthorizedError

application/json

404

NotFoundError

application/json

422

Unprocessable Entity

application/json

429

Unprocessable Entity

application/json

500

InternalServerError

application/json

delete/api/v2/maps/{map_id}/layers/{layer_id}

HTTPcURLJavaScriptPython

DELETE /api/v2/maps/{map_id}/layers/{layer_id} HTTP/1.1
Host: felt.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Duplicate map layers

post

Copy layers or layer groups to other maps, preserving styling and configuration.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Bodyone of[]

application/json

or

Responses

200

Duplicate Layers Response

application/json

401

UnauthorizedError

application/json

403

UnauthorizedError

application/json

404

NotFoundError

application/json

422

Unprocessable Entity

application/json

429

Unprocessable Entity

application/json

500

InternalServerError

application/json

post/api/v2/duplicate_layers

HTTPcURLJavaScriptPython

POST /api/v2/duplicate_layers HTTP/1.1
Host: felt.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 92

[
  {
    "destination_map_id": "luCHyMruTQ6ozGk3gPJfEB",
    "source_layer_id": "luCHyMruTQ6ozGk3gPJfEB"
  }
]

{
  "layer_groups": [
    {
      "caption": "text",
      "id": "luCHyMruTQ6ozGk3gPJfEB",
      "layers": [
        {
          "attributes": [
            {
              "name": "text",
              "type": "INTEGER"
            }
          ],
          "caption": "text",
          "geometry_type": "Line",
          "hide_from_legend": true,
          "id": "luCHyMruTQ6ozGk3gPJfEB",
          "is_spreadsheet": true,
          "last_refreshed_at": "2026-07-13T18:48:56.070Z",
          "legend_display": "default",
          "legend_visibility": "hide",
          "links": {
            "self": "https://felt.com/api/v2/maps/V0dnOMOuTd9B9BOsL9C0UjmqC/layers/k441enUxQUOnZqc1ZvNsDA"
          },
          "metadata": {
            "attribution_text": "text",
            "attribution_url": "text",
            "description": "text",
            "license": "text",
            "source_abbreviation": "text",
            "source_name": "text",
            "source_url": "text",
            "updated_at": "2025-03-24"
          },
          "name": "text",
          "next_refresh_at": "2026-07-13T18:48:56.070Z",
          "ordering_key": 1,
          "paused_reason": "consecutive_failures",
          "progress": 1,
          "refresh_period": "15 min",
          "refresh_status": "active",
          "status": "uploading",
          "style": {},
          "tile_url": "text",
          "type": "layer"
        }
      ],
      "legend_visibility": "hide",
      "links": {
        "self": "https://felt.com/api/v2/maps/V0dnOMOuTd9B9BOsL9C0UjmqC/layer_groups/v13k4Ae9BRjCHHdPP5Fcm6D"
      },
      "name": "text",
      "ordering_key": 1,
      "type": "layer_group",
      "visibility_interaction": "default"
    }
  ],
  "layers": [
    {
      "attributes": [
        {
          "name": "text",
          "type": "INTEGER"
        }
      ],
      "caption": "text",
      "geometry_type": "Line",
      "hide_from_legend": true,
      "id": "luCHyMruTQ6ozGk3gPJfEB",
      "is_spreadsheet": true,
      "last_refreshed_at": "2026-07-13T18:48:56.070Z",
      "legend_display": "default",
      "legend_visibility": "hide",
      "links": {
        "self": "https://felt.com/api/v2/maps/V0dnOMOuTd9B9BOsL9C0UjmqC/layers/k441enUxQUOnZqc1ZvNsDA"
      },
      "metadata": {
        "attribution_text": "text",
        "attribution_url": "text",
        "description": "text",
        "license": "text",
        "source_abbreviation": "text",
        "source_name": "text",
        "source_url": "text",
        "updated_at": "2025-03-24"
      },
      "name": "text",
      "next_refresh_at": "2026-07-13T18:48:56.070Z",
      "ordering_key": 1,
      "paused_reason": "consecutive_failures",
      "progress": 1,
      "refresh_period": "15 min",
      "refresh_status": "active",
      "status": "uploading",
      "style": {},
      "tile_url": "text",
      "type": "layer"
    }
  ]
}