Lister les automatisations

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"
}

Automatisations (Organisation)

Lister les automatisations

Liste toutes les automatisations de l’organisation, de la plus récente à la plus ancienne.

Prend en charge les paramètres de requête metadata.<key>=<value> pour filtrer selon les libellés de métadonnées (correspondance exacte ; plusieurs filtres sont combinés avec ET).

agent_types filtre les automatisations contenant au moins une action d’un type d’agent donné ; répétez le paramètre pour correspondre à plusieurs types (OU). Les charges utiles des actions sont stockées dans l’espace de stockage des données client plutôt que dans des colonnes interrogeables ; ce filtre analyse les pages côté serveur. total est renvoyé uniquement lorsqu’une seule analyse non filtrée couvre l’ensemble des résultats (première page, aucune page suivante, aucun élément masqué) ; sinon, il est omis plutôt que de renvoyer un nombre incluant des automatisations que l’API ne renverra jamais.

GET

organizations

{org_id}

automations

Lister les automatisations

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"
}

Autorisations

Requiert un utilisateur de service disposant de l’autorisation ViewOrgAutomations au niveau de l’organisation.

Filtrage

Prend en charge le filtrage par search, creator_id, enabled, event_type et agent_types (à répéter pour correspondre à l’un des différents types). Les paramètres de requête metadata.<key>=<value> filtrent selon les libellés de métadonnées (correspondance exacte ; plusieurs filtres sont combinés avec l’opérateur ET). Les résultats sont classés du plus récent au plus ancien avec une pagination par curseur (after, first). total n’est renvoyé que lorsqu’un seul scan non filtré couvre l’ensemble des résultats.

Autorisations

Authorization

string

header

requis

Identifiant de compte de service (préfixe : cog_)

Paramètres de chemin

org_id

string

requis

ID d’organisation (préfixe : org-)

Exemple:

"org-abc123def456"

Paramètres de requête

after

string | null

first

integer

défaut:100

Plage requise: 1 <= x <= 200

string | null

creator_id

string | null

enabled

boolean | null

event_type

string | null

agent_types

enum<string>[] | null

Options disponibles:

new_session,

long_running,

auto_triage,

remediate_finding,

triage_session,

incident_session

Réponse

Réponse réussie

items

AutomationResponse · object[]

requis

Show child attributes

end_cursor

string | null

Curseur permettant de récupérer la page suivante, ou None s’il s’agit de la dernière page.

has_next_page

boolean

défaut:false

Indique si d’autres éléments sont disponibles après cette page.

total

integer | null

Nombre total facultatif (peut être omis pour des raisons de performances).

⌘I

Premiers pas

Concepts

Cycle de vie de l’agent

Gestion du contexte

Gestion de l’environnement

Automatisation

Intégrations

Analyse

Observabilité

Devin pour la sécurité

Infrastructure

Identité et accès

Configuration

Ancienne API v1

Ancienne API v2

Lister les automatisations

Autorisations

Filtrage

Autorisations

Paramètres de chemin

Paramètres de requête

Réponse

​Autorisations

​Filtrage

Autorisations

Paramètres de chemin

Paramètres de requête

Réponse

Autorisations

Filtrage