ETERA API Documentation

Create a new city with its supported verticals. The city ID must be unique, and the city code must also be unique. This endpoint validates all required fields and formats before creating the city.

Validation Rules:

id: lowercase letters, numbers, and hyphens only
cityCode: uppercase letters and underscores only
iataCode: exactly 3 uppercase letters
scope: must include at least one valid vertical

Create a new city with its supported verticals. The city ID must be unique, and the city code must also be unique. This endpoint validates all required fields and formats before creating the city. **Validation Rules:** - id: lowercase letters, numbers, and hyphens only - cityCode: uppercase letters and underscores only - iataCode: exactly 3 uppercase letters - scope: must include at least one valid vertical

Request

This endpoint expects an object.

idstringRequired

Unique city identifier (lowercase with hyphens)

namestringRequired

City name

scopelist of "RESTAURANT" or "EXPERIENCE" or "HOTEL"Required

Supported verticals for this city

cityCodestringRequired

City code (uppercase with underscores)

iataCodestringRequired

Airport IATA code (3 uppercase letters)

countrystringRequired

Country name

mediastring or nullOptional

isActivebooleanOptionalDefaults to true

Whether the city is active

Response

This endpoint returns an object.

object

1	const url = 'https://api.etera.dev/context/cities/';
2	const options = {
3	method: 'POST',
4	headers: {'Content-Type': 'application/json'},
5	body: '{"id":"singapore","name":"Singapore","scope":["RESTAURANT","EXPERIENCE"],"cityCode":"SINGAPORE","iataCode":"SIN","country":"Singapore"}'
6	};
7
8	try {
9	const response = await fetch(url, options);
10	const data = await response.json();
11	console.log(data);
12	} catch (error) {
13	console.error(error);
14	}

1	{
2	"success": true,
3	"message": "string",
4	"data": {
5	"city": {
6	"id": "string",
7	"name": "string",
8	"scope": [
9	"RESTAURANT"
10	],
11	"cityCode": "string",
12	"iataCode": "string",
13	"country": "string",
14	"media": "string"
15	}
16	}
17	}