Declares a governed schedule (write-tier, self-audited).

POST

/v1/m/orchestration/schedules

curl --request POST \
  --url https://example.com/v1/m/orchestration/schedules \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "approval_ref": "example", "cadence_spec": "example", "expected_interval_seconds": 1, "grace_factor": 1, "name": "example", "subject_kind": "agent", "subject_ref": "example", "trigger_kind": "cron" }'

• this engine

Declares a governed schedule (write-tier, self-audited). The declaring principal is captured as owner_actor — the accountable principal for any later autonomous fire.

Authorizations

• bearerAuth

Parameters

Header Parameters

X-Olivares-Tenant

string format: uuid

Target tenant id; required when the principal can act in more than one tenant.

Request Body ^required

Media type application/json

object

approval_ref

Any of:

string

string

null

null

cadence_spec

Any of:

string

string

null

null

expected_interval_seconds

Any of:

integer

Zero disables cadence-miss checks; otherwise 60..31622400 and trigger_kind must be cron.

integer format: int64

null

null

grace_factor

Any of:

integer

Zero or omission selects the default of 2; otherwise the accepted range is 1..10.

integer format: int64

null

null

name

required

Must be non-empty; persistence byte-caps it.

string

>= 1 characters

subject_kind

required

string

Allowed values: agent swarm

subject_ref

required

string

>= 1 characters

trigger_kind

required

string

Allowed values: cron event manual

Responses

200

OK

Media type application/json

object

Example ^generated

{}

400

Bad request

Media type application/json

object

Example ^generated

{}

401

Unauthenticated

Media type application/json

object

Example ^generated

{}

403

Forbidden

Media type application/json

object

Example ^generated

{}

404

Not found

Media type application/json

object

Example ^generated

{}

409

Conflict / setup required

Media type application/json

object

Example ^generated

{}

429

Rate limited

Media type application/json

object

Example ^generated

{}