agent-internal

Push Schedules

Tier C schedule push (plan 24 phase 3): the agent (via the SDK's observeScheduler wrap, or plain curl) POSTs a read-only projection of its own scheduler the moment it changes:

{"schedules": [{"id": ..., "nextRunAt"?: ISO, "cron"?: "5-field",
                "tz"?: IANA, "prompt"?: str, "name"?: str}, ...]}

The list is reconciled AUTHORITATIVELY through the same byo_sync provider the Tier B GET /schedules poll uses, so push and poll can never fight: sending the full current list adds, updates, and garbage-collects in one call. An empty list clears all synced wakes.

Returns {"upserted": n, "deleted": n, "desired": n}.

post/api/agents/internal/schedules

Request

  • Base URL
    https://api.maritime.sh (the document declares no server; this is the origin it was published from)
  • URL
    https://api.maritime.sh/api/agents/internal/schedules
  • Auth
    none declared

Headers

X-Maritime-Agent-Idstring nullable
authorizationstring nullable

Request body

object required

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.