Trigger enforcement for a child

POST/children/{childID}/enforce

Starts a sandbox enforcement simulation for the child's active policy. If platform_ids is provided, only those synthetic platform fixtures are included; otherwise all connected fixtures are simulated.

Auth:Bearer

Path parameters

childID

uuidrequired

Request body

platform_ids

Optional synthetic platform-fixture IDs to include. If omitted, the sandbox simulates all connected fixtures.

string[]

Response

id

Unique identifier for this resource.

uuid

child_id

Identifier of the child this resource belongs to.

uuid

policy_id

Identifier of the policy this resource belongs to.

uuid

trigger_type

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

manual | auto | webhook

status

Current lifecycle state of the resource.

pending | running | completed | failed | partial

started_at

RFC 3339 timestamp of when the job started running.

datetime

completed_at

RFC 3339 timestamp of when the job finished.

datetime

created_at

RFC 3339 timestamp of when the resource was created.

datetime

Request

bash

curl -sS -X POST "https://phosra-api-sandbox-production.up.railway.app/api/v1/children/a11ce0fa-0000-4000-8000-0000000000a1/enforce" \
  -H "Authorization: Bearer $PHOSRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "platform_ids": [
    "fire_tablet"
  ]
}'

Response

json

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "child_id": "550e8400-e29b-41d4-a716-446655440000",
  "policy_id": "550e8400-e29b-41d4-a716-446655440000",
  "trigger_type": "manual",
  "status": "pending",
  "started_at": null,
  "completed_at": null,
  "created_at": "2025-01-15T09:30:00Z"
}