# Create a new placement

Endpoint: POST /api/v1/placements
Version: 0.0.1
Security: user_session, form_session, component_session, component_token, api_token

## Request fields (application/json):

  - `employee_id` (string, required)
    Employee Identifier

  - `employer_id` (any)

  - `client_id` (any)

  - `job_id` (any)

  - `custom_attributes` (object)
    Record of custom attribute values keyed by string path.

  - `create_tasks` (boolean)

## Response 201 fields (application/json):

  - `id` (string, required)
    Placement Identifier

  - `employee_id` (string, required)
    Employee Identifier

  - `employer_id` (any, required)

  - `client_id` (any, required)

  - `job_id` (any, required)

  - `custom_attributes` (object, required)
    Record of custom attribute values keyed by string path.

  - `created_at` (string, required)
    a string to be decoded into a DateTime.Utc

  - `missing_task_count` (number, required)

  - `progress` (object, required)

  - `progress.forms_required` (number, required)

  - `progress.forms_completed` (number, required)

  - `form_requirements` (array, required)

  - `form_requirements.task_id` (any, required)

  - `form_requirements.form` (object, required)

  - `form_requirements.form.id` (string, required)
    Form Identifier (lineage uid)

  - `form_requirements.form.name` (string, required)

  - `form_requirements.form.tags` (array, required)

  - `form_requirements.form_id` (string, required)
    Form Identifier (lineage uid)

  - `form_requirements.form_name` (string, required)

  - `form_requirements.form_tags` (array, required)

  - `suggested_tasks` (array, required)

## Response 401 fields (application/json):

  - `message` (string, required)

  - `_tag` (string, required)
    Enum: "Unauthorized"

## Response 403 fields (application/json):

  - `message` (string, required)

  - `_tag` (string, required)
    Enum: "Forbidden"

## Response 404 fields (application/json):

  - `message` (string, required)

  - `_tag` (string, required)
    Enum: "ResourceNotFoundError"

## Response 409 fields (application/json):

  - `message` (string, required)

  - `meta` (object, required)

  - `meta.placementId` (string, required)
    Placement Identifier

  - `_tag` (string, required)
    Enum: "PlacementConflictError"