Skip to content

Add API docs for network token creation and device provisioning#51

Open
FabianoEger wants to merge 1 commit into
mainfrom
docs/network-token-device-creation
Open

Add API docs for network token creation and device provisioning#51
FabianoEger wants to merge 1 commit into
mainfrom
docs/network-token-device-creation

Conversation

@FabianoEger
Copy link
Copy Markdown
Member

Summary

  • Added API documentation for POST /integration/network/token (Create Network Token) with the new privileges field that controls token capabilities
  • Added API documentation for POST /integration/network/device (Create Device using Network) for network-level device provisioning with privilege-gated access
  • Added both endpoints to the "Network Token (Network-level)" sidebar category

Companion to tago-io/server#1345.

Files added

File Purpose
create-network-token.api.mdx Main doc page for token creation endpoint
create-network-token.RequestSchema.json Request body schema (name, network, privileges)
create-network-token.StatusCodes.json Response codes (200, 401)
create-device-using-network.api.mdx Main doc page for device creation endpoint
create-device-using-network.RequestSchema.json Request body schema (name, type, connector, tags)
create-device-using-network.StatusCodes.json Response codes (201, 401)

Test plan

  • npm run check passes (oxlint + oxfmt)
  • npm run build succeeds with no broken links
  • Verify pages render correctly on the dev server (npm run start)
  • Confirm sidebar entries appear under "Network Token (Network-level)"

Document the new POST /integration/network/token endpoint with
privilege support and the POST /integration/network/device endpoint
for network-level device provisioning.
@Freddyminu
Copy link
Copy Markdown
Collaborator

@FabianoEger This isn't in prod yet, let me know if you have any blockers for this to be merged.

@Freddyminu Freddyminu self-requested a review May 18, 2026 21:06
Copy link
Copy Markdown
Collaborator

@Freddyminu Freddyminu left a comment

Choose a reason for hiding this comment

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

While checking the pages I found this bug on the horizontal scroll:

Image

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