Skip to main content
POST
SearchAutomations

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Authorization
string
header
required

This API uses OAuth2 with the Client Credential flow. Client Credentials must be sent in the BODY, not the headers. For an example of how to implement this, refer to the c1TokenSource.Token() function.

Body

application/json

The SearchAutomationsRequest message.

appId
string | null

Filter results to automations belonging to this application.

appIds
string[] | null

Filter results to automations belonging to any of the specified apps. Supersedes the singular app_id field when non-empty; when empty, the server falls back to app_id for backward compatibility.

direction
enum<string> | null

Direction to sort in. Unspecified falls back to ASC when sort_field is set; when sort_field is also unspecified, the server default order (created_at DESC) applies.

Available options:
SORT_DIRECTION_UNSPECIFIED,
SORT_DIRECTION_ASC,
SORT_DIRECTION_DESC
isDraft
boolean | null

Tri-state draft filter. Unset = include both drafts and published; true = drafts only; false = published only.

pageSize
integer<int32> | null

Maximum number of results to return per page.

pageToken
string | null

Pagination token from a previous SearchAutomationsResponse.

query
string | null

Free-text search query to filter automations by name or description.

refs
Automation Template Ref · object[] | null

Restrict results to automations matching these template references.

sortField
enum<string> | null

Column to sort by. Unspecified (0) means sort by created_at desc (server default).

Available options:
AUTOMATION_SORT_FIELD_UNSPECIFIED,
AUTOMATION_SORT_FIELD_DISPLAY_NAME,
AUTOMATION_SORT_FIELD_CREATED_AT,
AUTOMATION_SORT_FIELD_LAST_EXECUTED_AT,
AUTOMATION_SORT_FIELD_ENABLED,
AUTOMATION_SORT_FIELD_PRIMARY_TRIGGER_TYPE
statuses
enum<string>[] | null

Filter results by automation status. Empty or containing both ON and OFF applies no status filter.

Available options:
AUTOMATION_STATUS_FILTER_UNSPECIFIED,
AUTOMATION_STATUS_FILTER_ON,
AUTOMATION_STATUS_FILTER_OFF
triggerTypes
enum<string>[] | null

Filter results to automations with any of the specified trigger types.

Available options:
TRIGGER_TYPE_UNSPECIFIED,
TRIGGER_TYPE_USER_PROFILE_CHANGE,
TRIGGER_TYPE_APP_USER_CREATE,
TRIGGER_TYPE_APP_USER_UPDATE,
TRIGGER_TYPE_UNUSED_ACCESS,
TRIGGER_TYPE_USER_CREATED,
TRIGGER_TYPE_GRANT_FOUND,
TRIGGER_TYPE_GRANT_DELETED,
TRIGGER_TYPE_WEBHOOK,
TRIGGER_TYPE_SCHEDULE,
TRIGGER_TYPE_FORM,
TRIGGER_TYPE_SCHEDULE_APP_USER,
TRIGGER_TYPE_ACCESS_CONFLICT,
TRIGGER_TYPE_SCHEDULE_NO_USER

Response

200 - application/json

Successful response

The SearchAutomationsResponse message.

list
Automation · object[] | null

The page of automations matching the search criteria.

nextPageToken
string | null

Token to retrieve the next page of results, empty when no more results exist.