Skip to main content

​
Sharing & Visibility

Roulette provides granular control over who can access company data within your team.

​
Visibility Levels

Each company can have one of three visibility settings:

Private

Only visible to the user who created it

Shared

Visible to specific users you choose

Team

Visible to all team members (default)

​
Setting Visibility

When creating a company via the AI upload endpoint: 
curl -X POST "https://www.useroulette.com/api/v1/companies/upload/ai" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "account_id=YOUR_ACCOUNT_ID" \
  -F "text=Company info here" \
  -F "name=Stealth Startup" \
  -F "visibility=private"
Or update an existing company: 
curl -X PATCH "https://www.useroulette.com/api/v1/companies/{company_id}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "visibility": "team"
  }'

​
Filtering by Visibility

List companies with a specific visibility level: 
curl -X GET "https://www.useroulette.com/api/v1/companies?visibility=private" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Company Assignees

Companies can have team members assigned to them. Assignees are returned with the company data: 
{
  "id": "company-uuid",
  "name": "Acme Corp",
  "assignees": [
    {
      "id": "user-uuid",
      "name": "Jane Smith",
      "email": "jane@example.com",
      "picture_url": "https://..."
    }
  ]
}
Visibility settings work in conjunction with your team’s roles and permissions. Even with “team” visibility, users must have the appropriate permissions to view companies.

Companies API

List and filter companies

Company Concepts

Learn about company properties