الفريق والأسطول›تحديث فنّي

تحديث فنّي

يحدّث الحقول القابلة للتعديل في ملف الفنّي. تعيد `start_location_type=office` التقاط عنوان النشاط التجاري الحالي + إحداثياته (تُتجاهَل `address`/`start_location_lat`/`start_location_long` في المتن؛ وتتطلّب إحداثيات النشاط التجاري، وإلا 400 BUSINESS_LOCATION_MISSING). وتستخدم `start_location_type=home` (أو الفارغة) العنوان + الإحداثيات من المتن.

المعاملات

idstringpathمطلوب

معرّف الفنّي

▾addressobjectbodyاختياري

Home address (the day-start point when start_location_type=home).

assignment_tierenumbodyاختياري

فئة الطاقم: lead / buddy / float (float = مستبعَد من الإسناد التلقائي للطاقم).

business_group_idstringbodyمطلوب

مجموعة الدور. اكتشف المعرّفات عبر GET /permission/groups.

emailstringbodyاختياري

Email address. At least one of phone/email is required.

full_namestringbodyمطلوب

The person's full display name. Required; max 255 chars.

job_titlestringbodyاختياري

المسمى المعروض.

join_datestringbodyاختياري

أول يوم عمل (YYYY-MM-DD).

phonestringbodyاختياري

يلزم توفير أحد الحقلين phone/email على الأقل.

start_location_latnumberbodyاختياري

Explicit day-start latitude in decimal degrees (-90..90); when set it wins over the address geocode.

start_location_longnumberbodyاختياري

Explicit day-start longitude in decimal degrees (-180..180); when set it wins over the address geocode.

start_location_typeenumbodyاختياري

نقطة بدء اليوم: home أو office؛ الإحداثيات الصريحة تتقدّم عند ضبطها.

PUT/v1/technicians/{id}

curl -X PUT "https://api.crisphive.com/v1/technicians/9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01" \
  -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" \
  -H "Content-Type: application/json" \
  -d '{
  "address": {
    "city": "San Francisco",
    "country": "US",
    "formatted": "123 Market Street, San Francisco, CA 94103",
    "line": "123 Market Street",
    "line2": "Suite 200",
    "postal_code": "94103",
    "state": "CA"
  },
  "assignment_tier": "lead",
  "business_group_id": "9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01",
  "email": "jane.doe@example.com",
  "full_name": "Jane Cooper",
  "job_title": "Sample title",
  "join_date": "2026-07-02",
  "phone": "+14155550142",
  "start_location_lat": 1,
  "start_location_long": 1,
  "start_location_type": "home"
}'

نص الطلب

{

"address": {

"city": ,

"country": ,

"formatted": ,

"line": ,

"line2": ,

"postal_code": ,

"state":

"assignment_tier": ,

"business_group_id": ,

"email": ,

"full_name": ,

"job_title": ,

"join_date": ,

"phone": ,

"start_location_lat": ,

"start_location_long": ,

"start_location_type":

}

Bearer

الاستجابات

‹جلب فنّي

استبدال مرافقي فنّي›