**Source URL:** https://limited.veevavault.dev/commercial/vault-api/api-reference/23.3/document-lifecycle-workflows/lifecycle-role-assignment-rules/create-lifecycle-role-assignment-override-rules.md

# Create Lifecycle Role Assignment Override Rules



<Endpoint path="/api/{version}/configuration/role_assignment_rule" method="POST"></Endpoint>

## Headers {#headers}

<FieldTable>
| Name | Description |
| --- | --- |
| `Content-Type` | `application/json` or `text/csv` |
| `Accept` | `application/json` (default) or `application/xml` or `text/csv` |
</FieldTable>

## Body Parameters {#body-parameters}

Before submitting this request, prepare a JSON or CSV input file with the following information:

<FieldTable>
| Name | Description |
| --- | --- |
| `name__v` | The `name__v` field values of the lifecycle and role to which the override rule is being added. |
| `name__v` | The `name__v` field values of the allowed and default groups who will be assigned to the role when the override condition is met. |
| `id` | The `id` or `name__v` field values of the object records which define the override condition. |
| `user_name__v` | The `user_name__v` field values of the allowed and default users who will be assigned to the role when the override condition is met. |
</FieldTable>
Note the following scope and limitations:

* This request can only be used to specify the override rules (conditions, users, and groups). It cannot be used to create default rules.

* The input may include override rules for multiple lifecycles and roles.

* Each role may be configured with multiple override rules.

## Example CSV & JSON Input Files {#example-csv--json-input-files}

Create an override rule on the `editor__c` role of the `general_lifecycle__c` with the following override conditions, users, and groups:

<FieldTable>
| `lifecycle__v` | `role__v` | `product__v.name__v` | `country__v.name__v` | `allowed_users__v` | `allowed_groups__v` | `allowed_default_users__v` | `allowed_default_groups__v` |
| --- | --- | --- | --- | --- | --- | --- | --- |
| `general_lifecycle__c` | `editor__c` | CholeCap | United States | "[etta@veevapharm.com](mailto:etta@veevapharm.com),[finn@veevapharm.com](mailto:finn@veevapharm.com),[greg@veevapharm.com](mailto:greg@veevapharm.com),[hope@veevapharm.com](mailto:hope@veevapharm.com)" | "`cholecap_us_docs_group__c`,`cholecap_us_research_group__c`,`cholecap_us_compliance_group__c`,`cholecap_us_product_management_group__c`" | [etta@veevapharm.com](mailto:etta@veevapharm.com) | `cholecap_us_docs_group__c` |
</FieldTable>

```
[
{
    "lifecycle__v": "general_lifecycle__c",
    "role__v": "editor__c",
    "product__v.name__v": "CholeCap",
    "country__v.name__v": "United States",
    "allowed_users__v": [
        "etta@veepharm.com",
        "finn@veepharm.com",
        "greg@veepharm.com",
        "hope@veepharm.com"
    ],
    "allowed_groups__v": [
        "cholecap_us_docs_group__c",
        "cholecap_us_research_group__c",
        "cholecap_us_compliance_group__c",
        "cholecap_us_product_management_group__c"
    ],
    "allowed_default_users__v": [
        "etta@veepharm.com"
    ],
    "allowed_default_groups__v": [
        "cholecap_us_docs_group__c"
    ]
}
]

```

## Request Details {#request-details}

In this example:

* The input file format is set to JSON.

* The response format is not set and will default to JSON.

* The path/name of the JSON input file is specified.

## Request {#request}

<CodeExample title="">
```
curl -X POST -H "Authorization: {SESSION_ID}" \
-H "Content-Type: application/json" \
--data-binary @"C:\Vault\Override Rules\create-lifecycle-role-override-rules.json" \
https://myvault.veevavault.com/api/v15.0/configuration/role_assignment_rule

```
</CodeExample>

## Response {#response}

<CodeExample title="">
```
{
    "responseStatus": "SUCCESS",
    "data": [
        {
            "responseStatus": "SUCCESS"
        }
    ]
}

```
</CodeExample>

## Response Details {#response-details}

For each override rule specified in the input, the response includes a SUCCESS or FAILURE message.



---

**Previous:** [Retrieve Lifecycle Role Assignment Rules (Default & Override)](/commercial/vault-api/api-reference/23.3/document-lifecycle-workflows/lifecycle-role-assignment-rules/retrieve-lifecycle-role-assignment-rules-default-override)  
**Next:** [Update Lifecycle Role Assignment Rules (Default & Override)](/commercial/vault-api/api-reference/23.3/document-lifecycle-workflows/lifecycle-role-assignment-rules/update-lifecycle-role-assignment-rules-default-override)