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

# Add candidate additional information

> ### Create Company Candidate IT Skill

This endpoint allows the addition of a new IT skill for a candidate within a company.

#### Request Body

- `user_slug` (string): The unique identifier of the user.
    
- `skill_name` (string): The name of the IT skill.
    
- `skill_level_id` (integer): The level of proficiency in the IT skill (1 - 4).
    

#### Response

The response is in JSON format with the following schema:

``` json
{
    "message": "string"
    "status": "integer"
}

 ```

- `message` (string): A message related to the request.
    
- `status` (integer): The status of the request.
    

Example:

``` json
{
    "message": "Candidate job input successfully",
    "status": 201
}

 ```



## OpenAPI

````yaml post /gin/v1/company/candidate/additional-information
openapi: 3.0.0
info:
  title: Pauls Job Public Endpoints
  description: >-
    #### **Description:**


    This API provides a comprehensive suite of endpoints for managing user
    authentication, session control, and other key functionalities within the
    application for Pauls Job. The endpoints are designed to ensure secure and
    efficient communication between clients and the server, offering robust
    access control mechanisms through token-based authentication.


    #### **Key Features:**


    - **Authentication:** Allows users to securely log in using their
    credentials and receive a token for accessing protected resources.
        
    - **Session Management:** Provides a logout mechanism to securely end user
    sessions and invalidate tokens.
        
    - **Error Handling:** Clear and descriptive error messages ensure that
    issues such as invalid credentials, expired tokens, or missing parameters
    are easily identifiable.
        

    This API is built with a focus on security and ease of use, making it
    essential for integrating user authentication and session management into
    applications while maintaining a high standard of data protection.
  version: 1.0.0
servers:
  - url: https://api.hyrd.de
security: []
tags:
  - name: Users
    description: >-
      #### **Description:**


      The folder contains the foundational information and essential API
      endpoints for starting with the authentication and session management of
      the application. This includes the critical login and logout
      functionalities, which are necessary for users to authenticate and manage
      their sessions securely.


      #### **APIs Included:**


      1. **Login API**: Allows users to log in by providing their credentials
      and receive an authentication token.
          
      2. **Logout API**: Enables users to log out by invalidating the token and
      ending their session.
          

      These endpoints are designed to facilitate secure access control and
      session handling, making them an essential starting point for any
      interaction with the platform's protected resources.
  - name: General
  - name: Company
  - name: Company > Candidate
  - name: Company > Api Integrations
paths:
  /gin/v1/company/candidate/additional-information:
    post:
      tags:
        - Company > Candidate
      summary: Add candidate additional information
      description: >-
        ### Create Company Candidate IT Skill


        This endpoint allows the addition of a new IT skill for a candidate
        within a company.


        #### Request Body


        - `user_slug` (string): The unique identifier of the user.
            
        - `skill_name` (string): The name of the IT skill.
            
        - `skill_level_id` (integer): The level of proficiency in the IT skill
        (1 - 4).
            

        #### Response


        The response is in JSON format with the following schema:


        ``` json

        {
            "message": "string"
            "status": "integer"
        }

         ```

        - `message` (string): A message related to the request.
            
        - `status` (integer): The status of the request.
            

        Example:


        ``` json

        {
            "message": "Candidate job input successfully",
            "status": 201
        }

         ```
      parameters:
        - name: Authorization
          in: header
          schema:
            type: string
          example: '{{company-api-key}}'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              example: |-
                {
                    "user_slug": "39c12359-7eaf-407d-9be7-97f522a1e7f2",
                    "title": "Hello", // required
                    "description": "some description", // optional
                    "start_date": "12-12-2024", // optional
                    "end_date": "13-12-2024" // optional
                }
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}

````