Account Endpoints

Propose an agent ownership relationship

Changed on Nov 3, 2026

Both accounts must agree. Proposing a relationship that is already awaiting you confirms it, so a client that cannot tell who moved first can simply propose.

post/api/v2/accounts/agent-relationships

Request

Base URL
https://api.opensea.io
Auth
API key in header x-api-key and OpenID Connect (https://auth.opensea.io/.well-known/openid-configuration, scopes: write:wallets)
TypeScript
https://skmtc.dev/opensea/apis/opensea-api/docs/api/v2/accounts/agent-relationships/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

caller_role'AGENT' | 'OWNER' required

Which side of the relationship the caller is on

counterparty_addressstring required

Response

createdboolean required

Changes

Nov 3, 20262c7935d84f90 Revision changes
- info
  endpoint added

Operation history

Propose an agent ownership relationship

Request

Request body

Response 200OK

Changes

Response