---
title: "Add Projects To Group"
method: POST
path: "/project-groups/{projectGroupId}/projects"
tags: ["Project Group"]
---

# Add Projects To Group

`POST /project-groups/{projectGroupId}/projects`

Adds projects to the project group.

The projects are not added instantly. To check the status use the [Get Project Group](#/operations/GetProjectGroup) endpoint.

## Query parameters

- `fields` string

## Headers

- `Authorization` string, required
- `X-LC-Tenant` string, required

## Request body

- AddProjectsToGroupRequest — Input for adding projects to group.
  - `projects` ProjectGroupProjectRequest[], required — The projects to be added to group.
    - `id` string, required — A project id.

## Response `202`

Accepted

- AddProjectsToGroupResponse — Add Projects To Group response.
  - `id` string, required — The project group identifier.
  - `name` string — The project group name.
  - `description` string — The project group description.
  - `status` 'new' | 'inProgress' | 'completed' | 'deleting' — The status of the projects in the project group. - `new`: the group is new created, or all projects in the group have status New - `inProgress`: at least one project in the group is in progress - `completed`: all projects in the group have status Completed - `deleting`: the group is getting deleted and the projects are removing from it
  - `projects` ProjectGroupProject[] — The projects in the project group.
    - `id` string, required — The project identifier.
    - `status` 'attaching' | 'attached' | 'detaching' | 'updating' | 'failed' — The project's status.
  - `location` FolderV2 — Folder used for resource storage.
    - `id` string, required — The folder identifier.
    - `name` string — <div style="display:inline; float:right; color:#008080; margin-top:-23px; font-size:11px">default</div><div style="display: inline;">The name of the folder.</div>
    - `hasParent` boolean, nullable — Indicates if the folder has a parent folder.
    - `path` FolderPath[] — The hierarchical path. It consists of all the items of the path in reverse order, the parent of the current folder being the first in the list, and the root of the account being the last.
      - `id` string, required — The folder identifier.
      - `name` string, required — The name of the folder.
      - `location` string — <div style="display:inline; float:right; color:#008080; margin-top:-23px; font-size:11px">default</div>The location identifier.
      - `hasParent` boolean, nullable — <div style="display:inline; float:right; color:#008080; margin-top:-23px; font-size:11px">default</div>Indicates if the folder has a parent folder.
  - `shortId` string
  - `createdAt` string, date-time — The date and time when the project group was created. <br> UTC Timezone <br> Allowed formats: <br> "YYYY-MM-DDThh:mmZ" <br> "YYYY-MM-DDThh:mm:ssZ" <br> "YYYY-MM-DDThh:mm:ss.sZ" <br> "YYYY-MM-DDThh:mm:ss.ssZ" <br> "YYYY-MM-DDThh:mm:ss.sssZ"
  - `lastModifiedAt` string, date-time — The date and time when the project group was modified. <br> UTC Timezone <br> Allowed formats: <br> "YYYY-MM-DDThh:mmZ" <br> "YYYY-MM-DDThh:mm:ssZ" <br> "YYYY-MM-DDThh:mm:ss.sZ" <br> "YYYY-MM-DDThh:mm:ss.ssZ" <br> "YYYY-MM-DDThh:mm:ss.sss

## Other responses

- `400` — Error codes: * “invalid”: Invalid input in the query parameter mentioned in the “name” field on the error response.
- `401` — The user could not be identified.
- `403` — Error codes: * "forbidden": The authenticated user is not allowed to add the projects to group. * "forbidden": The projects are not found or the authenticated user does not have acces to them. * "benefitNotAvailable": Your subscription does not include access to the requested type of benefit. * "quotaReached": The maximum number of projects allowed for your project group has already been reached.
- `404` — Error codes: * "notFound": The project group could not be found by identifier.
- `409` — Error codes: * “conflict”: A project with status "detaching" cannot be added.

---

[API](https://skmtc.net/rws/apis/trados-cloud-platform-api.md) · [All operations](https://skmtc.net/rws/apis/trados-cloud-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rws/trados-cloud-platform-api/revisions/d42dac7c28a3/schema)