Recruiter: Projects

Edit a Recruiter project

Edit a Recruiter project's config (name, visibility, description, target company/job title/location/seniority). All fields optional; omitted fields are left unchanged. Returns a thin acknowledgement only (no echoed project). Requires a Recruiter seat.

patch/v1/{account_id}/recruiter/projects/{project_id}

Request

  • Base URL: https://api.curviate.com
  • URL: https://api.curviate.com/v1/{account_id}/recruiter/projects/{project_id}
  • Auth: HTTP bearer

Path parameters

account_idstring required

The account ID (acc_...) whose Recruiter seat edits the project.

project_idstring required

The project ID. Obtain it from data[].id of GET .../recruiter/projects.

Request body

namestring

New project name. Content; not stored.

visibility'PRIVATE' | 'PUBLIC'

New project visibility: PRIVATE or PUBLIC.

descriptionstring

New project description. Content; not stored.

locationstring

A LOCATION parameter id (resolve via search/parameters).

seniority_level'INTERNSHIP' | 'ENTRY_LEVEL' | 'ASSOCIATE' | 'MID_SENIOR_LEVEL' | 'DIRECTOR' | 'EXECUTIVE' | 'NOT_APPLICABLE'

Target seniority level.

Response

The project was edited. Thin acknowledgement only, no echoed project. Requires a Recruiter seat.

object'recruiter_project_edited' required

Response type discriminator.

Example response

{
  "safety_warning": {
    "row": "profile_views",
    "reset_at": "2026-09-05T00:00:00.000Z",
    "hint": {
      "parameter": "profile_views.ceiling",
      "message": "This account is at its ceiling for profile_views. This action went through because profile_views.posture is warn, and it counted: 101 of 100 this window. Raise profile_views.ceiling, or wait for the window to reset at 2026-09-05T00:00:00.000Z."
    },
    "reason": "ceiling",
    "blocked": false
  }
}

Changes

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