Skip to content

[Artifacts] Document namespace routes, repo content routes, and binding read methods#31351

Draft
dinasaur404 wants to merge 3 commits into
productionfrom
artifacts-api-docs-update
Draft

[Artifacts] Document namespace routes, repo content routes, and binding read methods#31351
dinasaur404 wants to merge 3 commits into
productionfrom
artifacts-api-docs-update

Conversation

@dinasaur404

Copy link
Copy Markdown
Contributor

Summary

Updates the Artifacts REST API and Workers binding reference docs to document new namespace routes, repo content routes, and content-read binding methods.

Changes to rest-api.mdx:

  • Adds ARTIFACTS_ACCOUNT_BASE_URL for account-level API calls
  • Adds Namespaces section (GET /artifacts/namespaces, GET /artifacts/namespaces/:namespace) before Repos
  • Adds Repo content section (commit history, commit, tree, blob, file, raw routes) between repo management and Tokens
  • Updates all Route: labels to show explicit full paths (/artifacts/namespaces/:namespace/...)
  • Adds JSON response envelope documentation, noting that blob/file/raw routes return bytes directly
  • Moves token authentication distinction into a note
  • Replaces tok_123 token IDs with 16-character lowercase alphanumeric IDs per OpenAPI spec

Changes to workers-binding.mdx:

  • Adds repo.log(), repo.readCommit(), and repo.readTree() content-read methods under Repo handle methods

Documentation checklist

  • Is there a changelog entry (guidelines)? If you don't add one for something awesome and new (however small) — how will our customers find out? Changelogs are automatically posted to RSS feeds, the Discord, and X.
  • The change adheres to the documentation style guide.
  • If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.

@github-actions

github-actions Bot commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/artifacts/ @elithrar, @dmmulroy, @mattzcarey, @dinasaur404, @whoiskatrin, @cloudflare/product-owners

…ad methods

- Add ARTIFACTS_ACCOUNT_BASE_URL to REST API reference
- Add Namespaces section (list, get) using account-level base URL
- Add Repo content section (log, commit, tree, blob, file, raw) between repo management and tokens
- Replace tok_123 with 16-char lowercase alphanumeric IDs per OpenAPI spec
- Add Workers binding content-read methods: log(), readCommit(), readTree()
… API docs

- Change intro text to state routes are shown relative to /accounts/
- Add JSON response envelope documentation with blob/file/raw exception note
- Update all Route: labels to show explicit /artifacts/namespaces/:namespace/... paths
@dinasaur404 dinasaur404 force-pushed the artifacts-api-docs-update branch from e2a3e48 to 50a94db Compare June 9, 2026 17:35
@ask-bonk ask-bonk Bot added documentation Documentation edits product:artifacts http://developers.cloudflare.com/artifacts/ labels Jun 9, 2026
@ask-bonk

ask-bonk Bot commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

@dinasaur404 Bonk workflow was cancelled.

View workflow run · To retry, trigger Bonk again.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Documentation edits product:artifacts http://developers.cloudflare.com/artifacts/ size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

8 participants