v1
latestOpenAPI 3.1.02026-07-13632897.9 KBPriority Guardian Priorities
Delete Priority
Soft-delete (retire) a priority.
Sets status to 'retired', retired_at to now, and clears calendar_keyword. Deliverables, goals, and snapshots are preserved for historical reporting. The freed keyword becomes available for new priorities.
Idempotent: calling on an already-retired priority returns 200 with no state change.
Args: priority_id: Priority ID (UUID string) user_id: User ID from validated JWT session: Database session
Returns: 200: Full priorities response (active priorities only) 404: Priority not found or wrong user
delete/api/priority-guardian/priorities/{priority_id}
Path parameters
priority_idstring required
Headers
X-Internal-Secretstring nullable
X-User-IDstring nullable
Response
Successful Response
{"stackTrail":"paths:/api/priority-guardian/priorities/{priority_id}:delete:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}