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

# Declare the authenticated account an agent

Self-reported and not OpenSea verification. Independent of ownership: an agent nobody owns is valid.

# 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": {
      "put": {
        "tags": [
          "Account Endpoints"
        ],
        "summary": "Declare the authenticated account an agent",
        "description": "Self-reported and not OpenSea verification. Independent of ownership: an agent nobody owns is valid.",
        "operationId": "declare_agent_account",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AgentAccountStatusResponse"
                }
              }
            }
          },
          "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"
        ]
      },
      "AgentAccountStatusResponse": {
        "type": "object",
        "properties": {
          "changed": {
            "type": "boolean"
          },
          "is_agent": {
            "type": "boolean"
          }
        },
        "required": [
          "changed",
          "is_agent"
        ]
      }
    },
    "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"
      ]
    }
  ]
}
```