> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crown-brlv.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Issue External Wallet Challenge

> Returns the text the wallet signs to prove the account controls it, valid for 15 minutes. Sign it with `personal_sign` (EIP-191) and send it back exactly as returned, with the signature, to `POST /v1/accounts/{account-id}/external-wallets`.

`account-id` is the caller's own account or one of its sub-accounts. Requires the `manage-wallets` capability on the account.



## OpenAPI

````yaml POST /api/v1/accounts/{account-id}/external-wallets/{address}/challenge
openapi: 3.1.0
info:
  title: Crown API & Webhooks
  version: 1.0.0
  description: >-
    Open API 3 docs for Crown API


    Webhook events that Crown will POST to your configured endpoint URL. All
    webhooks expect a 200 OK response. Payloads use kebab-case for all keys to
    match the Crown API conventions.
servers:
  - url: https://app.crown-brlv.com
    description: Production server
security: []
paths:
  /api/v1/accounts/{account-id}/external-wallets/{address}/challenge:
    post:
      summary: Issue the challenge an external wallet signs
      description: >-
        Returns the text the wallet signs to prove the account controls it,
        valid for 15 minutes. Sign it with `personal_sign` (EIP-191) and send it
        back exactly as returned, with the signature, to `POST
        /v1/accounts/{account-id}/external-wallets`.


        `account-id` is the caller's own account or one of its sub-accounts.
        Requires the `manage-wallets` capability on the account.
      parameters:
        - in: path
          name: account-id
          required: true
          schema:
            type: string
            format: uuid
        - in: path
          name: address
          required: true
          description: The wallet's EVM address, in any letter case
          schema:
            type: string
            example: '0xdDa4775Ed1d0c831B006FD4061Edb1b30693a44c'
      responses:
        '200':
          description: Challenge issued
          content:
            application/json:
              schema:
                type: object
                properties:
                  challenge:
                    type: string
                    description: >-
                      Text for the wallet to sign with `personal_sign`
                      (EIP-191), exactly as returned
                    example: >-
                      Crown: whitelist wallet
                      0xdda4775ed1d0c831b006fd4061edb1b30693a44c for account
                      019712cf-c86d-703f-85b8-bdaa4fc8d254. Expires at
                      2024-01-15T10:45:00Z.
                  expires-at:
                    type: string
                    example: '2024-01-15T10:45:00Z'
                    format: date-time
                    description: >-
                      ISO 8601 timestamp when the challenge expires, 15 minutes
                      after it was issued
                additionalProperties: false
                required:
                  - challenge
                  - expires-at
        '400':
          description: Bad request - Invalid input parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                      message:
                        type: string
                      code:
                        type: string
                    additionalProperties: false
                    required:
                      - type
                      - message
                      - code
                    description: Bad request error details
                additionalProperties: false
                required:
                  - error
        '403':
          description: Forbidden - Access denied
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                      message:
                        type: string
                      code:
                        type: string
                    additionalProperties: false
                    required:
                      - type
                      - message
                      - code
                    description: Forbidden access error details
                additionalProperties: false
                required:
                  - error
        '404':
          description: Not found - Resource does not exist
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                      message:
                        type: string
                      code:
                        type: string
                    additionalProperties: false
                    required:
                      - type
                      - message
                      - code
                    description: Resource not found error details
                additionalProperties: false
                required:
                  - error
        '422':
          description: Unprocessable entity - Validation failed
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                      message:
                        type: string
                      code:
                        type: string
                    additionalProperties: false
                    required:
                      - type
                      - message
                      - code
                    description: Validation error details
                additionalProperties: false
                required:
                  - error

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.