---
title: "Nested team invite"
method: POST
path: "/api/v1/nested-teams/invite"
tags: ["Nested teams"]
---

# Nested team invite

`POST /api/v1/nested-teams/invite`

Required scope: `team-members:write` </br>Organization authorization: `supported`

## Request body

- NestedTeamInvite
  - `parentTeamId` integer, required — Id of the parent team, the one who sends the invite
  - `nestedTeamId` integer, required — Id of the nested team, the one who receives the invite
  - `priceGroupId` integer, required — Price group applied to the nested team
  - `access` 'all' | 'selected', required
  - `selectedChargePointIds` integer[], nullable — List of charge point ids nested team access will be assigned to
  - `selectedSiteIds` integer[], nullable — List of site ids nested team access will be assigned to

## Response `200`

Nested team invite sent

- NestedTeam
  - `id` integer — Id of the nested team relation
  - `parentTeam` PublicTeam, required
    - `id` integer — Id of the public team
    - `publicName` string, nullable — Public name of the team
    - `memberCount` integer, nullable — Number of members in the team
  - `nestedTeam` PublicTeam
    - `id` integer — Id of the public team
    - `publicName` string, nullable — Public name of the team
    - `memberCount` integer, nullable — Number of members in the team
  - `priceGroup` PriceGroup1
    - `id` integer — Id of the price group
    - `name` string, required — Name of the price group
  - `invitedByUser` PublicUser1
    - `id` integer — Id of the user
    - `firstName` string, nullable — First name of the user
    - `lastName` string, nullable — Last name of the user
    - `displayName` string, nullable — Display name of the user
  - `userRole` 'user', required — The role assigned to the nested team
  - `access` 'all' | 'selected', required
  - `state` 'requested' | 'invited' | 'accepted' | 'rejected_at' | 'blocked' | 'expired', required
  - `selectedChargePointIds` integer[], nullable — Selected charge points nested team has access to
  - `note` string, nullable — Internal note for this nested team
  - `createdAt` string, date-time, required — Datetime of the creation of nested team invite
  - `updatedAt` string, date-time, nullable — Datetime of the update of nested team invite
  - `invitedAt` string, date-time, nullable — Datetime nested team was invited

## Other responses

- `400` — The request is invalid
- `401` — Consumer with provided credentials was not found
- `403` — Operator doesn't have access to resource
- `404` — Entity with the provided id was not found

---

[API](https://skmtc.net/monta/apis/monta-partner-api.md) · [All operations](https://skmtc.net/monta/apis/monta-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monta/monta-partner-api/versions/517e18f11015/schema)