Project Falcon has retired. For details please refer to its Attic page.
Falcon - POST api/entities/update/:entity-type/:entity-name

POST api/entities/update/:entity-type/:entity-name


Updates the submitted entity.


  • :entity-type can be cluster, feed or process.
  • :entity-name is name of the cluster, feed or process.
  • skipDryRun : Optional query param, Falcon skips oozie dryrun when value is set to true.
  • doAs <optional query param> allows the current user to impersonate the user passed in doAs when interacting with the Falcon system.


Result of the validation.


Rest Call

POST http://localhost:15000/api/entities/update/process/SampleProcess?skipDryRun=false&doAs=joe
<?xml version="1.0" encoding="UTF-8"?>
<!-- Daily sample process. Runs at 6th hour every day. Input - last day's hourly data. Generates output for yesterday -->
<process xmlns="uri:falcon:process:0.1" name="SampleProcess" >
      <cluster name="primary-cluster">
	<validity start="2012-04-03T06:00Z" end="2022-12-30T00:00Z" />


        <input name="input" feed="SampleInput" start="yesterday(0,0)" end="today(-1,0)" />

        <output name="output" feed="SampleOutput" instance="yesterday(0,0)" />

        <property name="queueName" value="default" />
        <property name="" value="localhost" />
        <property name="fileTimestamp" value="${coord:formatTime(coord:nominalTime(), 'yyyy-MM-dd')}" />

    <workflow engine="oozie" path="/examples/apps/aggregator" />
    <retry policy="exp-backoff" delay="minutes(5)" attempts="3" />
    <late-process policy="exp-backoff" delay="hours(1)">
        <late-input input="input" workflow-path="/projects/bootcamp/workflow/lateinput" />


    "requestId": "update\/default\/d6aaa328-6836-4818-a212-515bb43d8b86\n\n",
    "message": "update\/default\/SampleProcess updated successfully\n\n",
    "status": "SUCCEEDED"