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