Skip to main content
POST
/
partner
/
v1
/
users
/
resolve
Resolve or create a Machines user
curl --request POST \
  --url https://api.machines.cash/partner/v1/users/resolve \
  --header 'Content-Type: application/json' \
  --header 'X-Partner-Key: <api-key>' \
  --data '
{
  "userId": "user-123"
}
'
{
  "ok": true,
  "data": {
    "userId": "<string>",
    "walletAddress": "<string>",
    "createdAt": "2023-11-07T05:31:56Z"
  },
  "summary": "<string>",
  "errors": [
    {
      "code": "invalid_request",
      "message": "missing required field",
      "field": "<string>"
    }
  ],
  "next": {
    "pollAfterMs": 1,
    "suggestedTool": "<string>",
    "suggestedArgs": {}
  }
}

Authorizations

​
X-Partner-Key
string
header
required

Headers

​
X-Open-Responses
enum<string>

Return Open Responses-compatible output when set (replaces the default response envelope).

Available options:
1,
true
​
X-Open-Responses-Call-Id
string

Tool call id used for function_call_output items when Open Responses mode is enabled.

Minimum string length: 1

Body

application/json
​
userId
string
required

Your unique id for this user.

Required string length: 1 - 120
Example:

"user-123"

​
walletAddress
string
Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x2b0f7f2f7c8e4c3d2d3b3f6a8f9b0c1d2e3f4a5b"

​
walletLabel
string

Optional label for display.

Maximum string length: 120
Example:

"Main Wallet"

Response

User resolved

​
ok
boolean
required
​
data
object
required
​
summary
string
required
​
errors
object[]
required
​
next
object