Skip to content
Nexadata Nexadata Docs

Troubleshooting Pigment Connection Issues

Setting up your Pigment connection in Nexadata is typically straightforward. However, you might encounter occasional errors during setup or usage. This guide covers common issues and how to resolve them quickly.

Common Issues and How to Fix Them

Section titled “Common Issues and How to Fix Them”

1. Invalid API Key Error

Section titled “1. Invalid API Key Error”

Problem: When clicking the Test button, you receive an “Unauthorized Pigment API Key” message.

Solution:

  • Double-check that you copied the entire key correctly from Pigment.

  • Make sure there are no extra spaces or characters when pasting the key.

  • Confirm that the key is active and has not been revoked or expired in Pigment.

  • Confirm the key carries all three scopes. Nexadata requires Metadata, Import, and Export on the same key.

Tip: If needed, generate a new API key in Pigment and update your Nexadata connection.

2. Insufficient Permissions

Section titled “2. Insufficient Permissions”

Problem: The key passes the initial test but later fails during data operations with a “Permission Denied” error.

Solution:

  • Verify the API key’s permissions in Pigment.

  • Ensure the key has access to the required resources (e.g., views, lists, metrics).

  • If permissions are too restricted, request broader access in Pigment. The connection would not have saved without all three scopes, so a failure here is about which resources the key can reach, not which scopes it carries.

3. Submit Is Greyed Out After a Successful Test

Section titled “3. Submit Is Greyed Out After a Successful Test”

Problem: The key tests successfully and a green shield appears, but the Submit button stays disabled and the connection cannot be saved.

Solution:

Submit does not unlock until all three scopes come back on the key. A valid key that carries only some of them will test green and still leave Submit disabled.

  • Check the chips under Pigment API Scopes Enabled against the full set: Metadata, Import, and Export.

  • Any of the three missing is what is blocking Submit. Issue a key in Pigment that carries all three, click Update to replace the key, then Test again.

Additional Best Practices

Section titled “Additional Best Practices”

  • Rotate API keys regularly to maintain security best practices.

  • Store keys securely using a credential manager.

  • Check the scope list first when an operation fails. Pigment API Scopes Enabled on the connection is the fastest way to tell a wrong key from an under-scoped one.

When to Contact Support

Section titled “When to Contact Support”

If you’ve tried the above steps and still encounter issues:

  • Collect any error messages you received.

  • Note which keys or operations are failing.

  • Provide the approximate time of failure (helpful for log tracing).

Then reach out to Nexadata Support with this information for faster resolution.