# Troubleshooting

Common issues when developing data connectors and how to resolve them.

# Duplicate Nodes

• Cause: Different keys are being used for the same logical entity.
• Solution: Ensure your [Key] field is truly unique and stable across runs.

# Missing Edges

• Cause: The target node of a link does not exist.
• Solution: Curiosity allows "dangling edges" (links to non-existent keys), but the link will only be visible once the target node is added. Ensure all referenced nodes are ingested.

# Token Errors

• Cause: Incorrect or expired CURIOSITY_API_TOKEN.
• Solution: Verify the token in the Management interface. Check for trailing spaces in environment variables.

# Connection Refused

• Cause: The workspace is not running or the URL is incorrect.
• Solution: Ensure the workspace is accessible at the specified URL and that MSK_CORS allows your connector's IP if necessary.