Change an existing alert’s name, query, filters, daily/weekly frequency or enabled state. Only supplied fields change. Requires Access and confirmed email. Read get_job_alerts first.

patch/me/alerts/{alertId}

Request

  • Base URL: https://api.hiddenjobs.dev/v1
  • URL: https://api.hiddenjobs.dev/v1/me/alerts/{alertId}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.hiddenjobs.dev/v1/oauth/authorize, token URL https://api.hiddenjobs.dev/v1/oauth/token, scopes: email)

Path parameters

alertIdstring uuid required

Request body

namestring
querystring
frequency'daily' | 'weekly'
enabledboolean
categorystring[]

Match any selected value within this filter. All removes the filter; different filters combine with AND.

employmentTypestring[]

Match any selected value within this filter. All removes the filter; different filters combine with AND.

jobTypestring[]

Match any selected value within this filter. All removes the filter; different filters combine with AND.

remoteLocationstring[]

Match any selected value within this filter. All removes the filter; different filters combine with AND.

expectedVersioninteger required

Last config.version from get_job_alerts; use 0 before the first alert. Reread after a conflict.

Response

Operation result

Changes

No recorded changes to this operation across all 1 revision of this API.