Skip to content

[ENG-4083, ENG-4077] fix(ApiKeyAuth): add persistent label to API key field#1618

Merged
dionlow merged 3 commits into
mainfrom
eng-apikey-field-label
Jun 23, 2026
Merged

[ENG-4083, ENG-4077] fix(ApiKeyAuth): add persistent label to API key field#1618
dionlow merged 3 commits into
mainfrom
eng-apikey-field-label

Conversation

@dionlow

@dionlow dionlow commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

Context

Customer feedback: in the API key connection flow, it's unclear that the input field is for an API key. The field previously had only a placeholder (placeholder="API Key") and no persistent label — so the only indication disappeared as soon as the user typed, focused the field, or a password manager pre-filled it.

Change

Render the API key field with the same UI as the metadata inputs in the same form — wrapping a DocsHelperTextHeader above the PasswordInput, mirroring MetadataInput:

  • Persistent "{Provider} API Key" header (e.g. "Salesforce API Key") above the field.
  • The provider's docsURL is folded into the header's "Help" expander (omitted automatically when there's no docs URL), replacing the old always-visible "Learn more about where to find your {provider} API key." text.

The edit is in the shared ApiKeyAuthForm, so it covers both API key flows:

  • Initial setup (ApiKeyAuthContent)
  • Update/manage connection (UpdateApiKeyConnect)

Verification

  • Manual check: confirm the "{Provider} API Key" header renders above the password input styled like the metadata headers; the "Help" expander reveals the docs link when a docsURL exists and is omitted otherwise; the header persists on focus/typing; and the same header appears in the update-connection flow.
updated-api-key-ux

Dion Low and others added 3 commits June 23, 2026 11:02
Customer feedback noted it was unclear that the API key input is for an
API key, since the field only had a placeholder that disappears on focus
or typing.

Render the API key field with the same DocsHelperTextHeader UI used by the
metadata inputs in the same form: a persistent "{Provider} API Key" header
with the docs link folded into a "Help" expander. Covers both the initial
setup and update-connection flows via the shared ApiKeyAuthForm.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The docs link previously rendered as a bare "Learn more →" inside the
Help expander, which was vague. Pass a prompt to DocsHelperTextHeader so
the expanded Help reads "Where to find your {Provider} API key: Learn
more →". Gated on docsURL so providers without docs show no expander.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- API key field placeholder now reads "Paste your API key here" instead
  of the terse "API Key".
- Lowercase the "learn more →" docs link in DocsHelperTextHeader so it
  reads naturally inline (applies to API key and metadata field help).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@dionlow dionlow changed the title fix(ApiKeyAuth): add persistent label to API key field [ENG-4083] fix(ApiKeyAuth): add persistent label to API key field Jun 23, 2026
@linear

linear Bot commented Jun 23, 2026

Copy link
Copy Markdown

ENG-4083

ENG-4077

@dionlow dionlow marked this pull request as ready for review June 23, 2026 19:14
@dionlow dionlow merged commit 5dfaa80 into main Jun 23, 2026
4 checks passed
@dionlow dionlow deleted the eng-apikey-field-label branch June 23, 2026 19:15
@dionlow dionlow changed the title [ENG-4083] fix(ApiKeyAuth): add persistent label to API key field [ENG-4083, ENG-4077] fix(ApiKeyAuth): add persistent label to API key field Jun 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants