---
title: "Update property status, notes, calls, visits, or follow-up"
method: POST
path: "/api/v1/property-workflow"
---

# Update property status, notes, calls, visits, or follow-up

`POST /api/v1/property-workflow`

## Request

- Base URL: `https://dirtsignal.com`
- URL: `https://dirtsignal.com/api/v1/property-workflow`
- Auth: HTTP bearer

## Request body

- PropertyWorkflowAction
  - `address_key` string, required
  - `address_label` string
  - `region_slug` string
  - `action` 'set_status' | 'add_note' | 'log_call' | 'log_visit' | 'set_follow_up', required
  - `status` 'new' | 'reviewing' | 'qualified' | 'follow_up' | 'nurture' | 'passed'
  - `note` string
  - `occurred_at` string, date-time
  - `next_follow_up_at` string, date-time, nullable

## Response `200`

Updated property workspace and activity

---

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