Skip to main content
GET
/
api
/
v1
/
registered-users
/
{id}
Get Registered User
curl --request GET \
  --url https://ah-api.merge.dev/api/v1/registered-users/{id} \
  --header 'Authorization: <api-key>'
{
  "id": "91b2b905-e866-40c8-8be2-efe53827a0aa",
  "origin_user_id": "user1234",
  "origin_user_name": "Yash",
  "shared_credential_group": {
    "origin_company_id": "merge-1234",
    "origin_company_name": "Merge",
    "custom_groupings": {}
  },
  "user_type": "HUMAN",
  "authenticated_connectors": [
    "linear",
    "jira",
    "slack"
  ]
}

Authorizations

​
Authorization
string
header
required

Production Access Key (Bearer)

Path Parameters

​
id
string<uuid>
required

Agent Handler ID of the Registered User

Response

200 - application/json
​
id
string
required
Example:

"91b2b905-e866-40c8-8be2-efe53827a0aa"

​
origin_user_id
string
required

Unique identifier for Registered User

Example:

"user1234"

​
origin_user_name
string
required

The human readable name of Registered User

Example:

"Yash"

​
shared_credential_group
object
required

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

​
user_type
string
required

ENUM of HUMAN or SYSTEM

Example:

"HUMAN"

​
authenticated_connectors
string[]
required

List of connector slugs that the user has authenticated with

Example:
["linear", "jira", "slack"]