Skip to content
calternal docs

Restore a deleted place at its former order. Identical retries are safe if a response is lost, while an ID that was reused with different details cannot overwrite the current place (#828, DESIGN §47).

POST
/api/v1/location/places/{id}/restore
curl --request POST \
  --url https://example.com/api/v1/location/places/example/restore \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "index": 1, "latitude": 1, "longitude": 1, "name": "example", "radius_m": 1 }'

Route: /api/v1/location/places/{id}/restore. Inputs: id. Do not automatically replay this operation after an uncertain result.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string

Stable Saved place UUID

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json

Exact Saved-place content and prior order sent by the Undo action (#828, DESIGN §47).

object
index
required

Previous zero-based place position. Concurrent additions clamp it to the end of the current list.

integer
latitude
required
number format: double
longitude
required
number format: double
name
required
string
radius_m
required
integer format: int32
Examplegenerated
{
  "index": 1,
  "latitude": 1,
  "longitude": 1,
  "name": "example",
  "radius_m": 1
}

Responses

Section titled “Responses”

200

Section titled “200”
Media typeapplication/json
object
id
required
string
latitude
required
number format: double
longitude
required
number format: double
name
required
string
radius_m
required
integer format: int32
Examplegenerated
{
  "id": "example",
  "latitude": 1,
  "longitude": 1,
  "name": "example",
  "radius_m": 1
}

201

Section titled “201”
Media typeapplication/json
object
id
required
string
latitude
required
number format: double
longitude
required
number format: double
name
required
string
radius_m
required
integer format: int32
Examplegenerated
{
  "id": "example",
  "latitude": 1,
  "longitude": 1,
  "name": "example",
  "radius_m": 1
}

400

Section titled “400”
Media typeapplication/json

The standard API error response: { "error": { ... } }.

object
error
required

Error details.

object
code
required

Stable machine-readable code.

string
Allowed values: bad_request unauthorized forbidden not_found conflict name_conflict_case name_too_long push_endpoint_rejected too_many_requests internal service_unavailable
details
One of:

Optional field or operation details.

object
key
additional properties
string
message
required

Safe text for logs or a user-facing error message.

string
Example
{
  "error": {
    "code": "bad_request"
  }
}

401

Section titled “401”
Media typeapplication/json

The standard API error response: { "error": { ... } }.

object
error
required

Error details.

object
code
required

Stable machine-readable code.

string
Allowed values: bad_request unauthorized forbidden not_found conflict name_conflict_case name_too_long push_endpoint_rejected too_many_requests internal service_unavailable
details
One of:

Optional field or operation details.

object
key
additional properties
string
message
required

Safe text for logs or a user-facing error message.

string
Example
{
  "error": {
    "code": "bad_request"
  }
}

409

Section titled “409”
Media typeapplication/json

The standard API error response: { "error": { ... } }.

object
error
required

Error details.

object
code
required

Stable machine-readable code.

string
Allowed values: bad_request unauthorized forbidden not_found conflict name_conflict_case name_too_long push_endpoint_rejected too_many_requests internal service_unavailable
details
One of:

Optional field or operation details.

object
key
additional properties
string
message
required

Safe text for logs or a user-facing error message.

string
Example
{
  "error": {
    "code": "bad_request"
  }
}

413

Section titled “413”
Media typeapplication/json

The standard API error response: { "error": { ... } }.

object
error
required

Error details.

object
code
required

Stable machine-readable code.

string
Allowed values: bad_request unauthorized forbidden not_found conflict name_conflict_case name_too_long push_endpoint_rejected too_many_requests internal service_unavailable
details
One of:

Optional field or operation details.

object
key
additional properties
string
message
required

Safe text for logs or a user-facing error message.

string
Example
{
  "error": {
    "code": "bad_request"
  }
}

507

Section titled “507”
Media typeapplication/json

The standard API error response: { "error": { ... } }.

object
error
required

Error details.

object
code
required

Stable machine-readable code.

string
Allowed values: bad_request unauthorized forbidden not_found conflict name_conflict_case name_too_long push_endpoint_rejected too_many_requests internal service_unavailable
details
One of:

Optional field or operation details.

object
key
additional properties
string
message
required

Safe text for logs or a user-facing error message.

string
Example
{
  "error": {
    "code": "bad_request"
  }
}