post/delete

Performs soft deletion on matched posts.

Overview

Use this endpoint to set priority = 0 for selected or filtered posts.

Authentication

Authentication behavior is partially confirmed. See Authentication.

Permissions

Authentication is required.

Endpoint

post/delete

Purpose

Marks posts as deleted by bulk-updating priority to 0.

Method and path

POST /post/delete

Headers

Header	Required	Description
X-Api-Key or X_API_KEY	yes	API key.
Content-Type	yes	application/json.

Request body

Field	Type	Required	Description
projectId	integer	yes	Project identifier.
tab_id	integer	no	Cache invalidation scope.
uuidArray	string or array<string>	no	Explicit post selection.
limit	integer	no	Query size when filters are used.
Shared filters	mixed	no	Used when uuidArray is absent.

Example request

curl -X POST "$SIGNAL_API_BASE_URL/post/delete" \
  -H "X-Api-Key: $SIGNAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": 123,
    "uuidArray": ["<post_uuid>", "<post_uuid>"]
  }'

Example response

{
  "count": "<updated_count>",
  "deleted": ["<post_id>", "<post_id>"]
}

Notes

• Explicit id flow uses the post document identifier.
• Cache is expired by tab_id.