Skip to content

docs: add Personal Access Tokens page#65

Open
slowbackspace wants to merge 6 commits into
masterfrom
add-pat-intro
Open

docs: add Personal Access Tokens page#65
slowbackspace wants to merge 6 commits into
masterfrom
add-pat-intro

Conversation

@slowbackspace
Copy link
Copy Markdown
Contributor

Adds a new docs page documenting Personal Access Tokens (PATs) for the Blockfrost Dashboard API.

Contents

  • Creating a PAT (name, permission set, workspace selector)
  • Token format (bfm_live_ prefix)
  • Full scope reference grouped by resource (account & billing, workspaces, projects, webhooks)
  • Permission presets (Read only, CI / deploy, Full access)
  • Workspace selector trade-offs

Also adds the page to the overview sidebar.

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds documentation for Personal Access Tokens (PATs) used with the Blockfrost Dashboard API, and surfaces the new page in the Overview sidebar to make it discoverable alongside other account/workspace docs.

Changes:

  • Added a new Overview docs page describing PAT creation, token format, scopes/presets, workspace selector behavior, and operational guidance (rotation/revocation).
  • Linked the new PAT page into the Docusaurus sidebar under Overview.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
src/sidebars.js Adds the new PAT doc entry to the Overview section of the docs sidebar.
docs/overview/personal-access-tokens.md New documentation page covering PAT concepts, permissions/scopes, workspace selector, and management/security practices.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/overview/personal-access-tokens.md Outdated
slowbackspace and others added 2 commits June 1, 2026 10:54
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.

- explain bfm_live_<key_id>_<secret> structure and what key_id is
- add end-to-end request example with sample response
- note PATs don't expire (rotate/revoke only)
- add Errors table and Rate limits section

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented Jun 2, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
blockfrost-dev Ready Ready Preview, Comment Jun 2, 2026 7:38am

Request Review

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- workspaces page route is /overview/workspaces/ not .../workspaces
- drop internal key_id name; describe it as a non-secret identifier

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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