---
title: "Create Risk"
method: POST
path: "/v2/risk/register"
tags: ["Risk Register"]
---

# Create Risk

`POST /v2/risk/register`

Create new risk for a entity(vendor) with given name. Allows to update the field which are define custom during cofiguration.

Body:

    {

        "name": "string",
        "entity": "string",
        "owner": "string"
        "<column slug for custom field>":"value for custom vield"
    }


Documentation for Item Types
============================

Below are the format based on column types which are supposed to be sent as value
1. **Text**
-----------
- **Description**: Handles plain textual data.
- **Input Example**: `"Hello, World!"`

2. **RichText**
---------------
- **Description**: Manages text with rich text formatting elements.
- **Input Example**: `"Hello, World!"`

3. **DateInterval (DATEDELTA)**
-------------------------------
- **Description**: Represents an interval of dates.Intervals allowed: "month", "week", "day", "year" and "hour".
- **Input Example**: `{"size": 10, "interval": "day"}`

4. **Date**
-----------
- **Description**: Manages a single date value. input as %Y-%m-%d format, output as ISO 8601 format
- **Input Example**: `"2023-01-01"`

5. **SingleSelect**
-------------------
- **Description**: Handles the selection of a single option from a set of choices.Please take a look at args for 'item' of type SingleSelect,
Input is the key of the option to be selected,
output is the value of the option selected.
- **Input Example**: `2`

6. **Binary**
-------------
- **Description**: Manages binary values, typically representing true or false.
- **Input Example**: `True`

7. **MultiSelect**
------------------
- **Description**: Handles the selection of multiple options from a list.Please take a look at args for 'item' of type MultiSelect.Input is the list of keys of the options to be selected,
output is the list of values of the options selected.
- **Input Example**: `[0, 2]`

8. **Phone**
------------
- **Description**: Processes phone number data.
- **Input Example**: `"+1-123-456-7890"`

9. **Email**
------------
- **Description**: Manages email address information.
- **Input Example**: `"user@example.com"`

10. **User**
------------
- **Description**: Validates and saves expent user-related data. Input is the array of user ids.
- **Input Example**: `[76]`

11. **Team**
-----------
- **Description**: Validates and saves expent team-related data. Input is the array of team ids.
- **Input Example**: `[33]` [Team Id]

12. **Number**
--------------
- **Description**: Manages numerical values.
- **Input Example**: `42`

13. **File**
-----------
- **Description**: Processes file data.
- **Input Example**: `{"filename": "document.txt", "filetype": "txt", "url": "http://example.com/document.txt"}`

14. **Url**
-----------
- **Description**: Manages web URLs.
- **Input Example**: `"http://example.com"`

15. **Currency**
----------------
- **Description**: Processes currency data.
- **Input Example**: `{"amount": 100, "currency": "USD"}`

## Headers

- `authorization` string, required — The authorization token can be retrieved by calling the OAuth authentication API. The value for this header parameter follows the format "Bearer &nbsp;&nbsp; `access_token`" (excluding the quotes). For example: <br /> `Bearer MZA1YJMYZDKTZTFMMI0ZYZG1LTLMMDGTYTG4NJG2YZC3NJGY`

## Request body

- CreateRiskAssessment
  - `name` string, required
  - `entity` string, required
  - `owner` string

## Response `201`

Successful Response

- FetchRiskAssessmentByIdResponseExternal
  - `id` string, required
  - `name` string, required
  - `entity` ServicesRiskSchemaRiskEntityResponse, required
    - `id` string, required
    - `name` string, required
    - `logo` string, required
  - `owner` ServicesRiskSchemaRiskUserResponse
    - `id` string, required
    - `name` string, required
    - `email` string, required
  - `status` 'NOT_STARTED' | 'IN_PROGRESS' | 'COMPLETED' | 'CLOSED', required — An enumeration.
  - `start_date` string, date-time
  - `end_date` string, date-time
  - `created_by` ServicesRiskSchemaRiskUserResponse, required
    - `id` string, required
    - `name` string, required
    - `email` string, required
  - `columns` ColumnResponse[]
    - `slug` string, required
    - `name` string, required
    - `seq` integer, required
    - `type` 'TEXT' | 'RICHTEXT' | 'DATEDELTA' | 'DATE' | 'SINGLESELECT' | 'BINARY' | 'MULTISELECT' | 'PHONE' | 'EMAIL' | 'USER' | 'TEAM' | 'NUMBER' | 'FILE' | 'URL' | 'CURRENCY' | 'PICKLISTSELECT' | 'ENTITY' | 'CONTRACT' | 'TABLE_REFERENCE' | 'CHILD_TABLE' | 'ACTION' | 'PROJECT' | 'TAGS' | 'CATEGORIES', required — An enumeration.
    - `args` object
    - `collaborators` CollaboratorsResponse
      - `users` ServicesTableSchemaCollaboratorsUserResponse[], required
        - `id` string, required
        - `name` string, required
        - `email` string, required
        - `permission` string
      - `teams` ServicesTableSchemaCollaboratorsTeamResponse[], required
        - `id` string, required
        - `name` string, required
        - `permission` string
        - `user_ids` string[]
      - `entity` EntityCollaborationResponse
        - `allow_collaboration` boolean, required
        - `allow_edit` boolean, required
        - `entity_column` string, required
        - `permission` string
    - `is_hidden` boolean, required
    - `computation` ComputationArgs
      - `type` 'NONE' | 'FORMULA' | 'CONDITION' | 'CATALOG_LOOKUP' | 'TABLE_LOOKUP' | 'AI_PROMPT' | 'GENERAL', required — An enumeration.
      - `args` union
        - FormulaArg
          - `expression` string
          - `separator` string
        - ConditionArg
          - `rules` Rule[]
            - `type` 'IF' | 'ELSE', required — An enumeration.
            - `condition` Condition[], required
              - …
            - `interpolation` RuleInterpollation, required
              - …
            - `description` string
        - object
    - `description` string
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `permitted` boolean
    - `is_required` boolean
    - `is_default` boolean
    - `hide_from_listing` boolean
    - `read_only` boolean
    - `sorting` 'ASC' | 'DESC' | 'NONE' — An enumeration.
    - `display_name` boolean
    - `show_in_add_form` boolean
    - `hide_from_config` boolean
    - `permission` string
    - `is_unique` boolean
    - `recompute_on_duplicate` boolean

## Other responses

- `401` — Unauthorized
- `422` — Validation Error

---

[API](https://skmtc.dev/expent/apis/expent-apis.md) · [All operations](https://skmtc.dev/expent/apis/expent-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/expent/expent-apis/revisions/ce1d50af5e2c/schema)