> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wellapp.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Company Roles

> Relationship types that define how people are connected to companies

## Available Company Roles

<div className="grid grid-cols-1 md:grid-cols-2 gap-6">
  <div className="border rounded-lg p-4">
    <h3 className="text-lg font-semibold text-blue-600 mb-2">contact</h3>
    <p className="text-gray-600 mb-3">General business contact</p>

    <ul className="list-disc list-inside text-sm space-y-1">
      <li>External business contact</li>
      <li>Client or customer representative</li>
      <li>Vendor or supplier contact</li>
      <li>General networking connection</li>
    </ul>
  </div>

  <div className="border rounded-lg p-4">
    <h3 className="text-lg font-semibold text-green-600 mb-2">employee</h3>
    <p className="text-gray-600 mb-3">Company employee</p>

    <ul className="list-disc list-inside text-sm space-y-1">
      <li>Full-time or part-time staff</li>
      <li>Contractor or freelancer</li>
      <li>Temporary worker</li>
      <li>Intern or trainee</li>
    </ul>
  </div>

  <div className="border rounded-lg p-4">
    <h3 className="text-lg font-semibold text-purple-600 mb-2">owner</h3>
    <p className="text-gray-600 mb-3">Business owner or principal</p>

    <ul className="list-disc list-inside text-sm space-y-1">
      <li>Company founder or co-founder</li>
      <li>Business owner or partner</li>
      <li>Shareholder or investor</li>
      <li>Principal or managing director</li>
    </ul>
  </div>

  <div className="border rounded-lg p-4">
    <h3 className="text-lg font-semibold text-orange-600 mb-2">other</h3>
    <p className="text-gray-600 mb-3">Other relationship types</p>

    <ul className="list-disc list-inside text-sm space-y-1">
      <li>Board member or advisor</li>
      <li>Consultant or specialist</li>
      <li>Legal or financial representative</li>
      <li>Any other business relationship</li>
    </ul>
  </div>
</div>

## Company Roles Comparison Table

<div className="overflow-x-auto">
  <table>
    <thead>
      <tr>
        <th>Role</th>
        <th>Description</th>
        <th>Internal/External</th>
        <th>Decision Making</th>
        <th>Access Level</th>
        <th>Common Use Cases</th>
      </tr>
    </thead>

    <tbody>
      <tr>
        <td>
          <strong className="text-purple-600">owner</strong>
        </td>

        <td>Business owner or principal</td>
        <td>🏢 Internal</td>
        <td>✅ High authority</td>
        <td>🔓 Full access</td>
        <td>Founders, partners, directors</td>
      </tr>

      <tr>
        <td>
          <strong className="text-green-600">employee</strong>
        </td>

        <td>Company employee</td>
        <td>🏢 Internal</td>
        <td>⚠️ Role-dependent</td>
        <td>🔐 Limited access</td>
        <td>Staff, contractors, interns</td>
      </tr>

      <tr>
        <td>
          <strong className="text-blue-600">contact</strong>
        </td>

        <td>General business contact</td>
        <td>🌐 External</td>
        <td>❌ No authority</td>
        <td>👁️ View only</td>
        <td>Clients, vendors, networking</td>
      </tr>

      <tr>
        <td>
          <strong className="text-orange-600">other</strong>
        </td>

        <td>Other relationship types</td>
        <td>🔄 Mixed</td>
        <td>⚠️ Context-dependent</td>
        <td>🔐 Variable</td>
        <td>Advisors, consultants, board</td>
      </tr>
    </tbody>
  </table>
</div>

## Usage in API

When creating or updating company-person relationships, use these exact role values:

```json theme={null}
{
  "relationship_type": "employee"
}
```

**Valid values:** `contact`, `employee`, `owner`, `other`

## Examples

### Creating a Company-Employee Relationship

```json theme={null}
{
  "data": {
    "type": "people",
    "id": "person-123",
    "meta": {
      "relationship_type": "employee"
    }
  }
}
```

### Creating a Company-Contact Relationship

```json theme={null}
{
  "data": {
    "type": "people",
    "id": "person-456",
    "meta": {
      "relationship_type": "contact"
    }
  }
}
```