Saved Searches

Update saved search

Updates a saved search. Renaming may regenerate the slug — clients should re-read the response or rely on the id for stable references.

patch/v1/projects/{projectSlug}/searches/{searchSlug}

Path parameters

projectSlugstring required

Project slug (human-readable identifier)

searchSlugstring required

Saved-search slug (human-readable identifier within the project).

namestring

New human-readable name. Triggers slug regeneration when the change affects the slug form (cosmetic edits like capitalization keep the URL stable).

querystring nullable

Replace the free-text query. Pass null to clear it.

filtersobject

Replace the structured filter set.

assignedUserIdstring nullable

Replace the assignee. Pass null to clear it. Use the dedicated /assign endpoint to validate membership.

Updated saved search

idstring required

Stable saved-search identifier.

organizationIdstring required

Organization that owns this saved search.

projectIdstring required

Project this saved search belongs to.

slugstring required

URL-safe slug derived from name. Regenerated when the name changes in a way that affects the slug.

namestring required

Human-readable name.

querystring nullable required

Free-text semantic query applied alongside filters. null when the search is filter-only. At least one of query or filters must be set.

filtersobject required

Structured filter set applied alongside query. Empty object means filter-free. At least one of query or filters must be set.

assignedUserIdstring nullable required

User this search is assigned to, if any. null when the search is unassigned.

createdByUserIdstring required

User who created the saved search.

deletedAtstring nullable required

ISO-8601 timestamp at which the search was deleted. null while active.

createdAtstring required

ISO-8601 timestamp of creation.

updatedAtstring required

ISO-8601 timestamp of the last update.