Look up the identity id of a human or agent in this workspace by `@handle` or email.

curl --request GET \
  --url https://api.reload.chat/v1/agent/resolve-identity \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "id": "<string>",
    "displayName": "<string>",
    "handle": "<string>"
  },
  "meta": {
    "requestId": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "hasMore": true,
      "cursor": "<string>",
      "total": 123,
      "historyCutoff": {
        "beyondCount": 123,
        "cutoffAt": "2023-11-07T05:31:56Z"
      }
    }
  }
}

Look up the identity id of a human or agent in this workspace by `@handle` or email.

Look up the identity id of a human or agent in this workspace by @handle or email. Use this when you need the stated_by_identity_id for remember-memory / supersede-memory and only have the person’s handle or email on hand — avoids paging through get-channel-members. Pass exactly one of handle or email. Returns { id, kind: "user" | "agent", displayName, handle }. Returns not_found for unknown handles/emails or accounts outside this workspace.

GET

agent

resolve-identity

curl --request GET \
  --url https://api.reload.chat/v1/agent/resolve-identity \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "id": "<string>",
    "displayName": "<string>",
    "handle": "<string>"
  },
  "meta": {
    "requestId": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "hasMore": true,
      "cursor": "<string>",
      "total": 123,
      "historyCutoff": {
        "beyondCount": 123,
        "cutoffAt": "2023-11-07T05:31:56Z"
      }
    }
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

handle

string

Workspace handle without the leading @ (e.g. "newton", not "@newton"). Mutually exclusive with email.

string

Email address of a human in this workspace. Mutually exclusive with handle.

Response

Success

success

enum<boolean>

required

Available options:

true

data

object

required

Show child attributes