Assign replacement partner (supervisor)
PATCH
/api/v1/supervisor/contracts/{id}/assign-partner
This is available while the contract has status
partner_pending and contract_escalation_stage = supervisor.The selected partner must be a partner created by the current supervisor and eligible for the contract sub-service.
The assignment must happen before the supervisor deadline in
escalation_deadline_at.Reassigning the contract keeps the already-paid contract pricing and payment amount unchanged, records a
reassignment entry in partner_assignments, updates contract.partner to the replacement partner, and immediately transitions the contract to accepted.Institution contract APIs hide the previous partner while the contract is waiting in the supervisor queue, and start returning the new partner after this assignment succeeds.
Supervisor Authentication Required
Request
Path Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH '/api/v1/supervisor/contracts//assign-partner' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"contract": {
"partner_id": 42
}
}'Response Response Example
200 - Example 1
{
"success": true,
"data": {
"contract": {
"id": 0,
"reference_code": "NKT-00000042",
"status": "draft",
"display_status": "draft",
"step": "string",
"kind": "string",
"contract_escalation_stage": "partner",
"escalation_deadline_at": "2019-08-24T14:15:22.123Z",
"contract_escalation_countdown_active": true,
"partner_status": "assigned",
"description": "string",
"tool_brand": "string",
"tool_type": "string",
"tool_images": [
"http://example.com"
],
"partner": {
"id": 0,
"full_name": "string",
"picture": "http://example.com",
"competencies": [
{
"id": 0,
"name": "string",
"sub_services": [
{
"id": 0,
"name": "string",
"status": "active",
"kinds": [
"installation",
"maintenance",
"repair"
]
}
]
}
]
},
"institution": {
"id": 0,
"name": "string",
"address": "string",
"city": "string",
"province": "string"
},
"sub_service": {
"id": 0,
"name": "string",
"service": {
"id": 0,
"name": "string"
}
},
"contract_start_date": "2019-08-24",
"contract_start_time": "09:30",
"contract_end_date": "2019-08-24",
"contract_end_time": "17:00",
"schedule_start_date": "2019-08-24",
"schedule_start_time": "09:30",
"schedule_end_date": "2019-08-24",
"schedule_end_time": "17:00",
"schedules": [
{
"id": 0,
"date": "2019-08-24",
"start_time": "string",
"end_time": "string",
"status": "pending"
}
],
"contact_persons": [
{
"id": 0,
"name": "string",
"phone": "string"
}
],
"pricing_items": [
{
"pricing_schema_id": 0,
"name": "string",
"code": "string",
"kind": "string",
"amount": {
"value": 50000000,
"currency": "IDR"
},
"unit": "string",
"is_partner_pricing": true,
"effect": "add"
}
],
"pricing_total": {
"value": 50000000,
"currency": "IDR",
"effect": "add"
},
"payment": {
"id": 0,
"amount": {
"value": 50000000,
"currency": "IDR"
},
"status": "string",
"payment_method_id": 0,
"proof": "http://example.com",
"payment_deadline_at": "2019-08-24T14:15:22.123Z",
"discount_amount": {
"value": 50000000,
"currency": "IDR",
"effect": "subtract"
},
"promotion": {
"id": 0,
"code": "PROMO10",
"name": "New User Discount",
"description": "Get 10% off on your first order",
"discount_type": "percentage",
"discount_value": {
"value": 50000000,
"currency": "IDR"
},
"min_order_amount": {
"value": 50000000,
"currency": "IDR"
},
"max_discount_amount": {
"value": 50000000,
"currency": "IDR"
},
"start_date": "2019-08-24",
"end_date": "2019-08-24"
}
},
"partner_assignments": [
{
"id": 0,
"sequence": 0,
"assignment_kind": "initial",
"status": "pending",
"status_reason": "string",
"assigned_at": "2019-08-24T14:15:22.123Z",
"responded_at": "2019-08-24T14:15:22.123Z",
"partner": {
"id": 0,
"full_name": "string",
"picture": "http://example.com"
},
"assigned_by": {
"id": 0,
"full_name": "string",
"role": "institution"
}
}
],
"work_started_at": "2019-08-24T14:15:22.123Z",
"effective_scheduled_end_at": "2019-08-24T14:15:22.123Z",
"can_request_extension": true,
"pending_time_adjustment": {
"id": 0,
"additional_hours": "string",
"reason": "string",
"requested_at": "2019-08-24T14:15:22.123Z"
},
"time_adjustments": [
{
"id": 0,
"value": "string",
"additional_hours": "string",
"reason": "string",
"status": "pending",
"requested_at": "2019-08-24T14:15:22.123Z",
"approved_at": "2019-08-24T14:15:22.123Z"
}
]
}
}
}Modified at 2026-06-08 00:59:16