# 🎯 Leads

Sales lead tracking and management

## List leads

> Get a paginated list of leads with optional filters

```json
{"openapi":"3.0.3","info":{"title":"Skhokho API","version":"v1.0"},"tags":[{"name":"Leads","description":"Sales lead tracking and management"}],"servers":[{"url":"https://skhokho.ai","description":"Production"},{"url":"http://102.209.118.152:8000/","description":"Local"},{"url":"https://dev.skhokho.ai","description":"Development"}],"security":[{"cookieAuth":[]},{"basicAuth":[]}],"components":{"securitySchemes":{"cookieAuth":{"type":"apiKey","in":"cookie","name":"sessionid"},"basicAuth":{"type":"http","scheme":"basic"}},"schemas":{"Lead":{"type":"object","description":"Comprehensive serializer for Lead model.\nHandles multilingual fields, sales stage relationships, and computed metrics like weighted value.","properties":{"unique_id":{"type":"string","nullable":true,"maxLength":100},"title":{"type":"string"},"description":{"type":"string","nullable":true},"qualification_notes":{"type":"string","nullable":true},"priority":{"enum":["low","medium","high","critical"],"type":"string","description":"* `low` - Low\n* `medium` - Medium\n* `high` - High\n* `critical` - Critical"},"lead_source":{"enum":["website","social_media","email_marketing","referral","cold_calling","trade_show","advertising","content_marketing","seo","ppc","partner","other"],"type":"string","description":"Select one of the predefined lead sources.\n\n* `website` - Website\n* `social_media` - Social Media\n* `email_marketing` - Email Marketing\n* `referral` - Referral\n* `cold_calling` - Cold Calling\n* `trade_show` - Trade Show\n* `advertising` - Advertising\n* `content_marketing` - Content Marketing\n* `seo` - SEO\n* `ppc` - Pay-per-Click\n* `partner` - Partner\n* `other` - Other"},"estimated_value":{"type":"string","format":"decimal","pattern":"^-?\\d{0,16}(?:\\.\\d{0,2})?$","nullable":true},"win_probability":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","nullable":true},"weighted_value":{"type":"string","format":"decimal","pattern":"^-?\\d{0,16}(?:\\.\\d{0,2})?$","nullable":true,"readOnly":true},"sales_stage":{"type":"string","nullable":true,"description":"Unique ID of an existing sales stage."},"client":{"type":"string","nullable":true,"description":"Unique ID of an existing client."},"expected_close_date":{"type":"string","format":"date","nullable":true},"follow_up_date":{"type":"string","format":"date-time","nullable":true,"title":"Next Follow Up Date"},"created_by":{"allOf":[{"$ref":"#/components/schemas/ClientPersonMini"}],"readOnly":true},"assigned_to":{"allOf":[{"$ref":"#/components/schemas/ClientPersonMini"}],"readOnly":true},"is_closed":{"type":"boolean","readOnly":true},"date_created":{"type":"string","format":"date-time","readOnly":true},"last_updated":{"type":"string","format":"date-time","readOnly":true}},"required":["assigned_to","created_by","date_created","is_closed","last_updated","lead_source","sales_stage","title","weighted_value"]},"ClientPersonMini":{"type":"object","description":"Lightweight serializer for Person model.\nUsed for nested person references in other serializers.","properties":{"unique_id":{"type":"string","nullable":true,"maxLength":100},"full_name":{"type":"string","readOnly":true}},"required":["full_name"]}}},"paths":{"/api/v1.0/organisation/{org_uid}/leads/":{"get":{"operationId":"organisation_leads_list","description":"Get a paginated list of leads with optional filters","summary":"List leads","parameters":[{"in":"query","name":"name","schema":{"type":"string"},"description":"Filter leads by name/title (case-insensitive partial match)"},{"in":"path","name":"org_uid","schema":{"type":"string"},"required":true},{"in":"query","name":"source","schema":{"type":"string"},"description":"Filter by lead source"},{"in":"query","name":"status","schema":{"type":"string","enum":["lost","open","won"]},"description":"Filter leads by status: won (probability=100), lost (probability=0), or open (not won/lost)"}],"tags":["Leads"],"responses":{"200":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Lead"}}}},"description":""},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}}}}}}
```

## Create lead

> Create a new lead. Lead title, sales stage, and lead source are required.

```json
{"openapi":"3.0.3","info":{"title":"Skhokho API","version":"v1.0"},"tags":[{"name":"Leads","description":"Sales lead tracking and management"}],"servers":[{"url":"https://skhokho.ai","description":"Production"},{"url":"http://102.209.118.152:8000/","description":"Local"},{"url":"https://dev.skhokho.ai","description":"Development"}],"security":[{"cookieAuth":[]},{"basicAuth":[]}],"components":{"securitySchemes":{"cookieAuth":{"type":"apiKey","in":"cookie","name":"sessionid"},"basicAuth":{"type":"http","scheme":"basic"}},"schemas":{"LeadRequest":{"type":"object","description":"Comprehensive serializer for Lead model.\nHandles multilingual fields, sales stage relationships, and computed metrics like weighted value.","properties":{"unique_id":{"type":"string","nullable":true,"maxLength":100},"title":{"type":"string","minLength":1},"description":{"type":"string","nullable":true},"qualification_notes":{"type":"string","nullable":true},"priority":{"enum":["low","medium","high","critical"],"type":"string","description":"* `low` - Low\n* `medium` - Medium\n* `high` - High\n* `critical` - Critical"},"lead_source":{"enum":["website","social_media","email_marketing","referral","cold_calling","trade_show","advertising","content_marketing","seo","ppc","partner","other"],"type":"string","description":"Select one of the predefined lead sources.\n\n* `website` - Website\n* `social_media` - Social Media\n* `email_marketing` - Email Marketing\n* `referral` - Referral\n* `cold_calling` - Cold Calling\n* `trade_show` - Trade Show\n* `advertising` - Advertising\n* `content_marketing` - Content Marketing\n* `seo` - SEO\n* `ppc` - Pay-per-Click\n* `partner` - Partner\n* `other` - Other"},"estimated_value":{"type":"string","format":"decimal","pattern":"^-?\\d{0,16}(?:\\.\\d{0,2})?$","nullable":true},"win_probability":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","nullable":true},"sales_stage":{"type":"string","nullable":true,"description":"Unique ID of an existing sales stage."},"client":{"type":"string","nullable":true,"description":"Unique ID of an existing client."},"expected_close_date":{"type":"string","format":"date","nullable":true},"follow_up_date":{"type":"string","format":"date-time","nullable":true,"title":"Next Follow Up Date"}},"required":["lead_source","sales_stage","title"]},"Lead":{"type":"object","description":"Comprehensive serializer for Lead model.\nHandles multilingual fields, sales stage relationships, and computed metrics like weighted value.","properties":{"unique_id":{"type":"string","nullable":true,"maxLength":100},"title":{"type":"string"},"description":{"type":"string","nullable":true},"qualification_notes":{"type":"string","nullable":true},"priority":{"enum":["low","medium","high","critical"],"type":"string","description":"* `low` - Low\n* `medium` - Medium\n* `high` - High\n* `critical` - Critical"},"lead_source":{"enum":["website","social_media","email_marketing","referral","cold_calling","trade_show","advertising","content_marketing","seo","ppc","partner","other"],"type":"string","description":"Select one of the predefined lead sources.\n\n* `website` - Website\n* `social_media` - Social Media\n* `email_marketing` - Email Marketing\n* `referral` - Referral\n* `cold_calling` - Cold Calling\n* `trade_show` - Trade Show\n* `advertising` - Advertising\n* `content_marketing` - Content Marketing\n* `seo` - SEO\n* `ppc` - Pay-per-Click\n* `partner` - Partner\n* `other` - Other"},"estimated_value":{"type":"string","format":"decimal","pattern":"^-?\\d{0,16}(?:\\.\\d{0,2})?$","nullable":true},"win_probability":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","nullable":true},"weighted_value":{"type":"string","format":"decimal","pattern":"^-?\\d{0,16}(?:\\.\\d{0,2})?$","nullable":true,"readOnly":true},"sales_stage":{"type":"string","nullable":true,"description":"Unique ID of an existing sales stage."},"client":{"type":"string","nullable":true,"description":"Unique ID of an existing client."},"expected_close_date":{"type":"string","format":"date","nullable":true},"follow_up_date":{"type":"string","format":"date-time","nullable":true,"title":"Next Follow Up Date"},"created_by":{"allOf":[{"$ref":"#/components/schemas/ClientPersonMini"}],"readOnly":true},"assigned_to":{"allOf":[{"$ref":"#/components/schemas/ClientPersonMini"}],"readOnly":true},"is_closed":{"type":"boolean","readOnly":true},"date_created":{"type":"string","format":"date-time","readOnly":true},"last_updated":{"type":"string","format":"date-time","readOnly":true}},"required":["assigned_to","created_by","date_created","is_closed","last_updated","lead_source","sales_stage","title","weighted_value"]},"ClientPersonMini":{"type":"object","description":"Lightweight serializer for Person model.\nUsed for nested person references in other serializers.","properties":{"unique_id":{"type":"string","nullable":true,"maxLength":100},"full_name":{"type":"string","readOnly":true}},"required":["full_name"]}}},"paths":{"/api/v1.0/organisation/{org_uid}/leads/create/":{"post":{"operationId":"organisation_leads_create_create","description":"Create a new lead. Lead title, sales stage, and lead source are required.","summary":"Create lead","parameters":[{"in":"path","name":"org_uid","schema":{"type":"string"},"required":true}],"tags":["Leads"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/LeadRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/LeadRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Lead"}}},"description":""},"400":{"description":"Bad Request - invalid or missing fields"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}}}}}}
```

## Get lead

> Retrieve a specific lead

```json
{"openapi":"3.0.3","info":{"title":"Skhokho API","version":"v1.0"},"tags":[{"name":"Leads","description":"Sales lead tracking and management"}],"servers":[{"url":"https://skhokho.ai","description":"Production"},{"url":"http://102.209.118.152:8000/","description":"Local"},{"url":"https://dev.skhokho.ai","description":"Development"}],"security":[{"cookieAuth":[]},{"basicAuth":[]}],"components":{"securitySchemes":{"cookieAuth":{"type":"apiKey","in":"cookie","name":"sessionid"},"basicAuth":{"type":"http","scheme":"basic"}},"schemas":{"Lead":{"type":"object","description":"Comprehensive serializer for Lead model.\nHandles multilingual fields, sales stage relationships, and computed metrics like weighted value.","properties":{"unique_id":{"type":"string","nullable":true,"maxLength":100},"title":{"type":"string"},"description":{"type":"string","nullable":true},"qualification_notes":{"type":"string","nullable":true},"priority":{"enum":["low","medium","high","critical"],"type":"string","description":"* `low` - Low\n* `medium` - Medium\n* `high` - High\n* `critical` - Critical"},"lead_source":{"enum":["website","social_media","email_marketing","referral","cold_calling","trade_show","advertising","content_marketing","seo","ppc","partner","other"],"type":"string","description":"Select one of the predefined lead sources.\n\n* `website` - Website\n* `social_media` - Social Media\n* `email_marketing` - Email Marketing\n* `referral` - Referral\n* `cold_calling` - Cold Calling\n* `trade_show` - Trade Show\n* `advertising` - Advertising\n* `content_marketing` - Content Marketing\n* `seo` - SEO\n* `ppc` - Pay-per-Click\n* `partner` - Partner\n* `other` - Other"},"estimated_value":{"type":"string","format":"decimal","pattern":"^-?\\d{0,16}(?:\\.\\d{0,2})?$","nullable":true},"win_probability":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","nullable":true},"weighted_value":{"type":"string","format":"decimal","pattern":"^-?\\d{0,16}(?:\\.\\d{0,2})?$","nullable":true,"readOnly":true},"sales_stage":{"type":"string","nullable":true,"description":"Unique ID of an existing sales stage."},"client":{"type":"string","nullable":true,"description":"Unique ID of an existing client."},"expected_close_date":{"type":"string","format":"date","nullable":true},"follow_up_date":{"type":"string","format":"date-time","nullable":true,"title":"Next Follow Up Date"},"created_by":{"allOf":[{"$ref":"#/components/schemas/ClientPersonMini"}],"readOnly":true},"assigned_to":{"allOf":[{"$ref":"#/components/schemas/ClientPersonMini"}],"readOnly":true},"is_closed":{"type":"boolean","readOnly":true},"date_created":{"type":"string","format":"date-time","readOnly":true},"last_updated":{"type":"string","format":"date-time","readOnly":true}},"required":["assigned_to","created_by","date_created","is_closed","last_updated","lead_source","sales_stage","title","weighted_value"]},"ClientPersonMini":{"type":"object","description":"Lightweight serializer for Person model.\nUsed for nested person references in other serializers.","properties":{"unique_id":{"type":"string","nullable":true,"maxLength":100},"full_name":{"type":"string","readOnly":true}},"required":["full_name"]}}},"paths":{"/api/v1.0/organisation/{org_uid}/leads/{unique_id}/":{"get":{"operationId":"organisation_leads_retrieve","description":"Retrieve a specific lead","summary":"Get lead","parameters":[{"in":"path","name":"org_uid","schema":{"type":"string"},"required":true},{"in":"path","name":"unique_id","schema":{"type":"string"},"required":true}],"tags":["Leads"],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Lead"}}},"description":""},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}}}}}}
```

## Update lead

> Update a specific lead (full or partial update).

```json
{"openapi":"3.0.3","info":{"title":"Skhokho API","version":"v1.0"},"tags":[{"name":"Leads","description":"Sales lead tracking and management"}],"servers":[{"url":"https://skhokho.ai","description":"Production"},{"url":"http://102.209.118.152:8000/","description":"Local"},{"url":"https://dev.skhokho.ai","description":"Development"}],"security":[{"cookieAuth":[]},{"basicAuth":[]}],"components":{"securitySchemes":{"cookieAuth":{"type":"apiKey","in":"cookie","name":"sessionid"},"basicAuth":{"type":"http","scheme":"basic"}},"schemas":{"LeadRequest":{"type":"object","description":"Comprehensive serializer for Lead model.\nHandles multilingual fields, sales stage relationships, and computed metrics like weighted value.","properties":{"unique_id":{"type":"string","nullable":true,"maxLength":100},"title":{"type":"string","minLength":1},"description":{"type":"string","nullable":true},"qualification_notes":{"type":"string","nullable":true},"priority":{"enum":["low","medium","high","critical"],"type":"string","description":"* `low` - Low\n* `medium` - Medium\n* `high` - High\n* `critical` - Critical"},"lead_source":{"enum":["website","social_media","email_marketing","referral","cold_calling","trade_show","advertising","content_marketing","seo","ppc","partner","other"],"type":"string","description":"Select one of the predefined lead sources.\n\n* `website` - Website\n* `social_media` - Social Media\n* `email_marketing` - Email Marketing\n* `referral` - Referral\n* `cold_calling` - Cold Calling\n* `trade_show` - Trade Show\n* `advertising` - Advertising\n* `content_marketing` - Content Marketing\n* `seo` - SEO\n* `ppc` - Pay-per-Click\n* `partner` - Partner\n* `other` - Other"},"estimated_value":{"type":"string","format":"decimal","pattern":"^-?\\d{0,16}(?:\\.\\d{0,2})?$","nullable":true},"win_probability":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","nullable":true},"sales_stage":{"type":"string","nullable":true,"description":"Unique ID of an existing sales stage."},"client":{"type":"string","nullable":true,"description":"Unique ID of an existing client."},"expected_close_date":{"type":"string","format":"date","nullable":true},"follow_up_date":{"type":"string","format":"date-time","nullable":true,"title":"Next Follow Up Date"}},"required":["lead_source","sales_stage","title"]},"Lead":{"type":"object","description":"Comprehensive serializer for Lead model.\nHandles multilingual fields, sales stage relationships, and computed metrics like weighted value.","properties":{"unique_id":{"type":"string","nullable":true,"maxLength":100},"title":{"type":"string"},"description":{"type":"string","nullable":true},"qualification_notes":{"type":"string","nullable":true},"priority":{"enum":["low","medium","high","critical"],"type":"string","description":"* `low` - Low\n* `medium` - Medium\n* `high` - High\n* `critical` - Critical"},"lead_source":{"enum":["website","social_media","email_marketing","referral","cold_calling","trade_show","advertising","content_marketing","seo","ppc","partner","other"],"type":"string","description":"Select one of the predefined lead sources.\n\n* `website` - Website\n* `social_media` - Social Media\n* `email_marketing` - Email Marketing\n* `referral` - Referral\n* `cold_calling` - Cold Calling\n* `trade_show` - Trade Show\n* `advertising` - Advertising\n* `content_marketing` - Content Marketing\n* `seo` - SEO\n* `ppc` - Pay-per-Click\n* `partner` - Partner\n* `other` - Other"},"estimated_value":{"type":"string","format":"decimal","pattern":"^-?\\d{0,16}(?:\\.\\d{0,2})?$","nullable":true},"win_probability":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","nullable":true},"weighted_value":{"type":"string","format":"decimal","pattern":"^-?\\d{0,16}(?:\\.\\d{0,2})?$","nullable":true,"readOnly":true},"sales_stage":{"type":"string","nullable":true,"description":"Unique ID of an existing sales stage."},"client":{"type":"string","nullable":true,"description":"Unique ID of an existing client."},"expected_close_date":{"type":"string","format":"date","nullable":true},"follow_up_date":{"type":"string","format":"date-time","nullable":true,"title":"Next Follow Up Date"},"created_by":{"allOf":[{"$ref":"#/components/schemas/ClientPersonMini"}],"readOnly":true},"assigned_to":{"allOf":[{"$ref":"#/components/schemas/ClientPersonMini"}],"readOnly":true},"is_closed":{"type":"boolean","readOnly":true},"date_created":{"type":"string","format":"date-time","readOnly":true},"last_updated":{"type":"string","format":"date-time","readOnly":true}},"required":["assigned_to","created_by","date_created","is_closed","last_updated","lead_source","sales_stage","title","weighted_value"]},"ClientPersonMini":{"type":"object","description":"Lightweight serializer for Person model.\nUsed for nested person references in other serializers.","properties":{"unique_id":{"type":"string","nullable":true,"maxLength":100},"full_name":{"type":"string","readOnly":true}},"required":["full_name"]}}},"paths":{"/api/v1.0/organisation/{org_uid}/leads/{unique_id}/update/":{"put":{"operationId":"organisation_leads_update_update","description":"Update a specific lead (full or partial update).","summary":"Update lead","parameters":[{"in":"path","name":"org_uid","schema":{"type":"string"},"required":true},{"in":"path","name":"unique_id","schema":{"type":"string"},"required":true}],"tags":["Leads"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/LeadRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/LeadRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Lead"}}},"description":""},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}}}}}}
```

## Update lead

> Update a specific lead (full or partial update).

```json
{"openapi":"3.0.3","info":{"title":"Skhokho API","version":"v1.0"},"tags":[{"name":"Leads","description":"Sales lead tracking and management"}],"servers":[{"url":"https://skhokho.ai","description":"Production"},{"url":"http://102.209.118.152:8000/","description":"Local"},{"url":"https://dev.skhokho.ai","description":"Development"}],"security":[{"cookieAuth":[]},{"basicAuth":[]}],"components":{"securitySchemes":{"cookieAuth":{"type":"apiKey","in":"cookie","name":"sessionid"},"basicAuth":{"type":"http","scheme":"basic"}},"schemas":{"PatchedLeadRequest":{"type":"object","description":"Comprehensive serializer for Lead model.\nHandles multilingual fields, sales stage relationships, and computed metrics like weighted value.","properties":{"unique_id":{"type":"string","nullable":true,"maxLength":100},"title":{"type":"string","minLength":1},"description":{"type":"string","nullable":true},"qualification_notes":{"type":"string","nullable":true},"priority":{"enum":["low","medium","high","critical"],"type":"string","description":"* `low` - Low\n* `medium` - Medium\n* `high` - High\n* `critical` - Critical"},"lead_source":{"enum":["website","social_media","email_marketing","referral","cold_calling","trade_show","advertising","content_marketing","seo","ppc","partner","other"],"type":"string","description":"Select one of the predefined lead sources.\n\n* `website` - Website\n* `social_media` - Social Media\n* `email_marketing` - Email Marketing\n* `referral` - Referral\n* `cold_calling` - Cold Calling\n* `trade_show` - Trade Show\n* `advertising` - Advertising\n* `content_marketing` - Content Marketing\n* `seo` - SEO\n* `ppc` - Pay-per-Click\n* `partner` - Partner\n* `other` - Other"},"estimated_value":{"type":"string","format":"decimal","pattern":"^-?\\d{0,16}(?:\\.\\d{0,2})?$","nullable":true},"win_probability":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","nullable":true},"sales_stage":{"type":"string","nullable":true,"description":"Unique ID of an existing sales stage."},"client":{"type":"string","nullable":true,"description":"Unique ID of an existing client."},"expected_close_date":{"type":"string","format":"date","nullable":true},"follow_up_date":{"type":"string","format":"date-time","nullable":true,"title":"Next Follow Up Date"}}},"Lead":{"type":"object","description":"Comprehensive serializer for Lead model.\nHandles multilingual fields, sales stage relationships, and computed metrics like weighted value.","properties":{"unique_id":{"type":"string","nullable":true,"maxLength":100},"title":{"type":"string"},"description":{"type":"string","nullable":true},"qualification_notes":{"type":"string","nullable":true},"priority":{"enum":["low","medium","high","critical"],"type":"string","description":"* `low` - Low\n* `medium` - Medium\n* `high` - High\n* `critical` - Critical"},"lead_source":{"enum":["website","social_media","email_marketing","referral","cold_calling","trade_show","advertising","content_marketing","seo","ppc","partner","other"],"type":"string","description":"Select one of the predefined lead sources.\n\n* `website` - Website\n* `social_media` - Social Media\n* `email_marketing` - Email Marketing\n* `referral` - Referral\n* `cold_calling` - Cold Calling\n* `trade_show` - Trade Show\n* `advertising` - Advertising\n* `content_marketing` - Content Marketing\n* `seo` - SEO\n* `ppc` - Pay-per-Click\n* `partner` - Partner\n* `other` - Other"},"estimated_value":{"type":"string","format":"decimal","pattern":"^-?\\d{0,16}(?:\\.\\d{0,2})?$","nullable":true},"win_probability":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","nullable":true},"weighted_value":{"type":"string","format":"decimal","pattern":"^-?\\d{0,16}(?:\\.\\d{0,2})?$","nullable":true,"readOnly":true},"sales_stage":{"type":"string","nullable":true,"description":"Unique ID of an existing sales stage."},"client":{"type":"string","nullable":true,"description":"Unique ID of an existing client."},"expected_close_date":{"type":"string","format":"date","nullable":true},"follow_up_date":{"type":"string","format":"date-time","nullable":true,"title":"Next Follow Up Date"},"created_by":{"allOf":[{"$ref":"#/components/schemas/ClientPersonMini"}],"readOnly":true},"assigned_to":{"allOf":[{"$ref":"#/components/schemas/ClientPersonMini"}],"readOnly":true},"is_closed":{"type":"boolean","readOnly":true},"date_created":{"type":"string","format":"date-time","readOnly":true},"last_updated":{"type":"string","format":"date-time","readOnly":true}},"required":["assigned_to","created_by","date_created","is_closed","last_updated","lead_source","sales_stage","title","weighted_value"]},"ClientPersonMini":{"type":"object","description":"Lightweight serializer for Person model.\nUsed for nested person references in other serializers.","properties":{"unique_id":{"type":"string","nullable":true,"maxLength":100},"full_name":{"type":"string","readOnly":true}},"required":["full_name"]}}},"paths":{"/api/v1.0/organisation/{org_uid}/leads/{unique_id}/update/":{"patch":{"operationId":"organisation_leads_update_partial_update","description":"Update a specific lead (full or partial update).","summary":"Update lead","parameters":[{"in":"path","name":"org_uid","schema":{"type":"string"},"required":true},{"in":"path","name":"unique_id","schema":{"type":"string"},"required":true}],"tags":["Leads"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchedLeadRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/PatchedLeadRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/PatchedLeadRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Lead"}}},"description":""},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}}}}}}
```

## Delete lead

> Delete a specific lead

```json
{"openapi":"3.0.3","info":{"title":"Skhokho API","version":"v1.0"},"tags":[{"name":"Leads","description":"Sales lead tracking and management"}],"servers":[{"url":"https://skhokho.ai","description":"Production"},{"url":"http://102.209.118.152:8000/","description":"Local"},{"url":"https://dev.skhokho.ai","description":"Development"}],"security":[{"cookieAuth":[]},{"basicAuth":[]}],"components":{"securitySchemes":{"cookieAuth":{"type":"apiKey","in":"cookie","name":"sessionid"},"basicAuth":{"type":"http","scheme":"basic"}}},"paths":{"/api/v1.0/organisation/{org_uid}/leads/{unique_id}/delete/":{"delete":{"operationId":"organisation_leads_delete_destroy","description":"Delete a specific lead","summary":"Delete lead","parameters":[{"in":"path","name":"org_uid","schema":{"type":"string"},"required":true},{"in":"path","name":"unique_id","schema":{"type":"string"},"required":true}],"tags":["Leads"],"responses":{"204":{"description":"No Content"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.skhokho.ai/customers-crm/leads.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.