---
title: "Propose an agent ownership relationship"
method: POST
path: "/api/v2/accounts/agent-relationships"
tags: ["Account Endpoints"]
---

# Propose an agent ownership relationship

`POST /api/v2/accounts/agent-relationships`

## Request

- Base URL: `https://api.opensea.io`
- URL: `https://api.opensea.io/api/v2/accounts/agent-relationships`
- 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)

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.

## Request body

- ProposeAgentRelationshipRequestBody
  - `caller_role` 'AGENT' | 'OWNER', required: Which side of the relationship the caller is on
  - `counterparty_address` string, required

## Response `200`

OK

- AgentRelationshipMutationResponse
  - `created` boolean, required
  - `relation` AgentRelationshipResponse, required
    - `agent_account_id` string, required
    - `awaiting_confirmation_from` string, nullable
    - `confirmed_at` number, double, nullable: Unix timestamp in seconds, including fractional seconds
    - `created_at` number, double, required: Unix timestamp in seconds, including fractional seconds
    - `owner_account_id` string, required
    - `status` string, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `500`: Internal Server Error

## Changes

- **2026-11-03** `2c7935d84f90`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/opensea/apis/opensea-api/changes/api/v2/accounts/agent-relationships/post.md)

---

[API](https://skmtc.dev/opensea/apis/opensea-api.md) - [All operations](https://skmtc.dev/opensea/apis/opensea-api/llms.txt) - [OpenAPI document](https://skmtc.dev/opensea/apis/opensea-api/revisions/2c7935d84f90?raw)