---
title: "Create Layer From Feature"
method: POST
path: "/api/v1/table/{project_id}/features/from-source"
tags: ["table"]
---

# Create Layer From Feature

`POST /api/v1/table/{project_id}/features/from-source`

Create a new typed layer seeded with one Overture feature.

Used when a nearby-features add targets an Overture table (building/parcel/
place) with no layer in the project yet. Idempotent on the feature ref.
``target_layer_id`` instead adds the feature into that specific existing
layer (the chat destination picker).

## Request body

- CreateLayerFromFeatureRequest — Request to create a new typed layer seeded with one Overture feature.
  - `source_table` 'parcel' | 'building' | 'place' | 'address' | 'school', required — The table a resolved feature lives in — what a caller pulls its data from, and the feature's kind. A text match in the ``address``, ``place`` or ``school`` table resolves (point-in-feature) to a ``parcel``/``building``; a ``parcel`` attribute match resolves to the parcel itself.
  - `source_feature_id` string, required
  - `name` string, nullable
  - `accumulate` boolean
  - `target_layer_id` string, uuid, nullable

## Response `200`

Successful Response

- CreateLayerFromFeatureResponse — Response for creating a new typed layer seeded with one Overture feature. Returned when the user adds a nearby feature whose Overture table has no layer in the project yet; the client uses ``layer_id`` to focus/refresh the newly created layer.
  - `layer_id` string, uuid, required
  - `layer_name` string, required
  - `created` boolean
  - `data_version` integer, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/maia-analytics/apis/maia-api.md) · [All operations](https://skmtc.net/maia-analytics/apis/maia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maia-analytics/maia-api/versions/c5094ff58a23/schema)