Create a Site Record

post/public/v1/site-records

Accepts documents as temporary upload ids, in the same form as the Upload a Document to a User endpoint.

post/public/v1/site-records

curl --request POST \
  --url 'https://api.app.astalty.com.au/public/v1/site-records' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "site": {
    "id": "string"
  },
  "site_record_type": {
    "id": "string"
  },
  "issue_date": "2026-07-01",
  "expiry_date": "string",
  "reference": "string"
}'

Response

{
  "data": {
    "id": "r1a2b3c4-d5e6-47f8-9a0b-1c2d3e4f5a6b",
    "name": "Fire Safety Certificate",
    "reference": "REF-12345",
    "status": "current",
    "issue_date": "2024-01-15T00:00:00+00:00",
    "expiry_date": "2025-01-15T00:00:00+00:00",
    "created_at": "2024-01-15T10:30:00+00:00",
    "site": {
      "id": "s1t2e3a4-b5c6-47d8-9e0f-1a2b3c4d5e6f",
      "name": "Main Office"
    },
    "record_type": {
      "id": "rt1a2b3c-d4e5-6f7a-8b9c-0d1e2f3a4b5c",
      "name": "Fire Safety Certificate"
    }
  }
}

Authorization

Authorizationstringrequired
Bearer authentication header of the form Bearer <token>, where <token> is your API key. See How to set up an API key.

Body

application/json

siteobjectrequired
▶Show 1 child attributesHide child attributes
- idstringrequired
site_record_typeobjectrequired
▶Show 1 child attributesHide child attributes
- idstringrequired
issue_datestring<date>required
expiry_datestring
referencestring | nullmax length 255

Response

200application/json

SiteRecordResource

dataobjectrequired
▶Show 9 child attributesHide child attributes
- idstringrequired
  Example:r1a2b3c4-d5e6-47f8-9a0b-1c2d3e4f5a6b
- namestring | nullrequired
  Example:Fire Safety Certificate
- referencestring | nullrequired
  Example:REF-12345
- statusstringrequired
  Example:current
- issue_datestring | nullrequired
  Example:2024-01-15T00:00:00+00:00
- expiry_datestring | nullrequired
  Example:2025-01-15T00:00:00+00:00
- created_atstringrequired
  Example:2024-01-15T10:30:00+00:00
- siteobjectrequired
  ▶Show 2 child attributesHide child attributes
  idstringrequired
  Example:s1t2e3a4-b5c6-47d8-9e0f-1a2b3c4d5e6f
  namestringrequired
  Example:Main Office
- record_typeobjectrequired
  ▶Show 2 child attributesHide child attributes
  idstringrequired
  Example:rt1a2b3c-d4e5-6f7a-8b9c-0d1e2f3a4b5c
  namestringrequired
  Example:Fire Safety Certificate

Errors

401Unauthenticated
403Authorization error
422Validation error

Command Palette

Authorization

Body

Response

Errors