---
updatedAt: 2026-08-20T23:34:02.000Z
agentTools:
  projectIndex: https://docs.opensea.io/llms.txt
---

# Confirm an agent relationship proposed to the authenticated account

Name the other party by `counterparty_account_id`, from `agent_account_id` or `owner_account_id` on a listed relationship, or by `counterparty_address`. Prefer the account: the relationship is the pair of accounts, so it stays addressable after either party unlinks the wallet it was proposed with, whereas an address stops resolving once unlinked.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "OpenSea API",
    "description": "The API for OpenSea",
    "contact": {
      "name": "OpenSea",
      "url": "https://www.opensea.io",
      "email": "contact@opensea.io"
    },
    "version": "2.0.0"
  },
  "servers": [
    {
      "url": "https://api.opensea.io",
      "description": "OpenSea API server"
    }
  ],
  "security": [
    {
      "ApiKeyAuth": []
    }
  ],
  "tags": [
    {
      "name": "Account Endpoints",
      "description": "Account endpoints to retrieve OpenSea account profiles and resolve identifiers"
    }
  ],
  "paths": {
    "/api/v2/accounts/agent-relationships/confirm": {
      "post": {
        "tags": [
          "Account Endpoints"
        ],
        "summary": "Confirm an agent relationship proposed to the authenticated account",
        "description": "Name the other party by `counterparty_account_id`, from `agent_account_id` or `owner_account_id` on a listed relationship, or by `counterparty_address`. Prefer the account: the relationship is the pair of accounts, so it stays addressable after either party unlinks the wallet it was proposed with, whereas an address stops resolving once unlinked.",
        "operationId": "confirm_agent_relationship",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ConfirmAgentRelationshipRequestBody"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AgentRelationshipMutationResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/V1ErrorWrapper"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/V1ErrorWrapper"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/V1ErrorWrapper"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/V1ErrorWrapper"
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/V1ErrorWrapper"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/V1ErrorWrapper"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": [],
            "WalletAuth": [
              "write:wallets"
            ]
          }
        ],
        "x-opensea-auth-required": true,
        "x-opensea-auth-scopes": [
          "write:wallets"
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "V1ErrorWrapper": {
        "type": "object",
        "properties": {
          "errors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "errors"
        ]
      },
      "AgentRelationshipMutationResponse": {
        "type": "object",
        "properties": {
          "created": {
            "type": "boolean"
          },
          "relation": {
            "$ref": "#/components/schemas/AgentRelationshipResponse"
          }
        },
        "required": [
          "created",
          "relation"
        ]
      },
      "AgentRelationshipResponse": {
        "type": "object",
        "properties": {
          "agent_account_id": {
            "type": "string"
          },
          "awaiting_confirmation_from": {
            "type": [
              "string",
              "null"
            ]
          },
          "confirmed_at": {
            "type": [
              "number",
              "null"
            ],
            "format": "double",
            "description": "Unix timestamp in seconds, including fractional seconds"
          },
          "created_at": {
            "type": "number",
            "format": "double",
            "description": "Unix timestamp in seconds, including fractional seconds"
          },
          "owner_account_id": {
            "type": "string"
          },
          "status": {
            "type": "string"
          }
        },
        "required": [
          "agent_account_id",
          "created_at",
          "owner_account_id",
          "status"
        ]
      },
      "ConfirmAgentRelationshipRequestBody": {
        "type": "object",
        "properties": {
          "caller_role": {
            "type": "string",
            "description": "Which side of the relationship the caller is on",
            "enum": [
              "AGENT",
              "OWNER"
            ]
          },
          "counterparty_account_id": {
            "type": "string",
            "description": "The other party's account id. Preferred over an address."
          },
          "counterparty_address": {
            "type": "string",
            "description": "A wallet the other party has linked publicly, resolved to their account. Stops resolving once unlinked."
          }
        },
        "required": [
          "caller_role"
        ]
      }
    },
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "description": "API key required for authentication",
        "name": "x-api-key",
        "in": "header"
      },
      "WalletAuth": {
        "type": "openIdConnect",
        "description": "OpenSea wallet authorization. Run `opensea login` or use the OAuth 2.1 authorization-code flow with PKCE, then send the access token as `Authorization: Bearer <token>`.",
        "openIdConnectUrl": "https://auth.opensea.io/.well-known/openid-configuration"
      }
    }
  },
  "x-tagGroups": [
    {
      "name": "Data & Discovery",
      "tags": [
        "Chain Endpoints",
        "Account Endpoints",
        "Collection Endpoints",
        "NFT Endpoints",
        "Contract Endpoints",
        "Token Endpoints",
        "Search Endpoints"
      ]
    },
    {
      "name": "Marketplace & Trading",
      "tags": [
        "Listing Endpoints",
        "Offer Endpoints",
        "Order Endpoints",
        "Swap Endpoints",
        "Drops Endpoints"
      ]
    },
    {
      "name": "Analytics & Events",
      "tags": [
        "Analytics Endpoints"
      ]
    },
    {
      "name": "Tools [Beta]",
      "tags": [
        "Tool Endpoints [Beta]"
      ]
    },
    {
      "name": "Transactions",
      "tags": [
        "Transaction Endpoints"
      ]
    },
    {
      "name": "Authentication",
      "tags": [
        "Auth Endpoints"
      ]
    }
  ]
}
```