Bytes API

The public Developer API is the /api/v1/* API. It uses a workspace API key and is designed for trusted server-side integrations.

Current scope

• create, list, read, update and archive links
• resolve Activity Groups
• assign links to Activity Groups
• manage workspace tags
• attach and remove link tags

API base URL

https://api.jaww.ws/api/v1

Public endpoints

Method	Path	Purpose
GET	/activity-groups	List or resolve workspace Activity Groups
GET	/links	List workspace links
POST	/links	Create a link, optionally assigned to an Activity Group
GET	/links/{id}	Read one link
PATCH	/links/{id}	Update a link or reconcile its Activity Group
DELETE	/links/{id}	Archive a link
GET	/tags	List tags
POST	/tags	Create a tag
PATCH	/tags/{id}	Update a tag
DELETE	/tags/{id}	Delete a tag
POST	/links/{id}/tags	Attach tags
DELETE	/links/{id}/tags/{tagId}	Remove a tag

CLI

npm install -g @jawwws/bytes-cli
bytes activity-groups list --slug blog

See the CLI guide.

API keys

Create keys in:

Workspace Settings -> Developer API

Each key belongs to one workspace.

Store keys in environment variables or a secrets manager. Never expose them in browser code, static pages, logs or screenshots.

Start building

• Getting started
• Authentication
• Create and manage links
• Activity Groups
• Bytes CLI
• API reference
• OpenAPI

Do not build external integrations against undocumented dashboard routes.