René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"bug/SaaS API Kafka Cloud Connector inconsistency","articleBody":"**Describe the bug**\n\nWhen attempting to create a Kafka Cloud source connector directly with the API, there appears to be no minimum viable configuration that can successfully create the connector because the server is inconsistent about the requirement for a `bootstrap_server{,s}` key.\n\nFirst, attempting to create the connector with `bootstrap_servers`:\n\n```http\nPOST /api/v1/sources/ HTTP/1.1\nAccept: application/json, */*;q=0.5\nAccept-Encoding: gzip, deflate\nConnection: keep-alive\nContent-Length: 168\nContent-Type: application/json\nHost: platform.unstructuredapp.io\nUser-Agent: HTTPie/3.2.4\nunstructured-api-key: ******\n\n{\n    \"config\": {\n        \"bootstrap_servers\": \"https://example.com\",\n        \"kafka_api_key\": \"foo\",\n        \"secret\": \"foo\",\n        \"topic\": \"foo\"\n    },\n    \"name\": \"test-kafka-connector\",\n    \"type\": \"kafka-cloud\"\n}\n\n\nHTTP/1.1 412 Precondition Failed\ncontent-length: 71\ncontent-type: application/json\ndate: Wed, 20 Aug 2025 20:22:42 GMT\nserver: istio-envoy\nx-envoy-upstream-service-time: 50\n\n{\n    \"errors\": [\n        {\n            \"field\": \"bootstrap_server\",\n            \"message\": \"Field is required\"\n        }\n    ]\n}\n```\n\nThe error message indicates that it should be `bootstrap_server`.\n\n```http\nPOST /api/v1/sources/ HTTP/1.1\nAccept: application/json, */*;q=0.5\nAccept-Encoding: gzip, deflate\nConnection: keep-alive\nContent-Length: 167\nContent-Type: application/json\nHost: platform.unstructuredapp.io\nUser-Agent: HTTPie/3.2.4\nunstructured-api-key: ******\n\n{\n    \"config\": {\n        \"bootstrap_server\": \"https://example.com\",\n        \"kafka_api_key\": \"foo\",\n        \"secret\": \"foo\",\n        \"topic\": \"foo\"\n    },\n    \"name\": \"test-kafka-connector\",\n    \"type\": \"kafka-cloud\"\n}\n\n\nHTTP/1.1 422 Unprocessable Entity\ncontent-length: 191\ncontent-type: application/json\ndate: Wed, 20 Aug 2025 20:23:50 GMT\nserver: istio-envoy\nx-envoy-upstream-service-time: 80\n\n{\n    \"detail\": [\n        {\n            \"input\": {\n                \"bootstrap_server\": \"https://example.com\",\n                \"kafka_api_key\": \"foo\",\n                \"secret\": \"foo\",\n                \"topic\": \"foo\"\n            },\n            \"loc\": [\n                \"body\",\n                \"bootstrap_servers\"\n            ],\n            \"msg\": \"Field required\",\n            \"type\": \"missing\"\n        }\n    ]\n}\n```\n\nNow the error message says that `bootstrap_servers` is missing.\n\n**To Reproduce**\n\nUsing HTTPie:\n\n\n```sh\n$ http -jv POST https://platform.unstructuredapp.io/api/v1/sources/ unstructured-api-key:$UNSTRUCTURED_API_KEY name=test-kafka-connector type=kafka-cloud config:='{\"topic\":\"foo\",\"kafka_api_key\":\"foo\",\"secret\":\"foo\",\"bootstrap_servers\":\"https://example.com\"}'\n```\n\n```sh\n$ http -jv POST https://platform.unstructuredapp.io/api/v1/sources/ unstructured-api-key:$UNSTRUCTURED_API_KEY name=test-kafka-connector type=kafka-cloud config:='{\"topic\":\"foo\",\"kafka_api_key\":\"foo\",\"secret\":\"foo\",\"bootstrap_server\":\"https://example.com\"}'\n```\n\n**Expected behavior**\n\nOne of these two should have worked, or should have moved on to some other validation message.\n\n**Additional context**\n\nDocumentation for the [source connector](https://docs.unstructured.io/api-reference/workflow/sources/kafka) shows the singular `bootstrap_connector`. The [Python SDK](https://github.com/Unstructured-IO/unstructured-python-client/blob/main/src/unstructured_client/models/shared/kafkacloudsourceconnectorconfiginput.py#L27) uses the plural `bootstrap_connectors`.","author":{"url":"https://github.com/aws-gopher","@type":"Person","name":"aws-gopher"},"datePublished":"2025-08-20T20:30:37.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":0},"url":"https://github.com/308/unstructured-python-client/issues/308"}