Create site

curl --request POST \
  --url https://app.azalt.co/api/v1/sites \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "organizationId": "<string>",
  "country": "<string>",
  "city": "<string>",
  "address": "<string>",
  "unlocode": "<string>",
  "longitude": 123,
  "latitude": 123,
  "numberOfEmployees": 123,
  "floorArea": 123,
  "parentSiteId": "<string>",
  "tags": [
    "<string>"
  ],
  "metadata": {}
}
'

{
  "id": "<string>",
  "name": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>"
}

Site

Create site

Create a new site within the organizational hierarchy.

Site Creation Features:

Establish new organizational units for data collection
Define hierarchical relationships with parent sites
Set geographic and location-specific metadata
Configure custom metadata for external system integration
Initialize site-specific settings and permissions

Hierarchical Structure:

Sites can be created as children of existing sites
Parent-child relationships enable permission inheritance
Geographic and organizational boundaries are maintained
Data access follows the hierarchical structure

Multi-tenancy Impact:

New sites inherit organizational settings and policies
Row Level Security (RLS) policies are automatically applied
Form-site associations can be established for data collection
User permissions can be assigned at the site level

Integration Support:

Custom metadata enables external system synchronization
API-friendly identifiers for programmatic access
Flexible data structure for varying organizational needs

Requires site manager permissions or higher as site creation affects organizational structure and data access patterns.

POST

sites

Create site

curl --request POST \
  --url https://app.azalt.co/api/v1/sites \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "organizationId": "<string>",
  "country": "<string>",
  "city": "<string>",
  "address": "<string>",
  "unlocode": "<string>",
  "longitude": 123,
  "latitude": 123,
  "numberOfEmployees": 123,
  "floorArea": 123,
  "parentSiteId": "<string>",
  "tags": [
    "<string>"
  ],
  "metadata": {}
}
'

{
  "id": "<string>",
  "name": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

name

string

required

Minimum string length: 1

organizationId

string

required

country

string

city

string

address

string

unlocode

string

longitude

number

latitude

number

numberOfEmployees

number

floorArea

number

parentSiteId

string

Response

Successful response

string

required

name

string

required

createdAt

string

required

updatedAt

string

required

List sites Update site