Archive, unarchive, or supersede a note on a prospect.

​

Body shape

PATCH /api/v1/projects/123/prospects/456/notes/789
If-Match: "AAAAAAAAK0Q="
Content-Type: application/json

{ "action": "archive" }

PATCH /api/v1/projects/123/prospects/456/notes/789
If-Match: "AAAAAAAAK0Q="
Content-Type: application/json

{
  "action": "supersede",
  "supersede": { "message": "Updated meeting summary." }
}

Mirrors the contact / company note PATCH on the Network surface. See PATCH /api/v1/network/contacts/{id}/notes/{noteId} for full semantics (archive idempotency, supersede inheritance, supersede chain rules).

Retry safety

This PATCH endpoint is not replay-cached by Idempotency-Key. Use the required If-Match header for retry safety. A concurrent revision makes the stale retry fail with 412 instead of mutating the wrong note version.

Path Parameters
  • projectId
    Type: string
    required

    Project ID

  • id
    Type: string
    required

    Prospect ID

  • noteId
    Type: string
    required

    Note (action) ID

Headers
  • If-Match
    Type: string

    Required ETag value from a previous GET response. Missing -> 428; mismatched -> 412.

Body·
required

Action discriminator + optional supersede payload

Body for PATCH /api/v1/projects/{projectId}/prospects/{id}/notes/{noteId}. Body-discriminated: action selects archive / unarchive / supersede; the supersede object carries the new-revision payload when applicable and is ignored for archive / unarchive.

  • action
    Type: string
    required

    Required verb. One of: archive, unarchive, supersede. Unknown values return 400 ValidationFailed.

  • supersede
    Type: object · nullable

    Required when action == "supersede"; ignored otherwise. Every field is a partial-update wrapper: omitted properties inherit from the predecessor, and explicit null clears the field.

Responses
  • 204

    Note mutated successfully

  • application/problem+json
  • application/problem+json
  • application/problem+json
  • application/problem+json
  • application/problem+json
  • application/problem+json
  • application/problem+json
Request Example for patch/api/v1/projects/{projectId}/prospects/{id}/notes/{noteId}
curl 'https://app.propstreet.com/api/v1/projects/{projectId}/prospects/{id}/notes/{noteId}' \
  --request PATCH \
  --header 'If-Match: ' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "action": "",
  "supersede": {
    "message": null,
    "fileId": null,
    "contentFormat": null
  }
}'
No Body

Note mutated successfully

Propstreet Documentation