Delete automation

curl --request DELETE \
  --url https://api.devin.ai/v3/organizations/{org_id}/automations/{automation_id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.devin.ai/v3/organizations/{org_id}/automations/{automation_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.devin.ai/v3/organizations/{org_id}/automations/{automation_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.devin.ai/v3/organizations/{org_id}/automations/{automation_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.devin.ai/v3/organizations/{org_id}/automations/{automation_id}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.devin.ai/v3/organizations/{org_id}/automations/{automation_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "actions": [
    {
      "prompt": "<string>",
      "session": {
        "bypass_approval": false,
        "notifications": {
          "slack": {
            "channel_id": "<string>",
            "mode": "post_updates"
          },
          "teams": {
            "channel_id": "<string>",
            "team_id": "<string>"
          }
        },
        "platform": "<string>",
        "playbook_id": "<string>",
        "repos": [],
        "tags": []
      },
      "type": "start_session"
    }
  ],
  "automation_id": "<string>",
  "created_at": 123,
  "created_by": {
    "id": "<string>",
    "type": "user",
    "name": "<string>"
  },
  "enabled": true,
  "name": "<string>",
  "triggers": [
    {
      "event_type": "<string>",
      "trigger_id": "<string>",
      "conditions": {
        "any": [
          {
            "all": [
              {
                "field": "<string>",
                "operator": "eq",
                "value": "<string>"
              }
            ]
          }
        ]
      },
      "replies": [],
      "webhook": {
        "url": "<string>",
        "secret": "<string>"
      }
    }
  ],
  "updated_at": 123,
  "concurrency": {
    "max_concurrent_runs": 2,
    "max_queue_depth": 1
  },
  "last_edited_by": {
    "id": "<string>",
    "type": "user",
    "name": "<string>"
  },
  "last_invocation": {
    "fired_at": 123,
    "status": "<string>"
  },
  "limits": {
    "invocations": {
      "max_per_window": 2,
      "window_seconds": 61
    },
    "max_acu_limit": 500
  },
  "metadata": {},
  "next_run_at": 123,
  "notifications": {
    "email": {
      "when": "always",
      "recipients": [
        "<string>"
      ]
    },
    "slack": {
      "channel_id": "<string>",
      "when": "always"
    }
  },
  "run_as": {
    "type": "organization"
  },
  "security_profile": {
    "selection": "inherit",
    "profile_id": "<string>",
    "warnings": []
  },
  "session_settings": {
    "devin_mode": "normal",
    "net_policy": {
      "allow": [
        {
          "hostname": "<string>"
        }
      ]
    }
  },
  "slack_reply_access": "slack_users",
  "teams_reply_access": "teams_users",
  "template_id": "<string>",
  "tools": {
    "jira_projects": [
      "<string>"
    ],
    "linear_enabled": true,
    "mcp_servers": [],
    "slack_channels": [],
    "slack_dm_scope": "org_members",
    "teams_channels": []
  }
}

{
  "status": 123,
  "title": "<string>",
  "detail": "<string>",
  "error_code": "<string>",
  "errors": [
    {}
  ],
  "instance": "<string>",
  "type": "about:blank"
}

{
  "status": 123,
  "title": "<string>",
  "detail": "<string>",
  "error_code": "<string>",
  "errors": [
    {}
  ],
  "instance": "<string>",
  "type": "about:blank"
}

{
  "status": 123,
  "title": "<string>",
  "detail": "<string>",
  "error_code": "<string>",
  "errors": [
    {}
  ],
  "instance": "<string>",
  "type": "about:blank"
}

{
  "status": 123,
  "title": "<string>",
  "detail": "<string>",
  "error_code": "<string>",
  "errors": [
    {}
  ],
  "instance": "<string>",
  "type": "about:blank"
}

{
  "status": 123,
  "title": "<string>",
  "detail": "<string>",
  "error_code": "<string>",
  "errors": [
    {}
  ],
  "instance": "<string>",
  "type": "about:blank"
}

{
  "status": 123,
  "title": "<string>",
  "detail": "<string>",
  "error_code": "<string>",
  "errors": [
    {}
  ],
  "instance": "<string>",
  "type": "about:blank"
}

DELETE

organizations

{org_id}

automations

{automation_id}

Delete automation

curl --request DELETE \
  --url https://api.devin.ai/v3/organizations/{org_id}/automations/{automation_id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.devin.ai/v3/organizations/{org_id}/automations/{automation_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.devin.ai/v3/organizations/{org_id}/automations/{automation_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.devin.ai/v3/organizations/{org_id}/automations/{automation_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.devin.ai/v3/organizations/{org_id}/automations/{automation_id}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.devin.ai/v3/organizations/{org_id}/automations/{automation_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "actions": [
    {
      "prompt": "<string>",
      "session": {
        "bypass_approval": false,
        "notifications": {
          "slack": {
            "channel_id": "<string>",
            "mode": "post_updates"
          },
          "teams": {
            "channel_id": "<string>",
            "team_id": "<string>"
          }
        },
        "platform": "<string>",
        "playbook_id": "<string>",
        "repos": [],
        "tags": []
      },
      "type": "start_session"
    }
  ],
  "automation_id": "<string>",
  "created_at": 123,
  "created_by": {
    "id": "<string>",
    "type": "user",
    "name": "<string>"
  },
  "enabled": true,
  "name": "<string>",
  "triggers": [
    {
      "event_type": "<string>",
      "trigger_id": "<string>",
      "conditions": {
        "any": [
          {
            "all": [
              {
                "field": "<string>",
                "operator": "eq",
                "value": "<string>"
              }
            ]
          }
        ]
      },
      "replies": [],
      "webhook": {
        "url": "<string>",
        "secret": "<string>"
      }
    }
  ],
  "updated_at": 123,
  "concurrency": {
    "max_concurrent_runs": 2,
    "max_queue_depth": 1
  },
  "last_edited_by": {
    "id": "<string>",
    "type": "user",
    "name": "<string>"
  },
  "last_invocation": {
    "fired_at": 123,
    "status": "<string>"
  },
  "limits": {
    "invocations": {
      "max_per_window": 2,
      "window_seconds": 61
    },
    "max_acu_limit": 500
  },
  "metadata": {},
  "next_run_at": 123,
  "notifications": {
    "email": {
      "when": "always",
      "recipients": [
        "<string>"
      ]
    },
    "slack": {
      "channel_id": "<string>",
      "when": "always"
    }
  },
  "run_as": {
    "type": "organization"
  },
  "security_profile": {
    "selection": "inherit",
    "profile_id": "<string>",
    "warnings": []
  },
  "session_settings": {
    "devin_mode": "normal",
    "net_policy": {
      "allow": [
        {
          "hostname": "<string>"
        }
      ]
    }
  },
  "slack_reply_access": "slack_users",
  "teams_reply_access": "teams_users",
  "template_id": "<string>",
  "tools": {
    "jira_projects": [
      "<string>"
    ],
    "linear_enabled": true,
    "mcp_servers": [],
    "slack_channels": [],
    "slack_dm_scope": "org_members",
    "teams_channels": []
  }
}

{
  "status": 123,
  "title": "<string>",
  "detail": "<string>",
  "error_code": "<string>",
  "errors": [
    {}
  ],
  "instance": "<string>",
  "type": "about:blank"
}

{
  "status": 123,
  "title": "<string>",
  "detail": "<string>",
  "error_code": "<string>",
  "errors": [
    {}
  ],
  "instance": "<string>",
  "type": "about:blank"
}

{
  "status": 123,
  "title": "<string>",
  "detail": "<string>",
  "error_code": "<string>",
  "errors": [
    {}
  ],
  "instance": "<string>",
  "type": "about:blank"
}

{
  "status": 123,
  "title": "<string>",
  "detail": "<string>",
  "error_code": "<string>",
  "errors": [
    {}
  ],
  "instance": "<string>",
  "type": "about:blank"
}

{
  "status": 123,
  "title": "<string>",
  "detail": "<string>",
  "error_code": "<string>",
  "errors": [
    {}
  ],
  "instance": "<string>",
  "type": "about:blank"
}

{
  "status": 123,
  "title": "<string>",
  "detail": "<string>",
  "error_code": "<string>",
  "errors": [
    {}
  ],
  "instance": "<string>",
  "type": "about:blank"
}

Permissions

Requires a service user or personal access token with the ManageOrgAutomations permission at the organization level. Deletes are soft: the deleted automation is returned as the response body.

Authorizations

Authorization

string

header

required

Service User credential (prefix: cog_)

Path Parameters

automation_id

string

required

org_id

string

required

Organization ID (prefix: org-)

Example:

"org-abc123def456"

Response

Successful Response

actions

(AutomationStartSessionAction · object | AutomationMessageSessionAction · object | AutomationMonitorSessionAction · object)[]

required

AutomationStartSessionAction
AutomationMessageSessionAction
AutomationMonitorSessionAction

Show child attributes

automation_id

string

required

created_at

integer

required

created_by

ActorResponse · object

required

A user or service-user principal attributed to an action or resource.

Show child attributes

enabled

boolean

required

name

string

required

triggers

AutomationTriggerResponse · object[]

required

Show child attributes

updated_at

integer

required

concurrency

AutomationConcurrency · object | null

Show child attributes

last_edited_by

ActorResponse · object | null

A user or service-user principal attributed to an action or resource.

Show child attributes

last_invocation

AutomationLastInvocation · object | null

Show child attributes

limits

AutomationLimits · object | null

Show child attributes

metadata

Metadata · object

Show child attributes

next_run_at

integer | null

When the automation's schedule triggers next fire. null when it has no schedule trigger, is disabled, or every schedule has passed its end date.

notifications

AutomationNotifications · object | null

Show child attributes

run_as

AutomationRunAsOrganization · object

Identity the spawned sessions run under. organization: the org's automation identity (the System User in the app) — sessions use system permissions, so MCP servers installed with a personal (user-scoped) connection cannot be selected, and switching an automation to organization removes them from its selection. creator: personal automation — runs with the creator's own permissions and is visible only to the creator and org admins; rejected for service-user-created automations. service_user: runs as the given service user, with its roles, grants and ACU limits; requires permission to manage that service user. Required on create; null on update resets to organization.

AutomationRunAsOrganization
AutomationRunAsCreator
AutomationRunAsServiceUser

Show child attributes

security_profile

AutomationSecurityProfileResponse · object | null

The automation's security-profile binding and the resolved governing profiles. null when security profiles are not enabled for the organization.

Show child attributes

session_settings

AutomationSessionSettings · object | null

Applied to every session this automation spawns (including monitor sessions).

Show child attributes

slack_reply_access

enum<string>

default:slack_users

Who may reply into existing sessions from Slack threads: devin_users (linked Devin accounts only), slack_users (anyone in the organization's connected Slack workspaces), or external_slack_users (also Slack Connect users). Does not affect who can trigger the automation.

Available options:

devin_users,

slack_users,

external_slack_users

teams_reply_access

enum<string>

default:teams_users

Who may reply into existing sessions from Microsoft Teams threads: devin_users (linked Devin accounts only) or teams_users (anyone in the organization's connected Microsoft tenant; the default). Does not affect who can trigger the automation.

Available options:

devin_users,

teams_users

template_id

string | null

tools

AutomationTools · object | null

Show child attributes

Getting Started

Concepts

Agent Lifecycle

Context Management

Environment Management

Automation

Integrations

Analytics

Observability

Devin for Security

Infrastructure

Identity & Access

Configuration

Legacy API v1

Legacy API v2

Delete automation

Permissions

Authorizations

Path Parameters

Response

​Permissions

Authorizations

Path Parameters

Response

Permissions