Skip to content

Add Tier 1 auth setup docs template and process#330

Open
c1-dev-bot[bot] wants to merge 1 commit into
mainfrom
docs/agnt-577-tier1-auth-setup-template
Open

Add Tier 1 auth setup docs template and process#330
c1-dev-bot[bot] wants to merge 1 commit into
mainfrom
docs/agnt-577-tier1-auth-setup-template

Conversation

@c1-dev-bot

@c1-dev-bot c1-dev-bot Bot commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds a Tier 1 auth setup template (developer/tier1-auth-setup-template.mdx) — a repeatable template for documenting vendor authentication when onboarding Tier 1 connectors. Covers vendor overview, supported API auth modes, recommended setup path, required scopes/permissions, credential setup instructions (both simple API-key and complex OAuth/JWT/DWD), rotation/expiration behavior, known caveats, and validation commands.
  • Adds a Tier 1 auth setup process (developer/tier1-auth-setup-process.mdx) — defines where docs live, who updates them (connector engineer, docs team, connector owner, security/compliance), and step-by-step processes for onboarding new connectors and updating existing ones.
  • Adds both pages to the docs navigation under a new "Tier 1 auth setup" group in the Developer > Build a connector section.

The template is designed to work for both simple API-key vendors (e.g., Datadog, Linear) and complex OAuth/JWT/domain-wide delegation vendors (e.g., Google Workspace, AWS, Okta).

Fixes: AGNT-577

Test plan

  • Verify both new pages render correctly on the docs site
  • Confirm navigation links work in the Developer tab
  • Review template fields against existing connector docs (Okta, Google Workspace, Datadog, AWS) to ensure completeness
  • Validate that the process document accurately describes the docs repo structure

Automated PR Notice

This PR was automatically created by c1-dev-bot as a potential documentation update.

This documentation requires:

  • Human review for accuracy and completeness
  • Verification that it matches current product behavior
  • Approval from the appropriate team before merging

Adds a repeatable template for documenting Tier 1 vendor authentication
setup (covering API keys, OAuth, JWT/DWD, IAM roles) and a companion
process document defining where docs live, who owns them, and how to
keep them current.
@linear-code

linear-code Bot commented Jun 9, 2026

Copy link
Copy Markdown

AGNT-577

@mintlify

mintlify Bot commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
conductorone 🟢 Ready View Preview Jun 9, 2026, 12:30 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

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.

0 participants