Lists

Update a seen entry

Changed on

external_ids are merged; tags replace the stored tags.

Scope: lists:write. A key with sourcing:spend is also accepted.

patch/v1/seen/{seen_id}

Request

  • Base URL: https://api.recruitmcp.com
  • URL: https://api.recruitmcp.com/v1/seen/{seen_id}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://recruitmcp.com/oauth/authorize, token URL https://recruitmcp.com/oauth/token, scopes: lists:write)
    • OAuth 2 (authorization code, authorization URL https://recruitmcp.com/oauth/authorize, token URL https://recruitmcp.com/oauth/token, scopes: sourcing:spend)

Path parameters

seen_idstring required

Headers

Idempotency-Keystring

Optional on this route. At most 128 characters. When present, the same key and body replays the first response for 24 hours. A different body is 409 idempotency_key_reused. A second call waits for the first and replays it. Omit the header to run the request normally.

RecruitMCP-Version'2026-10-13'

API version. Defaults to the version the key was created with. Supported: 2026-10-13.

RecruitMCP-Customerstring

Act inside this customer (cus_…). Ignored for keys bound to a customer, which always act inside theirs.

Request body

status'seen' | 'shortlisted' | 'contacted' | 'rejected' | 'do_not_contact'
notestring nullable
tagsstring[]
external_idsobject

Response

Updated.

idstring required
object'seen_entry' required
status'seen' | 'shortlisted' | 'contacted' | 'rejected' | 'do_not_contact' required
profile_urlstring nullable
full_namestring nullable
current_employerstring nullable
notestring nullable
tagsstring[]
external_idsobject

Your ids for this person, for example {"ats": "cand_123"}.

updated_atstring date-time nullable

Changes

  • ad27b35513a6Revision changes
    • warning

      added the new approval_forced enum value to the / response property for the response status

    • warning

      added the new approval_forced enum value to the / response property for the response status

    • warning

      added the new approval_forced enum value to the / response property for the response status

    • warning

      added the new approval_forced enum value to the / response property for the response status

    • warning

      added the new approval_forced enum value to the / response property for the response status

    • info

      the security scope lists:write was added to the endpoint's security scheme oauth2

    • info

      the security scope sourcing:spend was removed from the endpoint's security scheme oauth2