Update request status

HOM

https://hom.roit.ai

POST

/roit-data-integration/v1/requests/update

Updates the status of an existing request

Request

Header Params

Body Params application/json

Example

{
    "processUniqueId": "bb0c892a-9695-414d-966b-c3cd66959067",
    "processStatus": "START",
    "callbackUrl": "https://api.example.com/webhook/status-update",
    "callbackAuthToken": "1234567890",
    "operationType": "entrada",
    "documentType": "NFE",
    "dataBaseDest": {
        "secret": "tax_strategy_sandbox_custom_rdd",
        "tables": [
            {
                "name": "simulation_result",
                "dataset": "public",
                "metadata": {
                    "company_id": "",
                    "organizations_id": ""
                }
            }
        ]
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://hom.roit.ai/roit-data-integration/v1/requests/update' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "processUniqueId": "bb0c892a-9695-414d-966b-c3cd66959067",
    "processStatus": "START",
    "callbackUrl": "https://api.example.com/webhook/status-update",
    "callbackAuthToken": "1234567890",
    "operationType": "entrada",
    "documentType": "NFE",
    "dataBaseDest": {
        "secret": "tax_strategy_sandbox_custom_rdd",
        "tables": [
            {
                "name": "simulation_result",
                "dataset": "public",
                "metadata": {
                    "company_id": "",
                    "organizations_id": ""
                }
            }
        ]
    }
}'

Responses

🟢200OK

application/json

Request status updated successfully

Body

Example

{
    "status": "success",
    "message": "Request status updated successfully",
    "data": {
        "processUniqueId": "bb0c892a-9695-414d-966b-c3cd66959067",
        "createdAt": "2024-01-15T10:30:00Z",
        "updatedAt": "2024-01-15T11:00:00Z"
    }
}

🟠400Bad Request

🔴500Server Error

Modified at 2025-12-19 16:06:25

Create a new request

Generate signed URL