Create point of interest

post

https://api.sensos.io/v1/accounts/{accountId}/points-of-interest

Create a new point of interest for an account. The location is a circle (geoCircle); address is filled in from its coordinates when omitted. Returns 201 with the new point of interest; the Location header holds its ID.

Path Params

accountId

string

required

ID of the account. An account you don't have access to returns 403.

Body Params

Point of interest to create.

Request data for a point of interest.

name

string

required

length ≤ 40

^[^\$\%\^\*\{\}\@]*$

Name of the point of interest. Can't contain $ % ^ * { } @.

description

string | null

Description of the point of interest.

referenceId

string | null

Your own reference ID for the point of interest.

type

string

enum

required

Type of the point of interest.

location

object

required

Location of the point of interest. When address is omitted it is filled in from the circle's coordinates; coordinates that can't be resolved to an address return 400.

201Point of interest created.

400Invalid request, for example a missing required field, a value out of range, or coordinates that can't be resolved to an address.