Skip to content

Replace job tags

PUT
/api/nova/jobs/{jobId}/tags

Replaces the full set of tags on a job identified by the jobId path variable. The request body must include a tags array where each tag has a value and an optional group; entries with a blank value are skipped, and the supplied set replaces the job's existing tags rather than being appended. Returns the job ID with the message Tags updated on success. Returns 400 if the tags array is missing, 404 if the job is not found, 429 if rate limited, 401 for an invalid API key, and 500 with an error message on failure.

Authorizations

privateApiKey
Type
API Key (query: apiKey)

Parameters

Path Parameters

jobId*

jobId

Type
string
Required

Query Parameters

apiKey*

apiKey

Type
string
Required

Request Body

application/json
JSON
{
  
"tags": [
  
  
{
  
  
  
"group": "string",
  
  
  
"value": "string"
  
  
}
  
]
}

Responses

OK

application/json
JSON
{
  
"data": "string",
  
"error": "string",
  
"message": "string",
  
"requestId": "string",
  
"success": true
}

Playground

Authorization
Variables
Key
Value
Body

Samples

Recruitly — Recruitment CRM for Agencies