---
title: "Prepare a sandbox conveyancing matter review action"
method: POST
path: "/conveyancing/matters/{id}/actions"
tags: ["Conveyancing"]
---

# Prepare a sandbox conveyancing matter review action

`POST /conveyancing/matters/{id}/actions`

## Request

- Base URL: `https://platform-api.homejourney.sg/v1`
- URL: `https://platform-api.homejourney.sg/v1/conveyancing/matters/{id}/actions`
- Auth: HTTP bearer

Prepares a deterministic sandbox matter-update draft or document-request checklist when the authenticated automation client has `conveyancing.matters.write`, sends `confirm_prepare: true`, and provides an `Idempotency-Key`. External URL: `/v1/conveyancing/matters/{id}/actions`. Current Next.js implementation path: `/api/platform/v1/conveyancing/matters/[id]/actions`. The route accepts only `prepare_matter_update_draft` and `prepare_document_request_checklist`, requires an active sandbox matter and responsible-lawyer review, and exposes no API confirmation or execution route. It never mutates the matter, submits documents or e-stamping, releases funds, handles client money, returns legal or tax action, exposes sensitive fields, or calls an external system. Unsupported writes fail strict request validation. Conveyancing pilot posture remains marketplace orchestration only, legal advice and client-money or trust-account handling remain deferred, and partner-status publication remains private-first.

## Path parameters

- `id` string, required

## Headers

- `X-Correlation-Id` string
- `Idempotency-Key` string, required

## Request body

- TransactionConveyancingPrepareRequest
  - `action` 'prepare_matter_update_draft' | 'prepare_document_request_checklist', required
  - `confirm_prepare` true, required: Must be true to prepare review-only sandbox output.

## Response `200`

Sandbox transaction/conveyancing response.

- TransactionConveyancingPrepareResponse
  - `ok` true, required
  - `action` 'prepare_matter_update_draft' | 'prepare_document_request_checklist', required
  - `action_id` string, required
  - `status` 'prepared', required
  - `required_scope` 'conveyancing.matters.write', required
  - `idempotency_required` true, required
  - `matter` object, required
    - `matter_id` string, required
    - `fixture_id` string, required
    - `matter_state` 'in_progress' | 'pending_lawyer' | 'disputed', required
    - `source` 'sandbox_fixture', required
  - `prepared_output` union, required
    - object
      - `kind` 'matter_update_draft', required
      - `headline` string, required
      - `matter_state` 'in_progress' | 'pending_lawyer' | 'disputed', required
      - `draft_points` string[], required
    - object
      - `kind` 'document_request_checklist', required
      - `headline` string, required
      - `checklist_items` object[], required
        - `category` 'matter_authority' | 'transaction_documents' | 'stamp_duty_coordination', required
        - `review_state` 'responsible_lawyer_review_required', required
        - `source_documents_included` false, required
  - `professional_review` object, required
    - `required` true, required
    - `reviewer_role` 'responsible_lawyer', required
    - `confirmation_route_exposed` false, required
    - `execution_route_exposed` false, required
  - `side_effects` object, required
    - `matter_mutated` false, required
    - `document_submitted` false, required
    - `e_stamping_submitted` false, required
    - `funds_released` false, required
    - `client_money_handled` false, required
    - `external_system_calls` false, required
    - `sensitive_fields_exposed` false, required
    - `legal_or_tax_action_returned` false, required
  - `livemode` false, required
  - `request_id` string, required

## Other responses

- `400`: Request validation failed.
- `401`: Missing or invalid platform API key.
- `403`: Credential, environment, or scope is not allowed.
- `404`: Platform API feature or resource is not available.
- `409`: Idempotency key is in progress or conflicts with an earlier request body.
- `429`: Rate limit exceeded.
- `500`: Unexpected platform API failure.

---

[API](https://skmtc.dev/homejourney/apis/homejourney-platform-api.md) · [All operations](https://skmtc.dev/homejourney/apis/homejourney-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/homejourney/apis/homejourney-platform-api/revisions/a2c6fe063db1?raw)