Skip to main content
POST
SDK (@phosra/sdk)
Enforcement pushes a child’s active policy out to every connected platform and returns a job you can poll. Trigger it, then watch the job and inspect per-platform results.
The write confirms the job was queued — it does not guarantee every platform applied the rule. Track completion with Get enforcement job status and per-platform outcomes with Get job results.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

childID
string<uuid>
required

Body

application/json
platform_ids
string[]

Optional list of platform IDs to target. If omitted, pushes to ALL connected platforms.

Response

Enforcement job started

id
string<uuid>

Unique identifier for this resource.

child_id
string<uuid>

Identifier of the child this resource belongs to.

policy_id
string<uuid>

Identifier of the policy this resource belongs to.

trigger_type
enum<string>

What initiated the job (e.g. manual, scheduled, policy_change).

Available options:
manual,
auto,
webhook
status
enum<string>

Current lifecycle state of the resource.

Available options:
pending,
running,
completed,
failed,
partial
started_at
string<date-time> | null

RFC 3339 timestamp of when the job started running.

completed_at
string<date-time> | null

RFC 3339 timestamp of when the job finished.

created_at
string<date-time>

RFC 3339 timestamp of when the resource was created.