DIGIT-API's
  1. BusinessServiceV2
DIGIT-API's
  • Using DIGIT-PLAYGROUND
  • User
    • Manage
      • Create User
      • Search All Users
      • Search Active Users
      • Create User Without OTP Validation
      • Update User Without OTP Validation
      • Get User
      • Update Profile
    • Authenticate
      • Logout
      • Reset Password
      • Login
  • Master Data V1
    • List
      POST
    • Search
      POST
  • Master Data V2
    • Create Schema
      • Create Schema
    • Search Schema
      • Seach Schema
    • Add Data
      • Create
    • Seach Data
      • Seach Data
    • Update data
      • Updata
  • Access-control
    • Action
      • Authorize User
      • Get the list of actions based on either roles or features.
      • Create a new action.
      • Update existing action(s).
      • getAllMDMSActions
      • Validate a particular action for a given tenant and roles of the tenant
    • Role
      • Get the list of roles based on role codes.
      • Create a new role.
      • Update existing role(s).
    • Role-Action
      • Create mapping for role and action(s).
  • Workflow-v2
    • WorkFlow
      • Create new workflow entry for a given application number(businessId).
      • Process search of the applicaition
      • Get the list of workflow applications defined in the system.
      • Get the count of applications satisfying the given criteria
      • Get the nearing sla count of workflow applications defined in the system.
      • Get the list of status count workflow applications defined in the system.
    • Escalate
      • Get the list of escalate workflow applications defined in the system.
      • Get the list of workflow applications defined in the system.
    • BusinessServiceV2
      • Create new v2 BuinessService.
        POST
      • Updates a existing v2 BuinessService.
        POST
      • Get the list of v2 BusinessServices defined in the system.
        POST
    • BusinessService
      • Create new BuinessService.
      • Updates a existing BuinessService.
      • Get the list of BusinessServices defined in the system.
  • Filestore
    • Upload File
      • Uploads different kinds of files to server.
    • Search
      • Search file url based on tenantid and filestoreid.
      • Search file url based on tenantid and tag name.
      • Get metadata of file based on tenantId and filestoreId.
      • Search file url based on tenantid and filestoreid.
  • Idgen
    • IdGeneration Controller
    • Create new id.
      POST
  • Location
    • Boundary
      • Search Location
      • It Will provide the List of boundaries based on search criteria Like "Srikakulam Municipality","Zone-1","Zone-2" etc.
    • Geography
      • Handles all requests related to Geographical boundaries by providing appropriate GeoJson and other associated data
    • Tenant
      • Resolves a given latitude / longitude to the corresponding tenant Id
  • Enc-Service
    • Crypto
      • Encrypts the given input value/s OR values of the object.
      • Decrypts the given input value/s OR values of the object.
      • Provide signature for a given value.
      • Check if the signature is correct for the provided value.
      • Deactivate the keys for the given tenant and generate new keys. It will deactivate both symmetric and asymmetric keys for the provided tenant.
      • cryptoRotateAllKeys
  • PG-Service
    • transactions-api-controller
      • transactionsV1AvailableGatewaysPost
      • transactionsV1CreatePost
      • transactionsV1SearchPost
      • transactionsV1UpdatePost
  • URL-Shortening
    • egov-url-shortening service endpoints
      • shorten given url
      • redirects user to orignal url identified by id
  • Indexer
    • egov-indexer service
      • This endpoint is used to start legacy index job to reindex records from DB. The data is fetched from DB by calling api mentioned in request in batches. The is useful when some record is present in DB but missing on index.
      • This endpoint is used to start indexing job to reindex records from one index to another index.
      • This endpoint is used to index one record on a index. The information to pick correct config is provided with the data to be indexed.
      • Index data in row
  • PDF-Service
    • PDF-Service endpoints
      • Generate PDF and store output pdfs to filestore and return their filestoreids. The information is also saved into DB so that using _search endpoint we can retrieve already generated pdfs.
      • Generates pdf without storing any information on filestore or in DB. The generated pdf would be returned as binary response
      • Get filestoreids and other information about already generated pdf by searching on jobid or entityid with other optional search parameters
  • Report
    • Report Meta
      • createv1
      • getReportDatav1
      • Metadata API for report definition
    • Report
      • Search API for report data
  • eGov-OTP
    • OTPConfig
      • create OTP Configuration entry
      • validate OTP Configuration entry
      • search OTP Configuration entry using uuid
  • User-OTP
    • user otp send
  • Localization
    • Create Message
      • create massage
    • Fetch Message
      • fetch message
    • Update message
      • update message
    • Delete message
      • delete mesage
    • Upsert message
      • upsert message
  • Service Request
    • Service Defination Create
      • Create service defination
    • Service Defination search
      • Search service defination
    • Service create
      • service create
    • Service Search
      • Service search
  • Audit Service
  1. BusinessServiceV2

Updates a existing v2 BuinessService.

POST
/businessservice/v2/_update
Last modified:2024-05-22 10:36:45
Can be used only to add new state or action in the workflow. Can update any existing field. Removing of any state is not allowed as applications in that state will be in invalid state
Following Conditions are applied -
1.
can add states and actions
2.
can update roles in action, SLA etc.

Request

Header Params
Content-Type
string 
optional
Example:
application/json
Body Params text/plain
Example
Example:{ "RequestInfo": { "apiId": null, "ver": null, "ts": null, "action": "POST", "did": null, "key": null, "msgId": "5bfa85e7-dfa1-47c8-98b2-747bf552be86", "authToken": "50b80fa6-bec2-438e-a168-ce5ad53770b5" }, "BusinessServices": [ { "tenantId": "pg", "uuid": "479c27fa-cf5e-44a9-a884-109df31e6bcd", "businessService": "WaterManegament12", "business": "work", "businessServiceSla": 123, "states": [ { "auditDetails": { "createdBy": "3b68bb99-310b-4fb4-ae27-ddb948cab9e3", "lastModifiedBy": "3b68bb99-310b-4fb4-ae27-ddb948cab9e3", "createdTime": 1716366762741, "lastModifiedTime": 1716366762741 }, "uuid": "b3b6ae82-6b63-4ebb-b855-c6ccef4da805", "tenantId": "pg", "businessServiceId": null, "sla": 1234, "state": null, "applicationStatus": null, "docUploadRequired": false, "isStartState": true, "isTerminateState": false, "isStateUpdatable": true, "actions": [ { "auditDetails": { "createdBy": "3b68bb99-310b-4fb4-ae27-ddb948cab9e3", "lastModifiedBy": "3b68bb99-310b-4fb4-ae27-ddb948cab9e3", "createdTime": 1716366762741, "lastModifiedTime": 1716366762741 }, "uuid": "a31ecfd0-473c-45f2-b2e5-80159aabf006", "tenantId": "pg", "currentState": "b3b6ae82-6b63-4ebb-b855-c6ccef4da805", "action": "APPLY", "nextState": "65be5ad8-400d-4dc4-9cca-f0b4e9fdb9e3", "roles": [ "CITIZEN" ], "active": true } ] }, { "auditDetails": { "createdBy": "3b68bb99-310b-4fb4-ae27-ddb948cab9e3", "lastModifiedBy": "3b68bb99-310b-4fb4-ae27-ddb948cab9e3", "createdTime": 1716366762741, "lastModifiedTime": 1716366762741 }, "uuid": "65be5ad8-400d-4dc4-9cca-f0b4e9fdb9e3", "tenantId": "pg", "businessServiceId": null, "sla": null, "state": "PENDINGFORASSIGNMENT", "applicationStatus": "PENDINGFORASSIGNMENT", "docUploadRequired": false, "isStartState": false, "isTerminateState": false, "isStateUpdatable": false, "actions": [ { "auditDetails": { "createdBy": "3b68bb99-310b-4fb4-ae27-ddb948cab9e3", "lastModifiedBy": "3b68bb99-310b-4fb4-ae27-ddb948cab9e3", "createdTime": 1716366762741, "lastModifiedTime": 1716366762741 }, "uuid": "2ee712c8-4009-4e7d-8b55-5bc13129e08b", "tenantId": "pg", "currentState": "65be5ad8-400d-4dc4-9cca-f0b4e9fdb9e3", "action": "ASSIGN", "nextState": "f68e7851-f222-48d8-9e60-cd2b6eec2ada", "roles": [ "EMPLOYEE" ], "active": true } ] }, { "auditDetails": { "createdBy": "3b68bb99-310b-4fb4-ae27-ddb948cab9e3", "lastModifiedBy": "3b68bb99-310b-4fb4-ae27-ddb948cab9e3", "createdTime": 1716366762741, "lastModifiedTime": 1716366762741 }, "uuid": "f68e7851-f222-48d8-9e60-cd2b6eec2ada", "tenantId": "pg", "businessServiceId": null, "sla": null, "state": "PENDINGATLME", "applicationStatus": "PENDINGATLME", "docUploadRequired": false, "isStartState": false, "isTerminateState": true, "isStateUpdatable": false, "actions": null } ], "auditDetails": { "createdBy": "3b68bb99-310b-4fb4-ae27-ddb948cab9e3", "lastModifiedBy": "3b68bb99-310b-4fb4-ae27-ddb948cab9e3", "createdTime": 1716366762741, "lastModifiedTime": 1716366762741 } } ] }

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://unified-dev.digit.org/egov-workflow-v2/egov-wf/businessservice/v2/_update' \
--header 'Content-Type: application/json' \
--data-raw '{
"RequestInfo": {
        "apiId": null,
        "ver": null,
        "ts": null,
        "action": "POST",
        "did": null,
        "key": null,
        "msgId": "5bfa85e7-dfa1-47c8-98b2-747bf552be86",
        "authToken": "50b80fa6-bec2-438e-a168-ce5ad53770b5"
    },
    "BusinessServices": [
        {
            "tenantId": "pg",
            "uuid": "479c27fa-cf5e-44a9-a884-109df31e6bcd",
            "businessService": "WaterManegament12",
            "business": "work",
            "businessServiceSla": 123,
            "states": [
                {
                    "auditDetails": {
                        "createdBy": "3b68bb99-310b-4fb4-ae27-ddb948cab9e3",
                        "lastModifiedBy": "3b68bb99-310b-4fb4-ae27-ddb948cab9e3",
                        "createdTime": 1716366762741,
                        "lastModifiedTime": 1716366762741
                    },
                    "uuid": "b3b6ae82-6b63-4ebb-b855-c6ccef4da805",
                    "tenantId": "pg",
                    "businessServiceId": null,
                    "sla": 1234,
                    "state": null,
                    "applicationStatus": null,
                    "docUploadRequired": false,
                    "isStartState": true,
                    "isTerminateState": false,
                    "isStateUpdatable": true,
                    "actions": [
                        {
                            "auditDetails": {
                                "createdBy": "3b68bb99-310b-4fb4-ae27-ddb948cab9e3",
                                "lastModifiedBy": "3b68bb99-310b-4fb4-ae27-ddb948cab9e3",
                                "createdTime": 1716366762741,
                                "lastModifiedTime": 1716366762741
                            },
                            "uuid": "a31ecfd0-473c-45f2-b2e5-80159aabf006",
                            "tenantId": "pg",
                            "currentState": "b3b6ae82-6b63-4ebb-b855-c6ccef4da805",
                            "action": "APPLY",
                            "nextState": "65be5ad8-400d-4dc4-9cca-f0b4e9fdb9e3",
                            "roles": [
                                "CITIZEN"
                            ],
                            "active": true
                        }
                    ]
                },
                {
                    "auditDetails": {
                        "createdBy": "3b68bb99-310b-4fb4-ae27-ddb948cab9e3",
                        "lastModifiedBy": "3b68bb99-310b-4fb4-ae27-ddb948cab9e3",
                        "createdTime": 1716366762741,
                        "lastModifiedTime": 1716366762741
                    },
                    "uuid": "65be5ad8-400d-4dc4-9cca-f0b4e9fdb9e3",
                    "tenantId": "pg",
                    "businessServiceId": null,
                    "sla": null,
                    "state": "PENDINGFORASSIGNMENT",
                    "applicationStatus": "PENDINGFORASSIGNMENT",
                    "docUploadRequired": false,
                    "isStartState": false,
                    "isTerminateState": false,
                    "isStateUpdatable": false,
                    "actions": [
                        {
                            "auditDetails": {
                                "createdBy": "3b68bb99-310b-4fb4-ae27-ddb948cab9e3",
                                "lastModifiedBy": "3b68bb99-310b-4fb4-ae27-ddb948cab9e3",
                                "createdTime": 1716366762741,
                                "lastModifiedTime": 1716366762741
                            },
                            "uuid": "2ee712c8-4009-4e7d-8b55-5bc13129e08b",
                            "tenantId": "pg",
                            "currentState": "65be5ad8-400d-4dc4-9cca-f0b4e9fdb9e3",
                            "action": "ASSIGN",
                            "nextState": "f68e7851-f222-48d8-9e60-cd2b6eec2ada",
                            "roles": [
                                "EMPLOYEE"
                            ],
                            "active": true
                        }
                    ]
                },
                {
                    "auditDetails": {
                        "createdBy": "3b68bb99-310b-4fb4-ae27-ddb948cab9e3",
                        "lastModifiedBy": "3b68bb99-310b-4fb4-ae27-ddb948cab9e3",
                        "createdTime": 1716366762741,
                        "lastModifiedTime": 1716366762741
                    },
                    "uuid": "f68e7851-f222-48d8-9e60-cd2b6eec2ada",
                    "tenantId": "pg",
                    "businessServiceId": null,
                    "sla": null,
                    "state": "PENDINGATLME",
                    "applicationStatus": "PENDINGATLME",
                    "docUploadRequired": false,
                    "isStartState": false,
                    "isTerminateState": true,
                    "isStateUpdatable": false,
                    "actions": null
                }
            ],
            "auditDetails": {
                "createdBy": "3b68bb99-310b-4fb4-ae27-ddb948cab9e3",
                "lastModifiedBy": "3b68bb99-310b-4fb4-ae27-ddb948cab9e3",
                "createdTime": 1716366762741,
                "lastModifiedTime": 1716366762741
            }
        }
    ]
}'

Responses

🟢201ReponseInfo withBusinessService(s) created successfully
application/json
Body
ResponseInfo
object 
optional
BusinessService
array[object (BusinessService) {9}] 
optional
Used for search result and create only
tenantId
string 
required
Unique Identifier of ULB
>= 2 characters<= 256 characters
uuid
string 
optional
Unique Identifier uuid
>= 2 characters<= 256 characters
businessService
string 
required
Unique name of business service
>= 2 characters<= 256 characters
business
string 
required
<= 256 characters
getUri
string 
optional
>= 2 characters<= 1024 characters
postUri
string 
optional
>= 2 characters<= 1024 characters
businessServiceSla
integer <int64>
optional
states
array[object (State) {12}] 
required
auditDetails
object 
optional
Example
{
    "ResponseInfo": {},
    "BusinessService": [
        {
            "tenantId": "string",
            "uuid": "string",
            "businessService": "string",
            "business": "string",
            "getUri": "string",
            "postUri": "string",
            "businessServiceSla": 0,
            "states": [
                {
                    "uuid": "string",
                    "tenantId": "string",
                    "businessServiceId": "string",
                    "sla": 0,
                    "state": "string",
                    "applicationStatus": "string",
                    "docUploadRequired": true,
                    "isStartState": true,
                    "isTerminateState": true,
                    "isStateUpdatable": true,
                    "actions": [
                        {
                            "uuid": "string",
                            "tenantId": "string",
                            "currentState": "string",
                            "action": "string",
                            "nextState": "string",
                            "roles": [
                                "string"
                            ],
                            "active": true,
                            "auditDetails": {}
                        }
                    ],
                    "auditDetails": {}
                }
            ],
            "auditDetails": {}
        }
    ]
}
🟠400BusinessService(s) creation failed
Modified at 2024-05-22 10:36:45
Previous
Create new v2 BuinessService.
Next
Get the list of v2 BusinessServices defined in the system.
Built with