Summary
          Updates an automation's attributes.
          Description
          Updates an automation's attributes (including scheduling data).
          Route
          PUT /automation_catalog/automations/:id
          Roles
          
            admin
other
apiread
          
          Parameters
          
            DetailsExampleSchema
          
          
            
              
                | Name | 
                Type | 
                Required | 
                Description | 
              
            
            
              
    | id | 
    string | 
    yes | 
    Unique id of the automation | 
  
    | options | 
    object | 
    yes | 
    Object containing the fields to be updated | 
  
            
          
          
            Copied to Clipboard
            
            {
  "options": {
    "workflowId": "8e3695fe-c5bf-4286-ae83-186b3fea1c1a",
    "formId": "8ae8bae0f560e443b96120a2",
    "gbac": {
      "write": [
        "891bf5eb4a7d6109b27aced7",
        "88096d2d2c2567c08a294347",
        "0fdfd076ac9da01b606eeaf2",
        "96891cc1fe069893830d91a2"
      ],
      "read": [
        "ae465dc26160bed334cc6523",
        "0224d1c2aac21a5e9e2cd6b8"
      ]
    },
    "nextRunAt": "2019-11-25T22:51:39.201Z",
    "repeatInterval": "2 months"
  }
}
           
          
            Copied to Clipboard
            
            {
  "type": "object",
  "properties": {
    "options": {
      "title": "options",
      "type": "object",
      "description": "Custom data stored with an automation.",
      "properties": {
        "formData": {
          "type": "object",
          "properties": {},
          "description": "An object containing a list of properties from the associated json-form, saved formData is only used when scheduling."
        },
        "workflowId": {
          "type": "string",
          "examples": [
            "8e3695fe-c5bf-4286-ae83-186b3fea1c1a"
          ],
          "format": "uuid"
        },
        "formId": {
          "$ref": "automationDocument#/definitions/ObjectId"
        },
        "gbac": {
          "type": "object",
          "description": "Sets of group Ids that are allowed to access this automation.",
          "properties": {
            "write": {
              "type": "array",
              "description": "Group ids that have write access to the automation document.",
              "items": {
                "$ref": "automationDocument#/definitions/ObjectId"
              }
            },
            "read": {
              "type": "array",
              "description": "Group ids that have read access to the automation document.",
              "items": {
                "$ref": "automationDocument#/definitions/ObjectId"
              }
            }
          },
          "required": [
            "write",
            "read"
          ]
        },
        "nextRunAt": {
          "oneOf": [
            {
              "type": "string",
              "examples": [
                "2019-11-25T22:51:39.201Z"
              ],
              "format": "date-time",
              "description": "Agenda property defining when the next run will process, stored in UTC."
            },
            {
              "type": "null"
            }
          ]
        },
        "repeatInterval": {
          "oneOf": [
            {
              "type": "string",
              "minLength": 1,
              "description": "Agenda property defining how often an automation will repeat. Stored in human interval time format (https://github.com/agenda/human-interval).",
              "examples": [
                "1 hour",
                "1 day",
                "3 weeks",
                "2 months"
              ]
            },
            {
              "type": "null"
            }
          ]
        }
      }
    }
  },
  "required": [
    "options"
  ],
  "additionalProperties": false
}
           
          Return
          
            DetailsExampleSchema
          
          
            
              
                | Name | 
                Type | 
                Description | 
              
            
            
              
                | document | 
                object | 
                Updated document of requested automation | 
              
            
          
          
            Copied to Clipboard
            
            {
  "_id": "1b6ee2a3b638c9d92348972c",
  "name": "test",
  "data": {
    "gbac": {
      "write": [
        "c423a4debd302b8d3badb007",
        "f2b7d358df9aed93f576b9af"
      ],
      "read": [
        "34e69f6622787831066dd1df",
        "fa92b50646c4c60d547a69d2",
        "21c3c086bc6a801380ca203d",
        "8f61c59d78cabbe3a0738e63"
      ]
    },
    "lastUpdated": "2019-11-25T22:51:39.201Z",
    "description": "cupidatat ut Excepteur ad",
    "workflowId": "8e3695fe-c5bf-4286-ae83-186b3fea1c1a",
    "formId": "ee15894ace9e9e60bc68d59c"
  },
  "lastModifiedBy": "quis",
  "lastRunAt": "2019-11-25T22:51:39.201Z",
  "nextRunAt": "2019-11-25T22:51:39.201Z",
  "repeatInterval": "3 weeks",
  "migratedToOM": false,
  "correspondingOMAutomationId": "ba55778e70f838aaa830f5f5"
}