WatchEye · Notes

Delete a note

Q: Is the record permanently removed?

No. Every DELETE in this API is a soft delete, because WatchEye retains a record of every entity, program, monitor and note for compliance and audit purposes. A soft-deleted record disappears from list endpoints, and its own GET returns 404. The original DELETE returns the deleted record once as confirmation; subsequent calls return 404. Deleted records can be restored from the portal within 30 days. There is no API equivalent of the restore action. After 30 days they are eligible for permanent removal. If you need to keep a record beyond that window, archive it instead.

DELETE

/notes/{note_uuid}

LIVE

Soft-delete a note. The note remains in the database for audit / compliance purposes
but is removed from list / show responses (a subsequent show or list call returns 404).
See the Soft Deletion section of the API
guide for the full policy (30-day recovery window, portal-only restore).

Request a Demo Contact Sales

Delete a note

Example Request

DELETE

request.http

key Auth: BearerAuth

DELETE /notes/{note_uuid}
Authorization: Bearer <your-api-key>
Accept: application/json

Request Schema

note_uuid

Required

uuid · path

The note UUID

Available Response Data

12 Data Points

inventory_2 What You Receive

fingerprint

uuid uuid

The note's UUID

fingerprint

note_number string (A short obfuscated public identifier for the note (e.g. "N-A1-B2C-3D4"))

data_object

note_text string (The free-text content of the note (max 5000 characters))

data_object

created_by object

Identifies who created the note

fact_check

is_immutable boolean

When true, the note is an immutable audit-trail entry and cannot be edited or

fingerprint

entity_uuid uuid

UUID of the entity this note is attached to

fingerprint

program_uuid uuid

UUID of the program the entity belongs to

fingerprint

event_uuid uuid

UUID of the event this note is attached to, if any

schedule

archived_at timestamp (ISO 8601 timestamp at which the note was archived in the portal (null if not archived))

schedule

created_at timestamp

schedule

updated_at timestamp

fingerprint

api_reference uuid

unique request identifier for log tracing and audit

lock Full API documentation provided after vetting from our compliance team. Request sample response arrow_forward

By The Numbers

API Data Scale & Coverage tag

Unmatched data depth to power your compliance and verification workflows.

50M+

Phone & Email Records

40M+

Adverse Court Records

2BN+

Australian Universe Records

18M+

Real Estate Records

7M+

Deceased Records

980M+

Social Media & Employment Records

science

Sandbox Environment

Build and test against a sandbox account. Sandbox is a separate account with its own UUID and its own API keys, and the environment is fixed at the account level, so you cannot switch an existing key between live and sandbox with a parameter or header. Both share the same base URL, so the account behind your key is what determines which environment you are in. GET /v1/account returns an environment field of live or sandbox, and that is the authoritative answer.

Calls on a sandbox key are not billed. Every endpoint, response shape, error envelope, idempotency and rate-limit behaviour mirrors live, so the only change when you move to production should be the credentials. Sandbox accounts are provisioned by your Global Data account manager.

Practical Applications

Technical Use Cases tag

delete

Removing a record from day-to-day workflows

Take a note out of active lists when it is no longer relevant. The delete is a soft delete: the record is hidden from the API and the portal but retained for compliance.

restore_from_trash

Recoverable for 30 days

A soft-deleted record can be restored from the portal within 30 days. After that window it is eligible for permanent removal.

inventory_2

Prefer archiving where you need to keep it

Where a record must stay accessible for audit or historical reporting, archive it instead. Archived records are retained indefinitely and are not subject to the 30-day window.

Trust & Assurance

Compliance & Security tag

Enterprise-grade infrastructure audited against the standards your regulators require.

verified_user

ISO 27001 Certified

enhanced_encryption

AES-256 Encryption

public

Australian Data Sovereignty

Integration & Support

Common Questions tag

Everything you need to know about implementation details and compliance infrastructure.

Filter by topic

help

Compliance Team

Global Data Support

Need help planning your custom integration or understanding our compliance coverage? Our team is here to assist.

gavel Compliance

Is the record permanently removed?

add

No. Every DELETE in this API is a soft delete, because WatchEye retains a record of every entity, program, monitor and note for compliance and audit purposes.

A soft-deleted record disappears from list endpoints, and its own GET returns 404. The original DELETE returns the deleted record once as confirmation; subsequent calls return 404.

Deleted records can be restored from the portal within 30 days. There is no API equivalent of the restore action. After 30 days they are eligible for permanent removal. If you need to keep a record beyond that window, archive it instead.

rocket_launch Implementation

What are the rate limits?

add

600 requests per minute by default, enforced with a 60-second fixed window. Every response carries X-RateLimit-Limit and X-RateLimit-Remaining.

Exceeding the limit returns 429 Too Many Requests with a Retry-After header giving the number of seconds to wait, and X-RateLimit-Reset giving the reset timestamp. Schedule retries from Retry-After instead of a fixed sleep, and slow down before you hit zero, not after.

Higher limits can be arranged case by case through WatchEye support.

Enquire now

Ready to integrate Delete a note?

Talk to our team about credentials, sandbox access and the right combination of endpoints for your workflow.

Call 03 9948 4089 · sales@globaldata.net.au

Request a Demo Contact Sales