Get inspired at ContentCon. Learn more and register today
Get inspired at ContentCon. Learn more and register today
Contentstack.comAcademyLogin
CS-log-dark.svgCS-log-dark.svg
  • Changelog
  • APIs
  • SDKs

Platform

  • Solution Center
  • Marketplace
  • Changelog
  • Developers & IT
  • Business users
  • Digital leaders
  • Developer Fast Track
  • Plans & Pricing

Solutions

  • Retail
  • Travel and tourism
  • Financial services
  • Technology
  • Manufacturing
  • E-commerce
  • Localization
  • Personalization
  • Portals and knowledge bases

Resources

  • Academy
  • Docs
  • Product updates
  • Contentstack on Contentstack
  • Blog
  • Insights and analyst reports
  • Webinars
  • Podcasts
  • Glossary
  • Content generative library
  • Community
  • Headless CMS
  • Composable AXP
  • Personalization
  • CDP

Customers

  • Case Studies
  • Customer Care
  • Contentstack Experience Awards
  • Customer support

Partners

  • Overview
  • Find a partner
  • Login

Company

  • About us
  • News
  • Customer support portal
  • Contact

Social

  • Facebook
  • LinkedIn
  • Instagram
  • GitHub
  • YouTube
  • Discord
  • X
LegalTermsPrivacyTrust Center

Cookie settings

Copyright © 2026 Contentstack Inc. All rights reserved.
/
  1. Home
  2. APIs
  3. Automations Management API
  4. Automations

Automations

markdownView as Markdown

Get all automations

GEThttps://automations-api.contentstack.com/v1/projects/{project_uid}/automations?limit={limit_value}&skip={skip_value}&asc={field_uid}&desc={field_uid}&include_count={boolean_value}&show_steps={boolean_value}

The Get all automations request returns comprehensive information of all the automations created in a project.

To configure the permissions for your application via OAuth, include the automationhub.automations:read scope.

To get a list of automations that are active, you need to pass the query={'active':'true'} parameter.

Note If you do not specify a value for the optional “limit” query parameter, the API request will by default return the initial 100 items.

Sample Response
Status|200 OK
123456789101112131415161718192021222324252627282930
{
    "rules": [
        {
            "id": "345ae3c033c643***f34fe90032eaaad",
            "title": "ChatGPT",
            "description": "",
            "project_id": "05732fe9f7d6454791715b09a3792f52",
            "org_id": "blt4051c65****df287",
            "user_id": "blt762406d****c6b33",
            "active": true,
            "updated_by": "blt762406****1c6b33",
            "throttle": false,
            "created_at": "2024-02-22T11:32:24.309Z",
            "updated_at": "2024-02-22T12:12:08.109Z"
        },
        {
            "id": "b5b0a755a51d4***81d0968fe19a5f62",
            "title": "ChatGPT Test 2",
            "description": "",
            "project_id": "05732fe9f7d6454791715b09a3792f52",
            "org_id": "blt4051c6***6ddf287",
            "user_id": "blt76240****71c6b33",
            "active": false,
            "updated_by": "blt76240****71c6b33",
            "throttle": false,
            "created_at": "2024-02-22T12:12:24.422Z",
            "updated_at": "2024-02-22T12:12:24.422Z"
        }
    ]
}

Get a single automation

GEThttps://automations-api.contentstack.com/v1/projects/{project_uid}/automations/{automation_uid}?show_steps={boolean_value}

The Get a single automation request fetches a specific automation from a project in which it was created.

To configure the permissions for your application via OAuth, include the automationhub.automations:read scope.

Sample Response
Status|200 OK
12345678910111213
{
    "id": "b5b0a755a51d4****1d0968fe19a5f62",
    "title": "ChatGPT Test 2",
    "description": "",
    "project_id": "05732fe9f7d6454791715b09a3792f52",
    "org_id": "blt4051c****6ddf287",
    "user_id": "blt76240****71c6b33",
    "active": false,
    "updated_by": "blt7624****e71c6b33",
    "throttle": false,
    "created_at": "2024-02-22T12:12:24.422Z",
    "updated_at": "2024-02-22T12:12:24.422Z"
}

Activate/Deactivate an automation

PATCHhttps://automations-api.contentstack.com/v1/projects/{project_uid}/automations/{automation_uid}

The Activate/Deactivate an automation request sets an automation to an active or inactive state.

To configure the permissions for your application via OAuth, include the automationhub.automations:write scope.

Note To activate/deactivate an automation, you must have a trigger and an action configured in your project.

Sample Request
123
{
 "active": true
}
Sample Response
Status|200 OK
123
{
    "message": "automation has been activated successfully"
}
Hide Parameters

URL Parameters

project_uidrequiredstring

Enter the Project UID of the project.

Example:

05732fe9f7d6454791715b09a3792f52

Query Parameters

limitoptionalstring
The “limit” parameter will return a specific number of automations (in between 0-100) in your response based on the value you provide. If there are 100 automations and you want to fetch only 30 automations, set the limit as 30.

Example:

30
skipoptionalstring
The “skip” parameter will skip a specific number of automations and return the remaining ones in your response based on the value you provide. If there are 12 automations and you want to exclude the first 2 automations, set this to 2 to fetch the remaining 10 automations.

Example:

2
ascoptionalstring
The “asc” parameter allows you to sort the list of automations in the ascending order with respect to the value of a specific field. The automations can be sorted by created_at, title, and updated_at values.

Example:

created_at
descoptionalstring
The “desc” parameter allows you to sort the list of automations in the descending order with respect to the value of a specific field. The automations can be sorted by created_at, title, and updated_at values.

Example:

created_at
include_countoptionalstring
Set this to “true” to include the total number (count) of automations present in a project accessible in an organization.

Example:

true
show_stepsoptionalstring

Set this to “true” to return all the steps, triggers associated with each automation in a project.

Example:

true

Headers

authtokenrequiredstring

Enter your authtoken. Refer Authentication for more details.

Example:

your_authtoken
organization_uidrequiredstring

Enter the Organization UID.

Example:

your_organization_uid
Hide Parameters

URL Parameters

project_uidrequiredstring

Enter the Project UID.

Example:

05732fe9f7d6454791715b09a3792f52
automation_uidrequiredstring

Enter the Automation UID.

Example:

e82a0f19673b4a808cd39743b71ae624

Query Parameters

show_stepsoptionalstring

Set this to “true” to return all the steps, triggers associated with each automation in a project.

Example:

true

Headers

authtokenrequiredstring

Enter your authtoken. Refer Authentication for more details.

Example:

your_authtoken
organization_uidrequiredstring

Enter the Organization UID.

Example:

your_organization_uid
Hide Parameters

URL Parameters

project_uidrequiredstring

Enter the Project UID.

Example:

05732fe9f7d6454791715b09a3792f52
automation_uidrequiredstring

Enter the Automation UID.

Example:

bb27e85b4b3b4fdbac4c19b7765b1d0f

Headers

authtokenoptionalstring

Enter your authtoken. Refer Authentication for more details.

Example:

your_authtoken
organization_uidrequiredstring

Enter the Organization UID.

Example:

your_organization_uid