solarOS Organization API

Organization API

Delete one Lead

Deletes one tenant-scoped Lead and its public API sidecars such as custom Field Values and External References. Missing or cross-tenant records return 404. Required scope: leads:delete.

/api/v1/leads/{id}

Deletes one tenant-scoped Lead and its public API sidecars such as custom Field Values and External References. Missing or cross-tenant records return 404. Required scope: leads:delete.

Delete one Lead. Use an organization API key with leads:delete. Check the response envelope and meta.requestId before triggering dependent workflow steps.

Required scopes

leads:delete

Parameters

NameInTypeDescription
idrequiredpathstringLead identifier returned by the Organization API.

Request body

This endpoint does not accept a JSON request body.

Responses

200

Lead delete action envelope

#/components/schemas/OrgApiActionEnvelope

401

Missing or invalid organization API key

#/components/schemas/OrgApiError

402

Organization billing access or an endpoint-specific business quota denied the request

#/components/schemas/OrgApiError

403

Missing required scope: leads:delete

#/components/schemas/OrgApiError

404

Lead not found

#/components/schemas/OrgApiError

429

Rate limit exceeded

#/components/schemas/OrgApiError

Errors

401 Missing or invalid organization API key402 Organization billing access or an endpoint-specific business quota denied the request403 Missing required scope: leads:delete404 Lead not found429 Rate limit exceeded

Static examples

curl -X DELETE "$SOLAROS_BASE_URL/api/v1/leads/$SOLAROS_LEAD" \
  -H "Authorization: Bearer $SOLAROS_API_KEY"