---
title: "Search projects"
method: GET
path: "/automation-studio/projects"
tags: ["Automation Studio"]
---

# Search projects

`GET /automation-studio/projects`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/automation-studio/projects`
- Auth: none declared

Searches projects.

## Query parameters

- `equals` AutomationStudioProjectsGetParametersEquals
  - `_id` string
  - `iid` number, double
  - `name` string
  - `createdBy` string
  - `lastUpdatedBy` string
- `in` AutomationStudioProjectsGetParametersIn
  - `_id` union
    - string
    - unknown[]
      - unknown
  - `iid` union
    - string
    - unknown[]
      - unknown
  - `name` union
    - string
    - unknown[]
      - unknown
  - `createdBy` union
    - string
    - unknown[]
      - unknown
  - `lastUpdatedBy` union
    - string
    - unknown[]
      - unknown
- `starts-with` AutomationStudioProjectsGetParametersStartsWith
  - `name` string
- `contains` AutomationStudioProjectsGetParametersContains
  - `name` string
  - `description` string
  - `name,description` string
  - `description,name` string
- `sort` '_id' | 'iid' | 'name' | 'created' | 'lastUpdated' | 'createdBy' | 'lastUpdatedBy'
- `order` 'asc' | 'desc'
- `skip` union
  - number, double
  - string
- `limit` union
  - number, double
  - string

## Response `200`

Projects

- AutomationStudioGetProjectsResponse200
  - `message` string
  - `data` AutomationStudioProjectsHttp[]
    - `_id` string: A string representation of a MongoDB ObjectId
    - `iid` integer: Incrementing integer ID
    - `name` string: Project name
    - `description` string: A free-form block of text for describing project intent and function
    - `members` AutomationStudioProjectsHttpMembersItems[]
      - `type` 'account' | 'group', required
      - `reference` string, required: A string representation of a MongoDB ObjectId
      - `role` 'owner' | 'editor' | 'operator' | 'viewer', required
      - `missing` boolean
      - `username` string
      - `name` string
      - `provenance` string
    - `accessControl` AutomationStudioProjectsHttpAccessControl
      - `read` string[], required
      - `execute` string[], required
      - `write` string[], required
      - `manage` string[], required
    - `componentIidIndex` integer: Read-only property providing incrementing integer ID values for child components within a project
    - `components` AutomationStudioProjectsHttpComponentsItems[]: A list of member components in the project
      - `iid` integer: Incrementing integer ID
      - `type` 'workflow' | 'jsonForm' | 'mopAnalyticTemplate' | 'mopCommandTemplate' | 'template' | 'transformation': String denoting the type of component
      - `reference` string
      - `folder` string
    - `folders` AutomationStudioProjectsHttpFoldersItems[]: A list of folders and their members
      - union
        - AutomationStudioProjectsHttpFoldersItems0
          - `nodeType` 'folder' | 'component', required: String denoting the nodeType of the folder node
          - `name` string, required: Folder name
          - `children` AutomationStudioProjectsHttpFoldersItemsOneOf0ChildrenItems[], required
            - union
              - …
        - AutomationStudioProjectsHttpFoldersItems1
          - `iid` integer, required: Incrementing integer ID
          - `nodeType` 'folder' | 'component', required: String denoting the nodeType of the folder node
          - `type` 'workflow' | 'jsonForm' | 'mopAnalyticTemplate' | 'mopCommandTemplate' | 'template' | 'transformation': String denoting the type of component
          - `reference` string
    - `created` string, date-time: ISO Date String
    - `createdBy` unknown
    - `lastUpdated` string, date-time: ISO Date String
    - `lastUpdatedBy` unknown
    - `versionHistory` AutomationStudioProjectsHttpVersionHistoryItems[]
      - `versionNumber` integer, required
      - `commitMessage` string, required
      - `author` string, required
      - `branchName` string, required
    - `gitConfiguration` AutomationStudioProjectsHttpGitConfiguration
      - `connectionType` 'GitHub' | 'GitLab', required
      - `repositoryPath` string, required
      - `branchName` string, required
      - `projectPath` string, required
  - `metadata` AutomationStudioProjectsGetResponsesContentApplicationJsonSchemaMetadata
    - `skip` number, double
    - `limit` number, double
    - `total` number, double
    - `previousPageSkip` number, double, nullable
    - `nextPageSkip` number, double, nullable

## Other responses

- `500`: Error response from API

## Changes

- **2026-10-31** `2095cc90e583`: 2 info
  - api tag `Automation Studio` added
  - api tag `automationStudio` removed

[Operation history](https://skmtc.dev/itential/apis/itential-2/changes/automation-studio/projects/get.md)

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)