For the complete documentation index, see llms.txt. This page is also available as Markdown.

User Defined Objects (UDO)

Udo Get

get
/apis/userdefinedobjects/v1/

This API retrieves list of all user defined objects created in the system.

Responses
200

Get User Defined Object

application/json
compliance_idstringRequired

A system-generated compliance ID on creating or updating the policy

compliance_namestringRequired

Name of the policy.

created_bystringRequired

ID of the user who created the policy. Example: username@rightrev.com

created_onintegerRequired

Timestamp of the policy created by the user. This is a unix Epoch timestamp format.

last_modified_bystringRequired

ID of the user last modified by.

last_modified_onintegerRequired

Timestamp of the policy last modified on. This is a unix Epoch timestamp format.

get/apis/userdefinedobjects/v1/
GET /apis/userdefinedobjects/v1/ HTTP/1.1
Host: {realm}.{env}.rightrev.cloud/
Accept: */*
200

Get User Defined Object

[
  {
    "compliance_id": "c447c519-aecf-4d4a-9ab4-4ba85a0c60d1",
    "compliance_name": "user-defined-objects",
    "compliance_spec": [
      {
        "created_at": 1760014737,
        "created_by": "raviteja.d@rightrev.com",
        "guid": "d74c9ab7-66f9-4b4b-8b4f-30ead1e0bbed",
        "object_description": "",
        "object_freeze": true,
        "object_name": "TEST_RRAPI_QA_CUSTOM10",
        "total_fields": 1,
        "updated_at": 1760014827,
        "updated_by": "raviteja.d@rightrev.com"
      }
    ],
    "created_by": "RIGHTREV",
    "created_on": 1772517485,
    "last_modified_by": "RIGHTREV",
    "last_modified_on": 1772517485
  }
]

Udo Post

post
/apis/userdefinedobjects/v1/

This API used to create new user defined objects in the system.

Body
object_namestringRequired

Name of the obejct to be created. It should start with Tenant ID.

descriptionstringRequired

Description of the object.

Responses
200

Create User Defined Object

application/json
stringOptional
post/apis/userdefinedobjects/v1/
POST /apis/userdefinedobjects/v1/ HTTP/1.1
Host: {realm}.{env}.rightrev.cloud/
Content-Type: application/json
Accept: */*
Content-Length: 68

{
  "object_name": "TEST_RRAPI_QA_CUSTOM_06",
  "description": "New object"
}
200

Create User Defined Object

{}

Udo Object Get

get
/apis/userdefinedobjects/v1/{object_name}

This API is used to retrieve all the field level details created in the object.

Path parameters
object_namestringRequired

Provide name of the object.

Query parameters
freezebooleanRequired

A boolean field indicating object is freezed or not.

Responses
200

Get User Defined Object

application/json
compliance_idstringRequired

A system-generated compliance ID on creating or updating the policy.

compliance_namestringRequired

Name of the policy.

created_bystringRequired

ID of the user who created the policy. Example: username@rightrev.com

created_onintegerRequired

Timestamp of the policy created by the user. This is a unix Epoch timestamp format.

last_modified_bystringRequired

ID of the user last modified by.

last_modified_onintegerRequired

Timestamp of the policy last modified on. This is a unix Epoch timestamp format.

get/apis/userdefinedobjects/v1/{object_name}
GET /apis/userdefinedobjects/v1/{object_name}?freeze=true HTTP/1.1
Host: {realm}.{env}.rightrev.cloud/
Accept: */*
200

Get User Defined Object

[
  {
    "compliance_id": "ae3afc6c-4543-4371-9a6d-11e5ceeb7146",
    "compliance_name": "user-defined-objects",
    "compliance_spec": [
      {
        "created_at": 1748079523,
        "created_by": "raviteja.d@rightrev.com",
        "guid": "e78cb614-d6d4-4ef2-9a59-a8a98df79ed1",
        "object_description": "",
        "object_freeze": true,
        "object_name": "TEST_RRAPI_QA_CUSTOM_05",
        "object_structure": [
          {
            "data_type": "String / Character",
            "description": "",
            "field_name": "FIELD_01"
          },
          {
            "data_type": "Boolean",
            "description": "",
            "field_name": "FIELD_02"
          }
        ],
        "total_fields": 2,
        "updated_at": 1748079580,
        "updated_by": "raviteja.d@rightrev.com"
      }
    ],
    "created_by": "RIGHTREV",
    "created_on": 1772517985,
    "last_modified_by": "RIGHTREV",
    "last_modified_on": 1772517985
  }
]

Udo Freeze

post
/apis/userdefinedobjects/v1/{object_name}/freeze

This API is used to freeze the object.

Path parameters
object_namestringRequired

Provide object name.

Body
anyOptional
Responses
200

Freeze User Defined Object

application/json
messagestringRequired

Displays the outcome of the action. It is commonly used to provide success confirmations, error details, or other informational responses from the API after the operation is executed.

object_namestringRequired

Name of the Object.

post/apis/userdefinedobjects/v1/{object_name}/freeze
POST /apis/userdefinedobjects/v1/{object_name}/freeze HTTP/1.1
Host: {realm}.{env}.rightrev.cloud/
Content-Type: application/json
Accept: */*
Content-Length: 2

{}
200

Freeze User Defined Object

{
  "message": "object freezed",
  "object_name": "TEST_RRAPI_QA_CUSTOM_06"
}

Udo Fields Create

post
/apis/userdefinedobjects/v1/{object_name}/create_fields

This API is used to ceate new fileds in objects.

Path parameters
object_namestringRequired

Name of the Object.

Body
field_namestringRequired

Provide field name to be added.

data_typestringRequired

Data Type of the fields. For e.g. String Or Boolean Or Decimal etc.

descriptionstringRequired

Description of the field.

Responses
200

Create User Defined Object Fields

application/json
stringOptional
post/apis/userdefinedobjects/v1/{object_name}/create_fields
POST /apis/userdefinedobjects/v1/{object_name}/create_fields HTTP/1.1
Host: {realm}.{env}.rightrev.cloud/
Content-Type: application/json
Accept: */*
Content-Length: 80

{
  "field_name": "FILED_03",
  "data_type": "String / Character",
  "description": "test1"
}
200

Create User Defined Object Fields

{}

Udo Fields Delete

delete
/apis/userdefinedobjects/v1/{object_name}/field/{field_name}

This API is used to delete the fields created in obejct.

Path parameters
object_namestringRequired

Provide name of the Object.

field_namestringRequired

Provide Name of the field to be deleted.

Responses
200

Delete User Defined Object Fields

application/json
stringOptional
delete/apis/userdefinedobjects/v1/{object_name}/field/{field_name}
DELETE /apis/userdefinedobjects/v1/{object_name}/field/{field_name} HTTP/1.1
Host: {realm}.{env}.rightrev.cloud/
Accept: */*
200

Delete User Defined Object Fields

{}

Udo File Delete

delete
/apis/userdefinedobjects/v1/{object_name}/file/{file_id}

This API is to delete the CSV file uploaded in user defined objects.

Path parameters
object_namestringRequired

Provide name of the object.

file_idstringRequired

Provide file id. User can retrive file ID from GET call.

Responses
200

Delete User Defined Object File

application/json
stringOptional
delete/apis/userdefinedobjects/v1/{object_name}/file/{file_id}
DELETE /apis/userdefinedobjects/v1/{object_name}/file/{file_id} HTTP/1.1
Host: {realm}.{env}.rightrev.cloud/
Accept: */*
200

Delete User Defined Object File

{}

Udo File Get

get
/apis/userdefinedobjects/v1/{object_name}/file/{file_id}

This API is used to download the uploaded CSV file in user defined object.

Path parameters
object_namestringRequired

Provide name of the object.

file_idstringRequired

Provide file id. User can retrive file ID from GET call.

Responses
200

Get User Defined Object File

application/json
anyOptional
get/apis/userdefinedobjects/v1/{object_name}/file/{file_id}
GET /apis/userdefinedobjects/v1/{object_name}/file/{file_id} HTTP/1.1
Host: {realm}.{env}.rightrev.cloud/
Accept: */*
200

Get User Defined Object File

{}

Udo File Upload

post
/apis/userdefinedobjects/v1/{object_name}/file/upload

This API is used to upload CSV file in user defined object.

Path parameters
object_namestringRequired

Provide name of the object.

Body
date_formattext · %m/%d/%YRequired

Date Format

filefile · binaryRequired

Attach CSV file to be uploaded.

Responses
200

Upload User Defined Object File

application/json
file_idstringRequired

A system generated alpha-numeric number.

messagestringRequired

Displays the outcome of the action. It is commonly used to provide success confirmations, error details, or other informational responses from the API after the operation is executed.

post/apis/userdefinedobjects/v1/{object_name}/file/upload
POST /apis/userdefinedobjects/v1/{object_name}/file/upload HTTP/1.1
Host: {realm}.{env}.rightrev.cloud/
Content-Type: multipart/form-data
Accept: */*
Content-Length: 32

{
  "date_format": null,
  "file": null
}
200

Upload User Defined Object File

{
  "file_id": "828223ba-fce9-4328-bc90-5d8ed702bf87",
  "message": "file uploaded"
}

Udo File Template

get
/apis/userdefinedobjects/v1/{object_name}/template

This API is used to download the CSV Template file created for specific user defined objects.

Path parameters
object_namestringRequired

Provide name of the object.

Responses
200

Get User Defined Object File Template

application/json
anyOptional
get/apis/userdefinedobjects/v1/{object_name}/template
GET /apis/userdefinedobjects/v1/{object_name}/template HTTP/1.1
Host: {realm}.{env}.rightrev.cloud/
Accept: */*
200

Get User Defined Object File Template

{}

Udo Export

get
/apis/userdefinedobjects/v1/{object_name}/export

This API is used to export CSV file uploaded with all the details of user defined objects.

Path parameters
object_namestringRequired

Provide name of the obejct.

Responses
200

Export User Defined Object

application/json
compliance_idstringRequired

A system-generated compliance ID on creating or updating the policy

compliance_namestringRequired

Name of the policy.

created_bystringRequired

ID of the user who created the policy. Example: username@rightrev.com

created_onintegerRequired

Timestamp of the policy created by the user. This is a unix Epoch timestamp format.

last_modified_bystringRequired

ID of the user last modified by.

last_modified_onintegerRequired

Timestamp of the policy last modified on. This is a unix Epoch timestamp format.

get/apis/userdefinedobjects/v1/{object_name}/export
GET /apis/userdefinedobjects/v1/{object_name}/export HTTP/1.1
Host: {realm}.{env}.rightrev.cloud/
Accept: */*
200

Export User Defined Object

[
  {
    "compliance_id": "bf00c65f-98f0-4db6-905e-f684b9a24d5b",
    "compliance_name": "user-defined-objects",
    "compliance_spec": [
      {
        "created_at": 1772532176,
        "created_by": "svc@rightrev.com",
        "file_id": "828223ba-fce9-4328-bc90-5d8ed702bf87",
        "file_index": "0",
        "file_name": "TEST_RRAPI_QA_CUSTOM_06_upload_template.csv",
        "guid": "cb69dd46-dd12-417f-9b9b-0ebe47325f34",
        "object_description": "New object",
        "object_name": "TEST_RRAPI_QA_CUSTOM_06",
        "process_status": "Success",
        "source_data_json": {
          "FILED_01": "test1",
          "FILED_02": "test2"
        },
        "total_fields": 2,
        "updated_at": 1772532176,
        "updated_by": "svc@rightrev.com"
      }
    ],
    "created_by": "RIGHTREV",
    "created_on": 1772532453,
    "last_modified_by": "RIGHTREV",
    "last_modified_on": 1772532453
  }
]

Last updated

Was this helpful?