Update Organization Trust Using PATCH

Update Organization Trust Using PATCH

Update organization trust.

Access Policy

Role User Accounts Service Accounts (Client Credentials Applications)
Organization Owner ✔️ ✔️
Request
URI
PATCH
https://{api_host}/csp/gateway/am/api/orgs/{orgId}/trusts/{trustId}
COPY
Path Parameters
string
orgId
Required

Unique identifier (GUID) of the organization.

string
trustId
Required

Unique identifier ot the uni-directional trust.


Request Body
OrganizationTrustUpdateRequest of type(s) application/json
Required
"OrganizationTrustUpdateRequest Object"
integer As int64 As int64
expiresAt
Optional

The timestamp the trust expires at (measured in number of milliseconds since 1/1/1970 UTC).

object
allowedScopes
Optional

Defines the properties of the allowed scopes for organization trust.

string
description
Optional
Constraints: minLength: 0 maxLength: 200

The description about the trust.

string
status
Optional

The status of the organization trust. Update of the status is currently restricted.

Possible values are : ACTIVE, DEACTIVATED, EXPIRED, EXPIRATION_PROCESSING, EXPIRATION_PROCESSING_FAILED, ORG_DEACTIVATED, REJECTED, PENDING,
Authentication
This operation uses the following authentication methods.
Responses
200

OK

Returns OrganizationTrustDto of type(s) application/json
{
    "status": "string",
    "expiresAt": 0,
    "trustId": "string",
    "trusteeOrg": {
        "id": "string",
        "displayName": "string"
    },
    "createdBy": "string",
    "trustedOrg": {
        "id": "string",
        "displayName": "string"
    },
    "createdAt": 0,
    "lastUpdatedAt": 0,
    "description": "string",
    "allowedScopes": {
        "organizationScopes": {
            "roles": [
                {
                    "name": "string",
                    "resources": [
                        "string"
                    ]
                }
            ],
            "allRoles": false
        },
        "servicesScopes": [
            {
                "serviceDefinitionId": "string",
                "roles": [
                    {
                        "name": "string",
                        "resources": [
                            "string"
                        ]
                    }
                ],
                "allRoles": false
            }
        ],
        "allScopes": false
    },
    "type": "string",
    "lastUpdatedBy": "string"
}
string
status
Optional

The status of the organization trust.

Possible values are : ACTIVE, DEACTIVATED, EXPIRED, EXPIRATION_PROCESSING, EXPIRATION_PROCESSING_FAILED, ORG_DEACTIVATED, REJECTED, PENDING,
integer As int64 As int64
expiresAt
Optional

The timestamp the trust expires at (measured in number of milliseconds since 1/1/1970 UTC).

string
trustId
Optional

Unique identifier (GUID) of the trust.

object
trusteeOrg
Optional

Unique identifier (GUID) of the trusted organization that is the beneficiary of the trust. Typically the management org.

string
createdBy
Optional

The username (email) of the user who created the organization trust.

object
trustedOrg
Optional

Unique identifier (GUID) of the trusted organization that is the beneficiary of the trust. Typically the management org.

integer As int64 As int64
createdAt
Optional

Timestamp, measured in number of milliseconds since 1/1/1970 UTC, indicating when the organization trust was created.

integer As int64 As int64
lastUpdatedAt
Optional

Timestamp, measured in number of milliseconds since 1/1/1970 UTC, indicating when the organization trust was last updated.

string
description
Optional

The description about the trust.

object
allowedScopes
Optional

Defines the properties of the allowed scopes for organization trust.

string
type
Optional

The type of the organization trust.

Possible values are : HIERARCHY, CUSTOM, PARTNER,
string
lastUpdatedBy
Optional

The username (email) of the user who last updated the organization trust.


400

Cannot update non-active organization trust.

Returns CspErrorResponse of type(s) application/json
"CspErrorResponse Object"
string
cspErrorCode
Optional

cspErrorCode

string
message
Optional

message

string
errorCode
Optional

errorCode

string
requestId
Optional

requestId

integer As int32 As int32
moduleCode
Optional

moduleCode

integer As int32 As int32
statusCode
Optional

statusCode


401

The user is not authorized to use the API

Returns CspErrorResponse of type(s) application/json
"CspErrorResponse Object"
string
cspErrorCode
Optional

cspErrorCode

string
message
Optional

message

string
errorCode
Optional

errorCode

string
requestId
Optional

requestId

integer As int32 As int32
moduleCode
Optional

moduleCode

integer As int32 As int32
statusCode
Optional

statusCode


403

The user is forbidden to use the API

Returns CspErrorResponse of type(s) application/json
"CspErrorResponse Object"
string
cspErrorCode
Optional

cspErrorCode

string
message
Optional

message

string
errorCode
Optional

errorCode

string
requestId
Optional

requestId

integer As int32 As int32
moduleCode
Optional

moduleCode

integer As int32 As int32
statusCode
Optional

statusCode


404

Organization trust with this identifier is not found.

Returns CspErrorResponse of type(s) application/json
"CspErrorResponse Object"
string
cspErrorCode
Optional

cspErrorCode

string
message
Optional

message

string
errorCode
Optional

errorCode

string
requestId
Optional

requestId

integer As int32 As int32
moduleCode
Optional

moduleCode

integer As int32 As int32
statusCode
Optional

statusCode


409

The request could not be processed due to a conflict

Returns CspErrorResponse of type(s) application/json
"CspErrorResponse Object"
string
cspErrorCode
Optional

cspErrorCode

string
message
Optional

message

string
errorCode
Optional

errorCode

string
requestId
Optional

requestId

integer As int32 As int32
moduleCode
Optional

moduleCode

integer As int32 As int32
statusCode
Optional

statusCode


429

The user has sent too many requests

Returns CspErrorResponse of type(s) application/json
"CspErrorResponse Object"
string
cspErrorCode
Optional

cspErrorCode

string
message
Optional

message

string
errorCode
Optional

errorCode

string
requestId
Optional

requestId

integer As int32 As int32
moduleCode
Optional

moduleCode

integer As int32 As int32
statusCode
Optional

statusCode


500

An unexpected error has occurred while processing the request

Returns CspErrorResponse of type(s) application/json
"CspErrorResponse Object"
string
cspErrorCode
Optional

cspErrorCode

string
message
Optional

message

string
errorCode
Optional

errorCode

string
requestId
Optional

requestId

integer As int32 As int32
moduleCode
Optional

moduleCode

integer As int32 As int32
statusCode
Optional

statusCode


Code Samples
COPY
                    curl -X PATCH -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]'