Skip to main content
POST
/
agent
/
subscribe
{
    "agentId": "fff21854-32cb-4082-a219-48ae1a9d5313",
    "privyIdToken": "eyJhbGciOiJFU...",
    "privyAuthToken": "eyJhbGciOiJFU..."
}

{
    "message": "Quorum added to wallet",
    "privyResponse": {
        "id": "bh5nazejf4xt56a43vswzk1j",
        "address": "0x1a715565418b1538E0F51d8B826A4bE5340eAEAC",
        "chain_type": "ethereum",
        "policy_ids": [],
        "additional_signers": [
            {
                "signer_id": "oygnr7h645h17ubpbr1xc4p0",
                "override_policy_ids": []
            }
        ],
        "exported_at": null,
        "created_at": 1751573759530,
        "owner_id": null
    }
}
This endpoint is used to subscribe a user to an agent with a given ID (uuidv4). This endpoint will link this user to the agent in our database and will add the quorum signing policy associated with the agent as an additional signer to the user’s wallet on Privy.

​
Request Parameters

​
agentId
string
required
The unique identifier for the agent (UUID format)
​
privyIdToken
string
Privy ID token for authentication. NOT NEEDED FOR DEV PORTAL AGENTS
​
privyAuthToken
string
Privy authentication token. NOT NEEDED FOR DEV PORTAL AGENTS

​
Response

​
message
string
Status message indicating the quorum was added to the wallet
​
privyResponse
object
Privy wallet response object containing the updated wallet configuration

​
Behavior

  • Links the user to the agent in our internal database
  • Adds the quorum signing policy associated with the agent as an additional signer to the user’s wallet on Privy

​
Authentication

B2B JWT token OR Privy authentication token and headers

​
Headers

When using Privy authentication token, include the following header:
  • x-privy-id-token: Privy ID token
{
    "agentId": "fff21854-32cb-4082-a219-48ae1a9d5313",
    "privyIdToken": "eyJhbGciOiJFU...",
    "privyAuthToken": "eyJhbGciOiJFU..."
}

{
    "message": "Quorum added to wallet",
    "privyResponse": {
        "id": "bh5nazejf4xt56a43vswzk1j",
        "address": "0x1a715565418b1538E0F51d8B826A4bE5340eAEAC",
        "chain_type": "ethereum",
        "policy_ids": [],
        "additional_signers": [
            {
                "signer_id": "oygnr7h645h17ubpbr1xc4p0",
                "override_policy_ids": []
            }
        ],
        "exported_at": null,
        "created_at": 1751573759530,
        "owner_id": null
    }
}