Sharing & Collaboration

NovaKit allows you to share your AI work with team members or publicly. Share conversations, custom agents, and agent runs with three visibility levels.

Team Plan Required — Sharing with team members or via public links requires an active Team plan. Free and Pro users can only use Private visibility. Upgrade to Team →

Visibility Levels

Private (Default)

Only you can access
Default for all new resources
Full control over your work
Available on all plans

Team

All organization members can view
Members can fork to their own account
Great for internal knowledge sharing
Requires Team plan

Public Link

Anyone with the link can view
Visitors can fork to their account
Perfect for showcasing work or sharing with clients
Requires Team plan

Shareable Resources

Conversations

Share entire chat threads with full message history:

All messages preserved
Markdown rendering
Code syntax highlighting

AI Agents

Share custom agent configurations:

System prompt
Model settings
Tool selections
Sample prompts

Agent Runs

Share specific execution results:

Step-by-step timeline
Tool inputs and outputs
Token usage and timing

From the UI

Open the resource you want to share (conversation, agent, or run)
Click the Share button (or select Share from the menu)
Choose visibility level:
- Private: Only you
- Team: All org members
- Public: Anyone with link
Copy the share link (for Public visibility)
Click Save Changes

┌─────────────────────────────────────┐
│  Share Conversation                 │
├─────────────────────────────────────┤
│  Visibility                         │
│  ○ Private - Only you               │
│  ○ Team - All team members          │
│  ● Public Link - Anyone with link   │
├─────────────────────────────────────┤
│  ⚠️ Public visibility               │
│  Anyone with the link can view      │
│  and fork this resource.            │
├─────────────────────────────────────┤
│  Share link                         │
│  [https://www.novakit.ai/sha...] [Copy] │
├─────────────────────────────────────┤
│  [Cancel]              [Save]       │
└─────────────────────────────────────┘

Forking

When viewing a shared resource, you can fork it to your own account:

Visit the shared link
Click "Fork to my account"
Sign in if needed
The resource is copied to your account

Fork Behavior

Forked copies are completely independent
Changes don't affect the original
Forked resources start as Private
You have full edit access

Team members see shared resources in dedicated sections:

Conversations

Shared tab in the chat sidebar
Click to view the shared conversation
Fork to continue in your own thread

Agents

Shared tab on the agents page
View agent configuration
Fork to customize and run

API Access

Update Visibility

POST /api/v1/share
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "resourceType": "conversation",
  "resourceId": "conv_abc123",
  "visibility": "public"
}

Response:

{
  "visibility": "public",
  "shareToken": "abc123xyz789...",
  "shareUrl": "https://www.novakit.ai/shared/conversation/abc123xyz789..."
}

Get Shared Resource (Public)

GET /api/v1/share/{token}?type=conversation

Response:

{
  "resourceType": "conversation",
  "resource": {
    "id": "conv_abc123",
    "title": "AI Research Discussion",
    "messages": [...]
  }
}

Fork a Shared Resource

POST /api/v1/fork
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "resourceType": "conversation",
  "shareToken": "abc123xyz789..."
}

Response:

{
  "conversation": {
    "id": "conv_xyz789",
    "title": "AI Research Discussion (Copy)",
    "visibility": "private"
  }
}

Security

128-bit entropy (22 characters)
Cryptographically secure
Impossible to guess

Team Verification

Team shares verify org membership
Access denied if not in same org
RLS policies enforce access

Instant Revoke

Set to Private to revoke all access
Share links immediately stop working
Team members lose access

Best Practices

Use Team visibility for internal templates
Share successful agent configurations
Build a library of useful conversations

Review content before making public
Remove any sensitive information
Use for portfolios and demos

For Security

Regularly review shared resources
Revoke access when no longer needed
Use Team over Public when possible

Troubleshooting

Team and Public visibility require an active Team plan
Upgrade at novakit.ai/pricing
Private visibility is available on all plans

"Conversation not found"

The share link may have been revoked
You may need to be logged in for team shares
Try forking instead of viewing directly

"Please log in to fork"

Fork requires authentication
Sign in to your NovaKit account
Then retry the fork

Save changes after selecting Public
Token generates on first save to Public
Try refreshing and saving again

On this page