# Create a delegated admin relationship

**POST /v1/Customers/delegated-admin-relationships**

Create a delegated admin relationship. Since this resource is specific to the Microsoft provider, this request is only valid for provider customers that belong to a Microsoft tenant/provider.
**Available to the roles:** csp, reseller


## Servers
- https://api.cloudcockpit.com: https://api.cloudcockpit.com ()


## Authentication methods
- Bearer auth


## Parameters
### Headers
- **X-Tenant** (string)
  The domain used to access the portal.
- **Authorization** (string)
  JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"
- **X-Correlation-Id** (string(uuid))
  This header is optional and by setting it you can correlate the audit logs made by this request.



### Body: application/json (object)
The request body with the info to perform the update. This body contains an JSON Object with four properties (providerInstanceId, displayName, AutoExtendEnabled and CustomSelectedGdapRolesIds).
- **providerInstanceId** (string(uuid))
  The GUID identifier for the provider instance.
- **displayName** (string | null)
  The display name to set in the relationship. This may be up to 50 characters.
- **autoExtendEnabled** (boolean)
  The flag to indicate whether the relationship is auto extend enabled.
- **customSelectedGdapRolesIds** (array[string] | null)
  A list of ids of the custom GDAP roles selection.
  In the absence of this property (null), a new relationship with the default roles set in the portal will be created.
  The ids of the possible roles to chose from can be found here https://learn.microsoft.com/en-us/entra/identity/role-based-access-control/permissions-reference#all-roles


## Responses
### 200
OK

#### Body: application/json (object)
- **id** (string | null)
  The id of the relationship.
- **displayName** (string | null)
  The display name of the relationship.
- **duration** (string | null)
  The duration of the relationship
- **status** (object)

- **createdDateTime** (string(date-time) | null)
  The date when the relationship was created
- **activatedDateTime** (string(date-time) | null)
  The date when the relationship was activated
- **lastModifiedDateTime** (string(date-time) | null)
  The date when the relationship was last modified
- **endDateTime** (string(date-time) | null)
  The date when the relationship ends
- **accessDetails** (object)

- **autoExtendDuration** (string | null)
  The auto extend duration of the relationship

### 400
Bad Request

#### Body: application/json (object)
- **statusCode** (integer(int32))
  The HTTP status code that represents a specific error scenario.
- **type** (string | null)
  The type of error that occurred.
- **description** (string | null)
  Describes the error scenario that occurred.
- **correlationId** (string | null)
  The correlationId of the request that originated the error.
- **errors** (array[object] | null)
  A list containing the detail of the errors that occurred in this error scenario.

### 401
Unauthorized

### 403
Forbidden

### 404
Not Found

#### Body: application/json (object)
- **statusCode** (integer(int32))
  The HTTP status code that represents a specific error scenario.
- **type** (string | null)
  The type of error that occurred.
- **description** (string | null)
  Describes the error scenario that occurred.
- **correlationId** (string | null)
  The correlationId of the request that originated the error.
- **errors** (array[object] | null)
  A list containing the detail of the errors that occurred in this error scenario.

### 500
Internal Server Error

#### Body: application/json (object)
- **statusCode** (integer(int32))
  The HTTP status code that represents a specific error scenario.
- **type** (string | null)
  The type of error that occurred.
- **description** (string | null)
  Describes the error scenario that occurred.
- **correlationId** (string | null)
  The correlationId of the request that originated the error.
- **errors** (array[object] | null)
  A list containing the detail of the errors that occurred in this error scenario.


[Powered by Bump.sh](https://bump.sh)