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

# Assign role

> Assign a role to a collaborator



## OpenAPI

````yaml post /v1/collaborators/{id}/assign-role
openapi: 3.1.0
info:
  title: Capital Check In API
  description: >-
    API for the Capital Check In platform - Employee check-in management system
    with identity verification, geolocation, and schedule management
  license:
    name: MIT
  version: 1.0.0
  contact:
    name: Capital Check In Support
    email: hi@capitalcheckin.app
    url: https://capitalcheckin.app
servers:
  - url: https://api.capitalcheckin.app
    description: Production
security:
  - bearerAuth: []
paths:
  /v1/collaborators/{id}/assign-role:
    post:
      tags:
        - Collaborators
      summary: Assign role
      description: Assign a role to a collaborator
      parameters:
        - name: id
          in: path
          required: true
          description: Collaborator ID
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RoleAssignmentRequest'
      responses:
        '200':
          description: Role assigned successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Collaborator'
      security:
        - bearerAuth: []
components:
  schemas:
    RoleAssignmentRequest:
      type: object
      required:
        - role
      properties:
        role:
          type: string
          enum:
            - admin
            - manager
            - employee
          description: Role to assign
        permissions:
          type: array
          items:
            type: string
          description: Additional permissions
    Collaborator:
      type: object
      properties:
        id:
          type: string
          description: Unique collaborator identifier
        name:
          type: string
          description: Full name of the collaborator
        email:
          type: string
          format: email
          description: Email address
        phone:
          type: string
          description: Phone number
        position:
          type: string
          description: Job position or title
        department:
          type: string
          description: Department or team
        status:
          type: string
          enum:
            - active
            - inactive
            - pending
          description: Collaborator status
        role:
          type: string
          enum:
            - admin
            - manager
            - employee
          description: Collaborator role
        hire_date:
          type: string
          format: date
          description: Date when collaborator was hired
        salary:
          type: number
          description: Annual salary
        manager_id:
          type: string
          description: ID of the manager
        work_schedule:
          type: string
          description: Work schedule (full-time, part-time, etc.)
        location:
          type: string
          description: Work location
        avatar_url:
          type: string
          format: uri
          description: Profile picture URL
        emergency_contact:
          type: object
          properties:
            name:
              type: string
              description: Emergency contact name
            phone:
              type: string
              description: Emergency contact phone
            relationship:
              type: string
              description: Relationship to collaborator
        created_at:
          type: string
          format: date-time
          description: Creation timestamp
        updated_at:
          type: string
          format: date-time
          description: Last update timestamp
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: OAuth2
      description: OAuth2 access token for authentication

````