Schedule

Endpointhttps://api.kontorion.eu/v1

List unified schedule feed

GET

https://api.kontorion.eu/v1

/schedule/feed

Lists upcoming and recent schedule events across versioned entities and scheduled changes. Read-only; actions stay source-native.

List unified schedule feed › query Parameters

bucket

string

upcoming (default) | recent | empty for both

source

string

version | change | item

entity_type

string

Comma-separated entity types

status

string

Comma-separated statuses

entity_id

string

Filter by entity UUID

batch_id

string

Filter by batch UUID

effective_at_from

string

RFC3339 lower bound

effective_at_to

string

RFC3339 upper bound

q

string

Entity name substring search

sort

string

asc (default) | desc by effective_at

limit

integer · min: 1

Page size. Values above the server-side cap are clamped (standard default 50, cap 200; a few document-heavy lists use larger windows). Invalid values fall back to the default.

Example: 50

offset

string

Page offset

List unified schedule feed › Headers

X-Workspace-Id

string

Selects the workspace this request operates in, by workspace UUID or slug (e.g. a sandbox workspace for test integrations). Omitted: the organization's default live workspace. Unknown workspace: 404; workspace outside your organization: 403. Discover workspaces via GET /workspaces.

Workspace UUID or slug.

List unified schedule feed › Responses

array | null · required

object · required

GET/schedule/feed

curl --request GET \
  --url https://api.kontorion.eu/v1/schedule/feed

shell

Example Responses

{
  "data": [
    {
      "batch_id": "0f8fad5b-d9cb-469f-a165-70867728950e",
      "batch_label": "batch_label",
      "bucket": "bucket",
      "change_type": "change_type",
      "created_at": "2024-08-25T15:00:00Z",
      "created_by": "0f8fad5b-d9cb-469f-a165-70867728950e",
      "depends_on_id": "0f8fad5b-d9cb-469f-a165-70867728950e",
      "effective_at": "2024-08-25T15:00:00Z",
      "entity_id": "0f8fad5b-d9cb-469f-a165-70867728950e",
      "entity_name": "entity_name",
      "entity_type": "entity_type",
      "event_id": "0f8fad5b-d9cb-469f-a165-70867728950e",
      "release_strategy": "release_strategy",
      "source": "source",
      "status": "status",
      "version": 0,
      "warnings": {}
    }
  ],
  "pagination": {
    "counts": {
      "key": {
        "key": 0
      }
    },
    "cursor": "cursor",
    "has_more": true,
    "total_count": 0
  }
}

json

application/json

Schedule feed summary

GET

https://api.kontorion.eu/v1

/schedule/feed/summary

Per-day upcoming counts, needs-attention counts, and the next dated events.

Schedule feed summary › query Parameters

from

string

RFC3339 window start (default: start of today UTC)

to

string

RFC3339 window end (default: from + 35 days)

tz

string

IANA timezone for day bucketing (default UTC)

Schedule feed summary › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Schedule feed summary › Responses

object · required

GET/schedule/feed/summary

curl --request GET \
  --url https://api.kontorion.eu/v1/schedule/feed/summary

shell

Example Responses

{
  "data": {
    "day_counts": [
      {
        "count": 0,
        "day": "day"
      }
    ],
    "needs_attention": {
      "manual_due": 0,
      "stuck_releasing": 0,
      "with_warnings": 0
    },
    "next_up": [
      {
        "batch_id": "0f8fad5b-d9cb-469f-a165-70867728950e",
        "batch_label": "batch_label",
        "bucket": "bucket",
        "change_type": "change_type",
        "created_at": "2024-08-25T15:00:00Z",
        "created_by": "0f8fad5b-d9cb-469f-a165-70867728950e",
        "depends_on_id": "0f8fad5b-d9cb-469f-a165-70867728950e",
        "effective_at": "2024-08-25T15:00:00Z",
        "entity_id": "0f8fad5b-d9cb-469f-a165-70867728950e",
        "entity_name": "entity_name",
        "entity_type": "entity_type",
        "event_id": "0f8fad5b-d9cb-469f-a165-70867728950e",
        "release_strategy": "release_strategy",
        "source": "source",
        "status": "status",
        "version": 0,
        "warnings": {}
      }
    ]
  }
}

json

application/json

Roles Schedule Flows

List unified schedule feed

GET

https://api.kontorion.eu/v1

/schedule/feed

Lists upcoming and recent schedule events across versioned entities and scheduled changes. Read-only; actions stay source-native.

List unified schedule feed › query Parameters

bucket

string

upcoming (default) | recent | empty for both

source

string

version | change | item

entity_type

string

Comma-separated entity types

status

string

Comma-separated statuses

entity_id

string

Filter by entity UUID

batch_id

string

Filter by batch UUID

effective_at_from

string

RFC3339 lower bound

effective_at_to

string

RFC3339 upper bound

q

string

Entity name substring search

sort

string

asc (default) | desc by effective_at

limit

integer · min: 1

Page size. Values above the server-side cap are clamped (standard default 50, cap 200; a few document-heavy lists use larger windows). Invalid values fall back to the default.

Example: 50

offset

string

Page offset

List unified schedule feed › Headers

X-Workspace-Id

string

Workspace UUID or slug.

List unified schedule feed › Responses

array | null · required

object · required

Schedule feed summary

GET

https://api.kontorion.eu/v1

/schedule/feed/summary

Per-day upcoming counts, needs-attention counts, and the next dated events.

Schedule feed summary › query Parameters

from

string

RFC3339 window start (default: start of today UTC)

to

string

RFC3339 window end (default: from + 35 days)

tz

string

IANA timezone for day bucketing (default UTC)

Schedule feed summary › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Schedule feed summary › Responses

object · required