File Sharing Guide

NeuroGen's file sharing system lets you create secure, shareable links for your files. These links work with AI agents, Custom GPTs, and anyone you share them with.

Creating a Share Link

From My Files

1. Navigate to Dashboard > My Files
2. Find the file or session you want to share
3. Click the Share button (share icon)
4. Configure your share settings
5. Click Create Share Link
6. Copy the generated URL

Share Options

When creating a share link, you can configure:

Permission Levels

View Only

• Can preview file contents in browser
• Cannot download files
• Best for: Sharing previews, read-only access

Download

• Can preview and download files
• Cannot access raw content API
• Best for: Sharing files with humans

Full Access

• Can preview and download files
• Can access raw content via /content/ API endpoint
• Required for AI agents and Custom GPTs
• Best for: AI integration, Custom GPTs, automated systems

Quick Share Presets

For convenience, we offer three preset configurations:

Quick Share

• Download permission
• 7-day expiration
• No password
• Best for: Quick sharing with colleagues

AI Agent Access

• Full Access permission
• 30-day expiration
• No password
• Best for: Custom GPTs and AI integrations

Secure Share

• Download permission
• 24-hour expiration
• Password required
• Best for: Sensitive documents

Managing Your Shares

Viewing Active Shares

1. Go to Dashboard > My Files
2. Click the Shares tab
3. View all your active and expired shares

Each share shows: - Target file/session name - Permission level - Status (Active, Expired, Revoked) - Expiration time - Access count - Actions (Copy URL, Revoke)

Revoking a Share

To immediately disable a share link:

1. Go to My Files > Shares
2. Find the share to revoke
3. Click the Revoke button
4. Confirm revocation

Revoked links return "Share has been revoked" to anyone who tries to use them.

Copying Share URLs

Click the Copy button next to any share to copy the full URL to your clipboard.

Share URL Format

Share links follow this format:

https://neurogen.cc/share/{token}

Where {token} is a unique, secure identifier for your share.

Password-Protected Shares

For sensitive content:

1. Check "Password protected" when creating share
2. Enter a strong password
3. Share the password separately from the link

When accessing a password-protected share: - Browsers show a password prompt page - API clients use the X-Share-Password header

Expiration Options

Access Limits

Limit how many times a share can be accessed:

Sharing Individual Files vs Sessions

Individual File Share

• Shares a single specific file
• Recipient can only access that file
• Use when sharing one document

Session Share

• Shares all files in a session
• Recipient can access any file in the session
• Use when sharing related files (e.g., all outputs from a processing job)

Security Best Practices

1. Use expiration dates - Don't create permanent links unless necessary
2. Password protect sensitive files - Add passwords for confidential content
3. Use access limits - Limit single-use for very sensitive files
4. Review active shares - Regularly check and revoke old shares
5. Match permission to need - Don't grant Full Access unless AI integration is needed

Troubleshooting

"Share not found"

• Link may have been revoked
• Token may be incorrect
• Check for typos in URL

"Share has expired"

• Create a new share with longer expiration
• Contact file owner for new link

"Password required"

• Enter password on the prompt page
• For API: use X-Share-Password header
• Contact file owner for password

"Download not permitted"

• Share has View-only permission
• Request a new share with Download or Full Access

"Access limit reached"

• Share has hit maximum access count
• Contact file owner for new link

Next: Custom GPT Integration