الكتالوج›Rename a job type or change its availability

Rename a job type or change its availability

Edits a catalog entry in place. A rename applies to NEW bookings only: every job stores the job-type name it was booked with, so existing and completed jobs keep their original label. Partial update: omit a field to keep it. `name` rejects "" because a type must stay identifiable, and must stay unique (JOB_TYPE_DUPLICATE). Setting `status` to inactive is the reversible way to take a type off the booking form; inactive types are refused for new job requests. Default quote bundle: default_duration_minutes / default_mobilization_minutes / default_demobilization_minutes follow the same partial rule; omit to keep, 0 to clear, a value to set. Clearing the duration while a buffer stays is refused (JOB_TYPE_INVALID_DEFAULT_DURATION). Rows the platform ships with (`is_system=true`, e.g. the default "General" type) keep their name and status read-only (JOB_TYPE_SYSTEM_READ_ONLY); their default quote bundle IS editable. Create your own type if you need different wording.

المعاملات

idstringpathمطلوب

Job Type ID

default_demobilization_minutesintegerbodyاختياري

Default demobilization (teardown) minutes, 0–1440; used together with the default duration. Requires a default duration. Omit = keep, 0 = clear.

default_duration_minutesintegerbodyاختياري

Default hands-on work duration in minutes for this kind of work (1–20160). A quote that sends no job_duration_minutes uses it, which is what lets an automation or voice agent schedule a job without knowing how long the work takes. Omit = keep, 0 = clear.

default_mobilization_minutesintegerbodyاختياري

Default mobilization (setup/travel-prep) minutes, 0–1440; used together with the default duration. Requires a default duration. Omit = keep, 0 = clear.

namestringbodyاختياري

nil = keep; min=1 rejects an explicit "".

statusenumbodyاختياري

PUT/v1/job-types/{id}

curl -X PUT "https://api.crisphive.com/v1/job-types/9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01" \
  -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" \
  -H "Content-Type: application/json" \
  -d '{
  "default_demobilization_minutes": 10,
  "default_duration_minutes": 90,
  "default_mobilization_minutes": 15,
  "name": "Survey",
  "status": "active"
}'

نص الطلب

{

"default_demobilization_minutes": ,

"default_duration_minutes": ,

"default_mobilization_minutes": ,

"name": ,

"status":

}

Bearer

الاستجابات

‹جلب نوع عمل

عرض قائمة مناطق الخدمة›