v1

latestOpenAPI 3.0.02026-07-267331140.7 KB
Safe Management

Add Safe Owner

Adds a new owner to the user's Safe account.

The signature should be generated by signing the transaction data obtained from the /api/v1/owners/add/transaction-data endpoint.

The operation is processed through a delay relay mechanism that executes after 3 minutes.

post/api/v1/owners

Request body

newOwnerstring required

The address to add as a new Safe owner.

signaturestring required

The wallet signature authorizing this operation.

smartWalletAddressstring

Optional. If using a smart account, the address of the smart wallet to use for the operation.

Example request

{
  "newOwner": "0x3270bf32AB647e90eF94A026c70Aa1daaaDA2382",
  "signature": "0x1234567890abcdef...",
  "message": {
    "salt": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "data": "0xa9059cbb0000000000000000000000003270bf32ab647e90ef94a026c70aa1daaaada2382"
  },
  "smartWalletAddress": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
}

Response

Successfully submitted the add owner request.

Example response

{
  "data": {
    "id": "clp3j1f9a0000a1cdh6ezx2qv",
    "safeAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "transactionData": "0xabcdef",
    "enqueueTaskId": "task_abc123",
    "dispatchTaskId": "task_def456",
    "readyAt": "2025-02-07T12:34:56Z",
    "operationType": "CALL",
    "userId": "user_123",
    "status": "QUEUING",
    "createdAt": "2025-02-07T12:34:56Z"
  }
}