---
title: "Edit Risk Assessment"
method: PUT
path: "/v2/risk/assessment/{assessment_id}"
tags: ["Risk Assessment"]
---

# Edit Risk Assessment

`PUT /v2/risk/assessment/{assessment_id}`

## Request

- Base URL: `https://api.expent.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.expent.ai/v2/risk/assessment/{assessment_id}`
- Auth: none declared. Required headers: `authorization`
- TypeScript: <https://skmtc.dev/expent/apis/expent-apis/docs/v2/risk/assessment/:assessment_id/put.ts> (a function with typed inputs; its response is checked against the schema)

Update assessment identified by assesssment id. Allows to update the field which are define custom during cofiguration.

Body:


    {

        "name": "string",
        "entity": "string",
        "owner": "string"
        "status":"NOT_STARTED|IN_PROGRESS|COMPLETED"
        "<column slug for custom field>":"value for custom vield"
    }


Note :- Refer the Create Assessement documentation for details on how values should be passed.

## Path parameters

- `assessment_id` string, required

## 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

- EditRiskAssessment
  - `name` string
  - `owner` string
  - `status` 'NOT_STARTED' | 'IN_PROGRESS' | 'COMPLETED' | 'CLOSED': An enumeration.

## Response `200`

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
- `404`: Not Found
- `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.dev/expent/apis/expent-apis/revisions/ce1d50af5e2c?raw)