Chevre REST API Endpoints — Automations Reference

Automations let you define rules that execute actions automatically in response to events or on a schedule. Each automation belongs to a project and consists of a trigger (what starts it) and one or more actions (what it does). Use the endpoints below to manage automations and inspect their run history. All requests require your API key in the Authorization header as Bearer <your_api_key>.

List automations

GET https://api.chevre.io/v1/automations Returns a paginated list of all automations accessible to the authenticated API key, across all projects the key has access to. Results are ordered by creation date, newest first. To retrieve automations scoped to a specific project, use the List automations in a project endpoint.

Query parameters

integer

default:"1"

The page number to retrieve. Must be a positive integer.

integer

default:"20"

The number of automations to return per page. Minimum is 1, maximum is 100.

string

Filter results to only automations belonging to the specified project (e.g. proj_01ABC). Optional.

Example request

curl --request GET \
  --url "https://api.chevre.io/v1/automations?page=1&per_page=20" \
  --header "Authorization: Bearer <your_api_key>" \
  --header "Accept: application/json"

import requests

response = requests.get(
    "https://api.chevre.io/v1/automations",
    params={"page": 1, "per_page": 20},
    headers={"Authorization": "Bearer <your_api_key>"},
)
print(response.json())

const response = await fetch(
  "https://api.chevre.io/v1/automations?page=1&per_page=20",
  {
    headers: {
      Authorization: "Bearer <your_api_key>",
      Accept: "application/json",
    },
  }
);
const data = await response.json();
console.log(data);

Example response

200

{
  "data": [
    {
      "id": "auto_01GHI",
      "project_id": "proj_01ABC",
      "name": "New Task Alert",
      "type": "event",
      "enabled": true,
      "trigger": {
        "event": "task.created",
        "filters": []
      },
      "created_at": "2024-03-10T12:00:00Z",
      "updated_at": "2024-05-01T09:45:00Z"
    },
    {
      "id": "auto_02JKL",
      "project_id": "proj_01ABC",
      "name": "Weekly Digest",
      "type": "scheduled",
      "enabled": true,
      "trigger": {
        "schedule": "0 9 * * 1"
      },
      "created_at": "2024-04-01T08:00:00Z",
      "updated_at": "2024-04-01T08:00:00Z"
    }
  ],
  "meta": {
    "total": 2,
    "page": 1,
    "per_page": 20
  }
}

Response fields

array

An array of automation objects.

Show automation object

string

The unique identifier for the automation, prefixed with auto_.

string

The ID of the project this automation belongs to.

string

The display name of the automation.

string

The automation type. Either "event" (triggered by an event) or "scheduled" (triggered on a cron schedule).

boolean

Whether the automation is currently active. Disabled automations do not execute.

object

The trigger configuration. For event automations, contains an event name and optional filters. For scheduled automations, contains a schedule cron expression.

string

ISO 8601 timestamp of when the automation was created.

string

ISO 8601 timestamp of the most recent update.

object

Pagination metadata for the response.

Show meta object

integer

Total number of automations accessible to your API key.

integer

The current page number returned.

integer

The number of results per page used for this response.

List automations in a project

GET https://api.chevre.io/v1/projects/{project_id}/automations Returns all automations defined in the specified project. Results are ordered by creation date, newest first.

Path parameters

string

required

The unique identifier of the project whose automations you want to list (e.g. proj_01ABC).

Example request

curl --request GET \
  --url "https://api.chevre.io/v1/projects/proj_01ABC/automations" \
  --header "Authorization: Bearer <your_api_key>" \
  --header "Accept: application/json"

import requests

response = requests.get(
    "https://api.chevre.io/v1/projects/proj_01ABC/automations",
    headers={"Authorization": "Bearer <your_api_key>"},
)
print(response.json())

const response = await fetch(
  "https://api.chevre.io/v1/projects/proj_01ABC/automations",
  {
    headers: {
      Authorization: "Bearer <your_api_key>",
      Accept: "application/json",
    },
  }
);
const data = await response.json();
console.log(data);

Example response

200

{
  "data": [
    {
      "id": "auto_01GHI",
      "project_id": "proj_01ABC",
      "name": "New Task Alert",
      "type": "event",
      "enabled": true,
      "trigger": {
        "event": "task.created",
        "filters": []
      },
      "created_at": "2024-03-10T12:00:00Z",
      "updated_at": "2024-05-01T09:45:00Z"
    },
    {
      "id": "auto_02JKL",
      "project_id": "proj_01ABC",
      "name": "Weekly Digest",
      "type": "scheduled",
      "enabled": true,
      "trigger": {
        "schedule": "0 9 * * 1"
      },
      "created_at": "2024-04-01T08:00:00Z",
      "updated_at": "2024-04-01T08:00:00Z"
    }
  ]
}

Response fields

array

An array of automation objects for the project.

Show automation object

string

The unique identifier for the automation, prefixed with auto_.

string

The ID of the project this automation belongs to.

string

The display name of the automation.

string

The automation type. Either "event" (triggered by an event) or "scheduled" (triggered on a cron schedule).

boolean

Whether the automation is currently active. Disabled automations do not execute.

object

The trigger configuration. For event automations, contains an event name and optional filters. For scheduled automations, contains a schedule cron expression.

string

ISO 8601 timestamp of when the automation was created.

string

ISO 8601 timestamp of the most recent update.

Create an automation

POST https://api.chevre.io/v1/automations Creates a new automation in the specified project. You can create both event-driven and scheduled automations. An automation must have at least one action defined to be valid.

Request body

string

required

The ID of the project to create the automation in.

string

required

The display name for the automation. Must be between 1 and 255 characters.

string

required

The type of automation. Accepted values:

"event" — fires when a specified event occurs in the project.
"scheduled" — fires on a cron schedule.

boolean

default:"true"

Whether the automation should be active immediately after creation. Set to false to create the automation in a paused state.

object

required

The trigger configuration for the automation.

Show trigger fields

string

For type: "event" automations. The event name that fires this automation (e.g. "task.created", "task.completed", "member.invited").

array

For type: "event" automations. An optional array of filter conditions that must all match for the automation to fire. Each filter object contains field, operator, and value keys.

string

For type: "scheduled" automations. A cron expression defining the schedule (e.g. "0 9 * * 1" for every Monday at 9 AM). Uses the workspace timezone.

array

required

An ordered list of actions to execute when the automation fires. Each action must include a type and a config object specific to that action type.

Show action fields

string

The action type. Supported values include "send_slack_message", "send_email", "create_task", "update_task", and "call_webhook".

object

Configuration specific to the action type. For example, send_slack_message requires channel and message fields. Template variables in the form {{resource.field}} are supported.

Example request

curl --request POST \
  --url "https://api.chevre.io/v1/automations" \
  --header "Authorization: Bearer <your_api_key>" \
  --header "Content-Type: application/json" \
  --data '{
    "project_id": "proj_01ABC",
    "name": "New Task Alert",
    "type": "event",
    "enabled": true,
    "trigger": {
      "event": "task.created",
      "filters": []
    },
    "actions": [
      {
        "type": "send_slack_message",
        "config": {
          "channel": "#general",
          "message": "New task created: {{task.name}}"
        }
      }
    ]
  }'

import requests

response = requests.post(
    "https://api.chevre.io/v1/automations",
    json={
        "project_id": "proj_01ABC",
        "name": "New Task Alert",
        "type": "event",
        "enabled": True,
        "trigger": {
            "event": "task.created",
            "filters": [],
        },
        "actions": [
            {
                "type": "send_slack_message",
                "config": {
                    "channel": "#general",
                    "message": "New task created: {{task.name}}",
                },
            }
        ],
    },
    headers={"Authorization": "Bearer <your_api_key>"},
)
print(response.json())

const response = await fetch("https://api.chevre.io/v1/automations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <your_api_key>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    project_id: "proj_01ABC",
    name: "New Task Alert",
    type: "event",
    enabled: true,
    trigger: {
      event: "task.created",
      filters: [],
    },
    actions: [
      {
        type: "send_slack_message",
        config: {
          channel: "#general",
          message: "New task created: {{task.name}}",
        },
      },
    ],
  }),
});
const data = await response.json();
console.log(data);

Example response

201

{
  "data": {
    "id": "auto_01GHI",
    "project_id": "proj_01ABC",
    "name": "New Task Alert",
    "type": "event",
    "enabled": true,
    "trigger": {
      "event": "task.created",
      "filters": []
    },
    "actions": [
      {
        "type": "send_slack_message",
        "config": {
          "channel": "#general",
          "message": "New task created: {{task.name}}"
        }
      }
    ],
    "created_at": "2024-06-01T14:22:00Z",
    "updated_at": "2024-06-01T14:22:00Z"
  }
}

Response fields

object

The newly created automation object.

Show automation object

string

The unique identifier for the automation, prefixed with auto_.

string

The ID of the project this automation belongs to.

string

The display name of the automation.

string

The automation type: "event" or "scheduled".

boolean

Whether the automation is currently active.

object

The trigger configuration as provided in the request.

array

The ordered list of actions as provided in the request.

string

ISO 8601 timestamp of when the automation was created.

string

ISO 8601 timestamp of the most recent update.

Get an automation

GET https://api.chevre.io/v1/automations/{id} Retrieves a single automation by its ID, including its full trigger and actions configuration.

Path parameters

string

required

The unique identifier of the automation to retrieve (e.g. auto_01GHI).

Example request

curl --request GET \
  --url "https://api.chevre.io/v1/automations/auto_01GHI" \
  --header "Authorization: Bearer <your_api_key>" \
  --header "Accept: application/json"

import requests

response = requests.get(
    "https://api.chevre.io/v1/automations/auto_01GHI",
    headers={"Authorization": "Bearer <your_api_key>"},
)
print(response.json())

const response = await fetch(
  "https://api.chevre.io/v1/automations/auto_01GHI",
  {
    headers: {
      Authorization: "Bearer <your_api_key>",
      Accept: "application/json",
    },
  }
);
const data = await response.json();
console.log(data);

Example response

200

{
  "data": {
    "id": "auto_01GHI",
    "project_id": "proj_01ABC",
    "name": "New Task Alert",
    "type": "event",
    "enabled": true,
    "trigger": {
      "event": "task.created",
      "filters": []
    },
    "actions": [
      {
        "type": "send_slack_message",
        "config": {
          "channel": "#general",
          "message": "New task created: {{task.name}}"
        }
      }
    ],
    "created_at": "2024-03-10T12:00:00Z",
    "updated_at": "2024-05-01T09:45:00Z"
  }
}

Response fields

object

The requested automation object with full configuration.

Show automation object

string

The unique identifier for the automation.

string

The ID of the project this automation belongs to.

string

The display name of the automation.

string

The automation type: "event" or "scheduled".

boolean

Whether the automation is currently active.

object

The trigger configuration object.

array

The ordered list of action objects.

string

ISO 8601 timestamp of when the automation was created.

string

ISO 8601 timestamp of the most recent update.

Update an automation

PATCH https://api.chevre.io/v1/automations/{id} Updates one or more fields on an existing automation. Send only the fields you want to change. To pause an automation without deleting it, set enabled to false.

Path parameters

string

required

The unique identifier of the automation to update (e.g. auto_01GHI).

Request body

string

A new display name for the automation.

boolean

Set to false to pause the automation, or true to re-enable it.

object

A replacement trigger configuration. The entire trigger object is replaced — partial updates to trigger subfields are not supported.

array

A replacement list of actions. The entire actions array is replaced — partial updates to individual actions are not supported.

Example request

curl --request PATCH \
  --url "https://api.chevre.io/v1/automations/auto_01GHI" \
  --header "Authorization: Bearer <your_api_key>" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "New Task Slack Alert",
    "enabled": false
  }'

import requests

response = requests.patch(
    "https://api.chevre.io/v1/automations/auto_01GHI",
    json={"name": "New Task Slack Alert", "enabled": False},
    headers={"Authorization": "Bearer <your_api_key>"},
)
print(response.json())

const response = await fetch(
  "https://api.chevre.io/v1/automations/auto_01GHI",
  {
    method: "PATCH",
    headers: {
      Authorization: "Bearer <your_api_key>",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ name: "New Task Slack Alert", enabled: false }),
  }
);
const data = await response.json();
console.log(data);

Example response

200

{
  "data": {
    "id": "auto_01GHI",
    "project_id": "proj_01ABC",
    "name": "New Task Slack Alert",
    "type": "event",
    "enabled": false,
    "trigger": {
      "event": "task.created",
      "filters": []
    },
    "actions": [
      {
        "type": "send_slack_message",
        "config": {
          "channel": "#general",
          "message": "New task created: {{task.name}}"
        }
      }
    ],
    "created_at": "2024-03-10T12:00:00Z",
    "updated_at": "2024-06-10T10:00:00Z"
  }
}

Response fields

object

The updated automation object, reflecting all applied changes.

Show automation object

string

The unique identifier for the automation.

string

The ID of the project this automation belongs to.

string

The updated or unchanged display name.

string

The automation type: "event" or "scheduled". Cannot be changed after creation.

boolean

The updated enabled state of the automation.

object

The updated or unchanged trigger configuration.

array

The updated or unchanged list of actions.

string

ISO 8601 timestamp of when the automation was originally created.

string

ISO 8601 timestamp of this update.

Delete an automation

DELETE https://api.chevre.io/v1/automations/{id} Permanently deletes an automation and all of its run history. Disable the automation first if you want to stop it from running without losing its configuration and history.

This action is permanent and irreversible. The automation’s run history will also be deleted. If you only want to stop the automation from running, set enabled to false using the Update an automation endpoint instead.

Path parameters

string

required

The unique identifier of the automation to delete (e.g. auto_01GHI).

Example request

curl --request DELETE \
  --url "https://api.chevre.io/v1/automations/auto_01GHI" \
  --header "Authorization: Bearer <your_api_key>"

import requests

response = requests.delete(
    "https://api.chevre.io/v1/automations/auto_01GHI",
    headers={"Authorization": "Bearer <your_api_key>"},
)
print(response.status_code)  # 204

const response = await fetch(
  "https://api.chevre.io/v1/automations/auto_01GHI",
  {
    method: "DELETE",
    headers: {
      Authorization: "Bearer <your_api_key>",
    },
  }
);
console.log(response.status); // 204

Example response

204

// No content returned on successful deletion

A successful deletion returns HTTP 204 No Content with an empty response body.

List automation runs

GET https://api.chevre.io/v1/automations/{id}/runs Returns the run history for a specific automation, ordered by start time with the most recent run first. Use this endpoint to debug automation failures or audit execution history.

Path parameters

string

required

The unique identifier of the automation whose run history you want to retrieve (e.g. auto_01GHI).

Query parameters

integer

default:"1"

The page number to retrieve.

integer

default:"20"

The number of runs to return per page. Maximum is 100.

Example request

curl --request GET \
  --url "https://api.chevre.io/v1/automations/auto_01GHI/runs?page=1&per_page=20" \
  --header "Authorization: Bearer <your_api_key>" \
  --header "Accept: application/json"

import requests

response = requests.get(
    "https://api.chevre.io/v1/automations/auto_01GHI/runs",
    params={"page": 1, "per_page": 20},
    headers={"Authorization": "Bearer <your_api_key>"},
)
print(response.json())

const response = await fetch(
  "https://api.chevre.io/v1/automations/auto_01GHI/runs?page=1&per_page=20",
  {
    headers: {
      Authorization: "Bearer <your_api_key>",
      Accept: "application/json",
    },
  }
);
const data = await response.json();
console.log(data);

Example response

200

{
  "data": [
    {
      "id": "run_01MNO",
      "automation_id": "auto_01GHI",
      "status": "success",
      "started_at": "2024-06-10T09:00:05Z",
      "completed_at": "2024-06-10T09:00:06Z",
      "error_message": null
    },
    {
      "id": "run_02PQR",
      "automation_id": "auto_01GHI",
      "status": "failed",
      "started_at": "2024-06-09T09:00:04Z",
      "completed_at": "2024-06-09T09:00:04Z",
      "error_message": "Slack channel #general not found."
    }
  ],
  "meta": {
    "total": 2,
    "page": 1,
    "per_page": 20
  }
}

Response fields

array

An array of run objects for the automation.

Show run object

string

The unique identifier for this run, prefixed with run_.

string

The ID of the automation that produced this run.

string

The result of the run. One of:

"success" — all actions executed without errors.
"failed" — one or more actions encountered an error.
"pending" — the run is currently in progress.

string

ISO 8601 timestamp of when the run began.

string

ISO 8601 timestamp of when the run finished. null if the run is still pending.

string

A human-readable description of the error, if the run failed. null for successful or pending runs.

object

Pagination metadata.

Show meta object

integer

Total number of runs in the automation’s history.

integer

The current page number returned.

integer

The number of results per page used for this response.

​List automations

​Query parameters

​Example request

​Example response

​Response fields

​List automations in a project

​Path parameters

​Example request

​Example response

​Response fields

​Create an automation

​Request body

​Example request

​Example response

​Response fields

​Get an automation

​Path parameters

​Example request

​Example response

​Response fields

​Update an automation

​Path parameters

​Request body

​Example request

​Example response

​Response fields

​Delete an automation

​Path parameters

​Example request

​Example response

​List automation runs

​Path parameters

​Query parameters

​Example request

​Example response

​Response fields

List automations

Query parameters

Example request

Example response

Response fields

List automations in a project

Path parameters

Example request

Example response

Response fields

Create an automation

Request body

Example request

Example response

Response fields

Get an automation

Path parameters

Example request

Example response

Response fields

Update an automation

Path parameters

Request body

Example request

Example response

Response fields

Delete an automation

Path parameters

Example request

Example response

List automation runs

Path parameters

Query parameters

Example request

Example response

Response fields