---
metadata:
  - name: generator
    content: Diplodoc Platform v5.19.4
alternate:
  - https://yandex.ru/dev/audience/en/ref/openapi/segments/updateGeoPoints.md
  - https://yandex.ru/dev/audience/ru/ref/openapi/segments/updateGeoPoints.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/audience/en/llms.txt

<div class="openapi">

# Changing the list of coordinates for a segment with the "geo-circle" type

<!-- markdownlint-disable-file -->

{% note alert %}

Support for this functionality is disabled.

{% endnote %}

Changes the list of coordinates for a segment with the `circle` type.

## Request

<div class="openapi__requests">

<div class="openapi__request__wrapper" style="--method: var(--dc-openapi-methods-post);margin-bottom: 12px">

<div class="openapi__request">

POST {.openapi__method}
```text translate=no
https://api-audience.yandex.ru/v1/management/segment/{segmentId}/update_geo_points
```

</div>

</div>

</div>

### Path parameters

#|
|| **Name** | **Description** ||
||

_segmentId_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer

ID of the segment that you want to edit.
{.table-cell}
||
|#{.json-schema-properties}

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "points": [
    {
      "latitude": 0.5,
      "longitude": 0.5,
      "description": "example"
    }
  ]
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_points_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [GeoPoint](#entity-GeoPoint)[]

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  {
    "latitude": 0.5,
    "longitude": 0.5,
    "description": "example"
  }
]
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

<div class="openapi-entity">

### GeoPoint {#entity-GeoPoint}

The coordinates of the points.

#|
|| **Name** | **Description** ||
||

_description_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

Any comment up to 200 characters.

_Min length:_{.json-schema-reset .json-schema-assertion} `0`

_Max length:_{.json-schema-reset .json-schema-assertion} `200`

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_latitude_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: number

Latitude.
{.table-cell}
||
||

_longitude_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: number

Longitude.
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "latitude": 0.5,
  "longitude": 0.5,
  "description": "example"
}
```

{% endcut %}

</div>

## Responses

<div class="openapi__response__code__200">

## 200 OK

OK

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "segment": {
    "id": 0,
    "name": "example",
    "type": "example",
    "status": "example",
    "create_time": "2025-01-01T00:00:00Z",
    "owner": "example",
    "has_guests": true,
    "guest_quantity": 0,
    "can_create_dependent": true,
    "has_derivatives": true,
    "derivatives": [
      0
    ],
    "cookies_matched_quantity": 0,
    "geo_segment_type": "example",
    "times_quantity": 0,
    "period_length": 0,
    "form": "example",
    "radius": 0,
    "points": [
      {
        "latitude": 0.5,
        "longitude": 0.5,
        "description": "example"
      }
    ],
    "pattern": "example",
    "too_much_data": true
  }
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_segment_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [CircleGeoSegment](#entity-CircleGeoSegment)

Segment based on location data for circles.

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "id": 0,
  "name": "example",
  "type": "example",
  "status": "example",
  "create_time": "2025-01-01T00:00:00Z",
  "owner": "example",
  "has_guests": true,
  "guest_quantity": 0,
  "can_create_dependent": true,
  "has_derivatives": true,
  "derivatives": [
    0
  ],
  "cookies_matched_quantity": 0,
  "geo_segment_type": "example",
  "times_quantity": 0,
  "period_length": 0,
  "form": "example",
  "radius": 0,
  "points": [
    {
      "latitude": 0.5,
      "longitude": 0.5,
      "description": "example"
    }
  ],
  "pattern": "example",
  "too_much_data": true
}
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

<div class="openapi-entity">

### CircleGeoSegment {#entity-CircleGeoSegment}

Segment based on location data for circles.

#|
|| **Name** | **Description** ||
||

_name_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Segment name.

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_create_time_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string&lt;date-time&gt;

The time of segment creation.

_Example:_{.json-schema-reset .json-schema-example} `2025-01-01T00:00:00Z`
{.table-cell}
||
||

_geo_segment_type_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

Coordinate type. Acceptable values:

- `last`: Current location. The segment includes users who are currently in the selected area or who were in the area less than an hour ago.
- `regular`: Frequent location. The segment includes users who frequently visit the selected area. For example, they may be people who live or work nearby. Targeting is based on the data from the past 45 days.
- `home`: Home location. The segment includes users who live in the selected area.
- `work`: Work location. The segment includes users who work in the selected area.
- `condition`: The condition "The user visited the specified places X times during the period". The segment will include users who meet this criteria.


_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_id_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: integer

ID of the segment. Specify this parameter when updating a segment.
{.table-cell}
||
||

_owner_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

The username of the segment owner.

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_period_length_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: integer

The period for visits to the specified places. This parameter is required if you are creating the condition "User visited the specified places N time(s) during the period". Acceptable values for the time period (in days): from 1 to 90 (inclusive).
{.table-cell}
||
||

_points_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [GeoPoint](#entity-GeoPoint)[]

A list of coordinates.

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  {
    "latitude": 0.5,
    "longitude": 0.5,
    "description": "example"
  }
]
```

{% endcut %}
{.table-cell}
||
||

_radius_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: integer

The coverage radius in meters.
{.table-cell}
||
||

_status_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

Status of processing the segment. Acceptable values:

- `uploaded`: The segment with the user's data has been uploaded.
- `is_processed`: The segment with the specified parameters is being processed.
- `processed`: The segment has been uploaded and processed. The segment is ready to use.
- `processing_failed`: Segment processing has failed.
- `is_updated`: The segment is updating.
- `few_data`: The segment has insufficient data.


_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_times_quantity_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: integer

Frequency of visits to the specified places. This parameter is required if you are creating the condition "User visited the specified places N time(s) during the period".

{% note info %}

Only one visit per day is counted.

{% endnote %}

{.table-cell}
||
||

_type_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

Segment type. Acceptable values:

- `uploading`: A segment created from a file with user data.
- `metrika`: A segment imported from Yandex Metrica.
- `appmetrica`: A segment imported from AppMetrica.
- `lookalike`: A segment of users who "look like" one of the client's other segments (uses the "lookalike" technology).
- `geo`: A segment based on location data for polygons and circles.
- `pixel`: A segment created using a tracking pixel.


_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "id": 0,
  "name": "example",
  "type": "example",
  "status": "example",
  "create_time": "2025-01-01T00:00:00Z",
  "owner": "example",
  "geo_segment_type": "example",
  "times_quantity": 0,
  "period_length": 0,
  "radius": 0,
  "points": [
    {
      "latitude": 0.5,
      "longitude": 0.5,
      "description": "example"
    }
  ]
}
```

{% endcut %}

</div>

</div>

</div>

[*Deprecated]: No longer supported, please use an alternative and newer version.