Skip to main content

Update Provider

PATCH/api/v1/lead_providers/{id}/

Update an existing provider's details, or disable it temporarily (status: "inactive" — a soft-disable).

Auth: Admin JWT + IsAdminOnlyPosition.

:::tip PATCH — partial update The frontend uses PATCH (partial update) — send only the fields you want to change. All fields are optional. (The source HTML says PUT / PATCH, but PATCH is recommended for partial updates.) :::

Path parameter

ParameterTypeDescription
idIntegerProvider ID

Body fields

Same as Create Provider, but all optional:

FieldTypeDescription
nameStringProvider name
emailString (email)Contact email
statusString enumactive / inactive
is_exclusiveBooleanExclusivity
assigned_userInteger (ID)Responsible staff ID (integer on write)
price_per_leadString (decimal)Price per lead (">= 0")

Request sample

Change only the status (soft-disable):

{
"status": "inactive"
}

Code samples

curl -X PATCH https://api.navigo.example/api/v1/lead_providers/1/ \
-H "Authorization: Bearer $NAVIGO_ADMIN_JWT" \
-H "Content-Type: application/json" \
-d '{"status": "inactive"}'

Possible errors

StatusReason
400Validation error
404No provider with this id
401JWT is invalid
403No admin position

Full format: Errors.