Update Registered User

PATCH

https://ah-api.merge.dev/api/v1/registered-users/:registered_user_id/

PATCH

/api/v1/registered-users/:registered_user_id/

curl -X PATCH https://ah-api.merge.dev/api/v1/registered-users/134e0111-0f67-44f6-98f0-597000290bb3/ \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "origin_user_name": "Alice Chen",
  "shared_credential_group": {
    "origin_company_id": "company-abc",
    "origin_company_name": "Acme Corp Updated",
    "custom_groupings": {
      "department": "sales"
    }
  },
  "user_type": "HUMAN"
}'

200Update User Request

{
  "id": "string",
  "origin_user_id": "string",
  "origin_user_name": "string",
  "shared_credential_group": {
    "origin_company_id": "string",
    "origin_company_name": "string",
    "custom_groupings": {}
  },
  "user_type": "string",
  "authenticated_connectors": [
    "string"
  ],
  "is_test": true
}

Updates fields on a Registered User by ID

Authentication

AuthorizationBearer

Token-based authentication with required prefix “Bearer”

Path parameters

registered_user_idstringRequiredformat: "uuid"

Agent Handler ID of the Registered User

Request

This endpoint expects an object.

origin_user_idstringOptional

Unique identifier for Registered User

origin_user_namestringOptional

The human readable name of Registered User

shared_credential_groupobjectOptional

Object used to identify which the groupings a Registered User is part of and can share credentials across.

user_typeenumOptionalDefaults to HUMAN

ENUM of HUMAN or SYSTEM

Response

idstringRead-only

origin_user_idstringRead-only

Unique identifier for Registered User

origin_user_namestring

The human readable name of Registered User

shared_credential_groupobject or null

Object used to identify which the groupings a Registered User is part of and can share credentials across.

user_typestring

ENUM of HUMAN or SYSTEM

authenticated_connectorslist of stringsRead-only

List of connector slugs that the user has authenticated with

is_testboolean

Whether this is a test user or production user