Refresh OEM user secret

PUT

/v1/organizations/:organizationId/oem/users/:userId/secret

Refresh OEM user secret

When the OEM platform feature is enabled, generates a new provider OEM secret for the target organization user and persists it. Only organization owners may call this endpoint. Returns the updated collaborator.

Request

Add parameter in header authorization

Example: Authorization: Bearer <token>

organizationId string

required

Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$

userId string

required

Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$

Responses

200 Response application/json

status boolean required

data object required

collaborator object required

id string required

Match pattern: ^[a-fA-F0-9]{24}$

organization string required

Match pattern: ^[a-fA-F0-9]{24}$

role string required

owner admin editor viewer unassigned

tags array required

user object optional

id string required

Match pattern: ^[a-fA-F0-9]{24}$

email string required

≤ 256 characters · Match pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ · Format: email

firstName string required

≤ 128 characters

lastName string required

≤ 128 characters

picture string optional

role string required

admin adminViewer user serviceAccount platformUser platformServiceAccount

ssoUser any required

detected object required

createdBy string required

Match pattern: ^[a-fA-F0-9]{24}$

updatedAt string required

createdAt string required

oemSecret string required

{
    "status": true,
    "data": {
        "collaborator": {
            "id": "string",
            "organization": "string",
            "role": "owner",
            "tags": [
                "string"
            ],
            "user": {
                "id": "string",
                "email": "[email protected]",
                "firstName": "string",
                "lastName": "string",
                "picture": "string",
                "role": "admin",
                "ssoUser": true
            },
            "detected": {},
            "createdBy": "string",
            "updatedAt": "string",
            "createdAt": "string"
        },
        "oemSecret": "string"
    }
}

400 Response application/json

status boolean optional

false

error object optional

code number optional

5186

message string optional

Error parsing objectId

{
    "status": false,
    "error": {
        "code": 5187,
        "message": "Feature block by platform configuration"
    }
}

401 Response application/json

status boolean optional

false

error object optional

code number optional

4001

message string optional

Unauthorized

{
    "status": false,
    "error": {
        "code": 4002,
        "message": "No auth token"
    }
}

404 Response application/json

status boolean optional

false

error object optional

code number optional

3001

message string optional

Entity not found

{
    "status": false,
    "error": {
        "code": 3001,
        "message": "Entity not found"
    }
}