Model MatchHelp

Saved Filters

Get who a saved filter is shared with

getapi.modelmatch.com/v1/saved-filters/{id}/shares

Visibility, owner, the workspace-wide role and every per-user share. Readable by the owner, an editor, or a workspace admin.

Authorization

x-api-keystringrequired

API key or OAuth token. See Authentication.

Path parameters

idstringrequired

Saved-filter id (nanoid).

Responses

200objectThe filter's sharing state.
Show attributes
dataobjectrequired
Show child attributes
canManageSharingbooleanrequired

The caller may grant / revoke and change visibility (owner or workspace admin).

orgWidePermissionenumrequired

The whole workspace's role on an organization filter; null for private / shared filters.

Options:editorviewernull
ownerobjectrequired
Show child attributes
emailstring | nullrequired
imagestring | nullrequired
namestring | nullrequired
userIdstringrequired
ownerUserIdstringrequired
sharesobject[]required
Show child attributes
createdAtnumberrequired

Epoch milliseconds.

emailstring | nullrequired
idstringrequired
imagestring | nullrequired
invitedByNamestring | nullrequired
namestring | nullrequired
permissionenumrequired
Options:ownereditorviewer
userIdstringrequired
visibilityenumrequired

Who can see the filter: private — only its owner; organization — every member of the workspace (view; edit too when orgWidePermission is editor); shared — only the members it was shared with (see /saved-filters/{id}/shares).

Options:privateorganizationshared
400objectValidation error
401objectUnauthorized
403objectNo active organization, or (`code: FORBIDDEN`) the filter is shared with you at a level that does not allow this.
404objectNo saved filter with that id is visible to the caller (their own, or shared with them).
413objectResponse payload too large — detail endpoint capped to fit Lambda response limits
502objectWorkspace members could not be read (auth service unavailable).
503objectSearch timed out or the cluster is overloaded — retry after `Retry-After` seconds.