Automatisierungen auflisten

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

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

fetch('https://api.devin.ai/v3/organizations/{org_id}/automations', 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",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  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"

	req, _ := http.NewRequest("GET", 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")

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

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

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

{
  "items": [
    {
      "actions": [
        {
          "prompt": "<string>",
          "session": {
            "bypass_approval": false,
            "notifications": {
              "slack": {
                "channel_id": "<string>"
              }
            },
            "platform": "<string>",
            "playbook_id": "<string>",
            "repos": [],
            "tags": []
          },
          "type": "start_session"
        }
      ],
      "automation_id": "<string>",
      "created_at": 123,
      "created_by": {
        "id": "<string>",
        "name": "<string>"
      },
      "enabled": true,
      "name": "<string>",
      "triggers": [
        {
          "event_type": "<string>",
          "trigger_id": "<string>",
          "conditions": {
            "any": [
              {
                "all": [
                  {
                    "field": "<string>",
                    "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>",
        "name": "<string>"
      },
      "last_invocation": {
        "fired_at": 123,
        "status": "<string>"
      },
      "limits": {
        "invocations": {
          "max_per_window": 2,
          "window_seconds": 61
        },
        "max_acu_limit": 500
      },
      "metadata": {},
      "notifications": {
        "email": {
          "recipients": [
            "<string>"
          ]
        },
        "slack": {
          "channel_id": "<string>"
        }
      },
      "run_as": {
        "type": "organization"
      },
      "security_profile": {
        "profile_id": "<string>",
        "warnings": []
      },
      "session_settings": {
        "net_policy": {
          "allow": [
            {
              "hostname": "<string>"
            }
          ]
        }
      },
      "template_id": "<string>",
      "tools": {
        "linear_enabled": true,
        "mcp_servers": [],
        "slack_channels": []
      }
    }
  ],
  "end_cursor": "<string>",
  "has_next_page": false,
  "total": 123
}

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

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

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

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

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

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

Automatisierungen (Organisation)

Automatisierungen auflisten

Alle Automatisierungen der Organisation auflisten, neueste zuerst.

Unterstützt metadata.<key>=<value>-Abfrageparameter zum Filtern nach Metadaten-Labels (exakte Übereinstimmung; mehrere Filter werden mit UND verknüpft).

agent_types filtert Automatisierungen, die mindestens eine Aktion eines bestimmten Agent-Typs enthalten; wiederholen Sie den Parameter, um mehrere Typen mit ODER abzugleichen. Aktions-Payloads werden im Kundendatenspeicher und nicht in durchsuchbaren Spalten gespeichert. Daher durchsucht dieser Filter die Seiten serverseitig. total wird nur zurückgegeben, wenn ein einzelner ungefilterter Scan die gesamte Ergebnismenge abgedeckt hat (erste Seite, keine weiteren Seiten, nichts ausgeblendet); andernfalls wird der Wert weggelassen, statt eine Anzahl anzugeben, die Automatisierungen einschließt, die von der API niemals zurückgegeben werden.

GET

organizations

{org_id}

automations

Automatisierungen auflisten

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

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

fetch('https://api.devin.ai/v3/organizations/{org_id}/automations', 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",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  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"

	req, _ := http.NewRequest("GET", 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")

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

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

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

{
  "items": [
    {
      "actions": [
        {
          "prompt": "<string>",
          "session": {
            "bypass_approval": false,
            "notifications": {
              "slack": {
                "channel_id": "<string>"
              }
            },
            "platform": "<string>",
            "playbook_id": "<string>",
            "repos": [],
            "tags": []
          },
          "type": "start_session"
        }
      ],
      "automation_id": "<string>",
      "created_at": 123,
      "created_by": {
        "id": "<string>",
        "name": "<string>"
      },
      "enabled": true,
      "name": "<string>",
      "triggers": [
        {
          "event_type": "<string>",
          "trigger_id": "<string>",
          "conditions": {
            "any": [
              {
                "all": [
                  {
                    "field": "<string>",
                    "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>",
        "name": "<string>"
      },
      "last_invocation": {
        "fired_at": 123,
        "status": "<string>"
      },
      "limits": {
        "invocations": {
          "max_per_window": 2,
          "window_seconds": 61
        },
        "max_acu_limit": 500
      },
      "metadata": {},
      "notifications": {
        "email": {
          "recipients": [
            "<string>"
          ]
        },
        "slack": {
          "channel_id": "<string>"
        }
      },
      "run_as": {
        "type": "organization"
      },
      "security_profile": {
        "profile_id": "<string>",
        "warnings": []
      },
      "session_settings": {
        "net_policy": {
          "allow": [
            {
              "hostname": "<string>"
            }
          ]
        }
      },
      "template_id": "<string>",
      "tools": {
        "linear_enabled": true,
        "mcp_servers": [],
        "slack_channels": []
      }
    }
  ],
  "end_cursor": "<string>",
  "has_next_page": false,
  "total": 123
}

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

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

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

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

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

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

Berechtigungen

Erfordert einen Service-Benutzer mit der Berechtigung ViewOrgAutomations auf Organisationsebene.

Filterung

Unterstützt die Filterung nach search, creator_id, enabled, event_type und agent_types (mehrfach angeben, um nach einem von mehreren Typen zu filtern). Die Abfrageparameter metadata.<key>=<value> filtern nach Metadaten-Labels (exakte Übereinstimmung; mehrere Filter werden mit UND verknüpft). Die Ergebnisse werden in absteigender Reihenfolge nach Aktualität mit cursorbasierter Paginierung (after, first) zurückgegeben. total wird nur zurückgegeben, wenn ein einzelner ungefilterter Scan die gesamte Ergebnismenge abgedeckt hat.

Autorisierungen

Authorization

string

header

erforderlich

Servicebenutzer-Anmeldedaten (Präfix: cog_)

Pfadparameter

org_id

string

erforderlich

Organisations-ID (Präfix: org-)

Beispiel:

"org-abc123def456"

Abfrageparameter

after

string | null

first

integer

Standard:100

Erforderlicher Bereich: 1 <= x <= 200

string | null

creator_id

string | null

enabled

boolean | null

event_type

string | null

agent_types

enum<string>[] | null

Verfügbare Optionen:

new_session,

long_running,

auto_triage,

remediate_finding,

triage_session,

incident_session

Antwort

Erfolgreiche Antwort

items

AutomationResponse · object[]

erforderlich

Show child attributes

end_cursor

string | null

Cursor zum Abrufen der nächsten Seite oder None, wenn dies die letzte Seite ist.

has_next_page

boolean

Standard:false

Ob nach dieser Seite weitere Einträge verfügbar sind.

total

integer | null

Optionale Gesamtanzahl (kann aus Leistungsgründen ausgelassen werden).

⌘I

Erste Schritte

Konzepte

Agent Lifecycle

Kontextverwaltung

Umgebungsverwaltung