Langsung ke konten utama
POST
/
chrono
/
schedules
Buat jadwal baru
curl --request POST \
  --url https://api.altostrat.io/chrono/schedules \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Jendela Pemeliharaan Akhir Pekan",
  "timezone": "America/New_York",
  "hours": [
    {
      "day": "saturday",
      "start": "22:00",
      "end": "23:59"
    }
  ],
  "metadata": [
    {
      "key": "ticket_ref",
      "value": "JIRA-456"
    }
  ]
}'
{
  "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "name": "Kebijakan Jam Kerja",
  "timezone": "Australia/Sydney",
  "active": true,
  "updated_at": "2025-10-29T01:43:31Z",
  "created_at": "2025-10-29T01:43:31Z",
  "hours": [
    {
      "day": "monday",
      "start": "09:00",
      "end": "17:00"
    }
  ],
  "metadata": [
    {
      "key": "policy_id",
      "value": "pol_12345"
    }
  ]
}

Authorizations

โ€‹
Authorization
string
header
required

Masukkan kunci API Anda dalam format: Bearer {key}

Body

application/json

Detail jadwal yang akan dibuat.

Badan permintaan untuk membuat atau memperbarui jadwal.

โ€‹
name
string
required

Nama jadwal. Harus unik di dalam ruang kerja Anda.

Maximum length: 200
Example:

"Jendela Pemeliharaan Akhir Pekan"

โ€‹
hours
object[]
required

Sebuah array objek slot waktu. Array ini akan sepenuhnya menggantikan slot waktu yang ada saat pembaruan.

Maximum length: 50
โ€‹
timezone
string

Nama dari IANA Time Zone Database, mis., America/New_York atau UTC. Jika tidak disediakan, default ruang kerja akan digunakan.

Example:

"America/New_York"

โ€‹
metadata
object[]

Sebuah array pasangan kunci-nilai. Saat pembaruan, berikan kunci dengan nilai null untuk menghapusnya. Kunci baru akan ditambahkan, dan kunci yang ada akan diperbarui.

Maximum length: 50

Response

Jadwal berhasil dibuat.

Merepresentasikan objek jadwal yang mendefinisikan kapan suatu kebijakan atau konfigurasi aktif.

โ€‹
id
string<uuid>

Pengenal unik untuk jadwal.

Example:

"9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d"

โ€‹
name
string

Nama yang dapat dibaca manusia untuk jadwal.

Example:

"Kebijakan Jam Kerja"

โ€‹
timezone
string

Pengenal zona waktu IANA tempat jadwal ini beroperasi. Semua waktu start dan end relatif terhadap zona waktu ini.

Example:

"Australia/Sydney"

โ€‹
active
boolean

Tanda hanya-baca yang menunjukkan apakah jadwal saat ini berada dalam slot waktu aktif. Ini dihitung oleh sistem.

Example:

true

โ€‹
updated_at
string<date-time>

Stempel waktu kapan jadwal terakhir diperbarui.

Example:

"2025-10-29T01:43:31Z"

โ€‹
created_at
string<date-time>

Stempel waktu kapan jadwal dibuat.

Example:

"2025-10-29T01:43:31Z"

โ€‹
hours
object[]

Daftar slot waktu yang menentukan periode aktif untuk jadwal ini.

โ€‹
metadata
object[]

Daftar pasangan kunci-nilai yang dapat digunakan untuk menyimpan informasi tambahan tentang jadwal.