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

# Profile Name

> Set a name and avatar for a profile, scoped to each partner. Your domain suffix (e.g. `.clicker.xyz`) is appended to the name in responses.

Approved partners can have names promoted as the global username when the profile has no social identity (Twitter, Farcaster, ENS, etc.). Contact us to enable this.



## OpenAPI

````yaml PUT /v1/profiles/{identifier}/name
openapi: 3.0.0
info:
  version: 1.0.0
  title: Daylight.xyz API
  description: >-
    Welcome to the Daylight API! API endpoints require a Daylight partner API
    key passed in the HTTP Authorization header.
servers:
  - url: https://api.clicker.xyz
security:
  - {}
  - bearerAuth: []
paths:
  /v1/profiles/{identifier}/name:
    put:
      tags:
        - Social - Feed, Profiles and Discovery
      summary: Provide a name and avatar for this profile.
      description: >-
        Set a name and avatar for a profile, scoped to each partner. Your domain
        suffix (e.g. `.clicker.xyz`) is appended to the name in responses.


        Approved partners can have names promoted as the global username when
        the profile has no social identity (Twitter, Farcaster, ENS, etc.).
        Contact us to enable this.
      parameters:
        - schema:
            type: string
            description: Profile UUID or wallet address
          required: true
          description: Profile UUID or wallet address
          name: identifier
          in: path
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                avatarUrl:
                  type: string
                  nullable: true
                  description: >-
                    URL to a jpeg or png image. Center-cropped to square, at
                    least 120x120, ideally at most 800x800 pixels. Max 5MB.
                    Requires a name to be set. Pass null to remove the avatar,
                    or omit to leave unchanged.
                name:
                  type: string
                  nullable: true
                  minLength: 3
                  maxLength: 18
                  pattern: ^[a-zA-Z0-9_]+$
                  description: >-
                    3-18 characters, letters/numbers/underscores only. Do not
                    include the domain suffix. Pass null to remove the name and
                    avatar entirely, or omit to leave unchanged.
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProfileResponseV1'
        '400':
          description: >-
            The request payload or query string parameter you passed was not
            valid
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '404':
          description: The item you requested could not be found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
components:
  schemas:
    ProfileResponseV1:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        images:
          type: object
          properties:
            raw:
              type: string
              nullable: true
              description: The full-sized image
            xs:
              type: string
              nullable: true
              description: 75x75
            sm:
              type: string
              nullable: true
              description: 300x300
          required:
            - raw
            - xs
            - sm
          description: URLs for different size squares.
        addresses:
          type: array
          items:
            type: string
        externalId:
          type: string
        metadata:
          type: object
          properties:
            farcasterUsername:
              type: string
              nullable: true
            farcasterId:
              type: number
              nullable: true
            lensHandle:
              type: string
              nullable: true
            ensName:
              type: string
              nullable: true
            twitterHandle:
              type: string
              nullable: true
            debankName:
              type: string
              nullable: true
            hlName:
              type: string
              nullable: true
            commentCount30d:
              type: number
              nullable: true
            pnl30d:
              type: number
              nullable: true
            winRate30d:
              type: number
              nullable: true
            tradeCount30d:
              type: number
              nullable: true
            roiPercent30d:
              type: number
              nullable: true
            pnl7d:
              type: number
              nullable: true
            winRate7d:
              type: number
              nullable: true
            tradeCount7d:
              type: number
              nullable: true
            roiPercent7d:
              type: number
              nullable: true
            medianHoldingTimeMinutes:
              type: number
              nullable: true
          required:
            - farcasterUsername
            - farcasterId
            - lensHandle
            - ensName
            - twitterHandle
            - debankName
            - hlName
            - commentCount30d
            - pnl30d
            - winRate30d
            - tradeCount30d
            - roiPercent30d
            - pnl7d
            - winRate7d
            - tradeCount7d
            - roiPercent7d
            - medianHoldingTimeMinutes
        isNSFW:
          anyOf:
            - type: boolean
              enum:
                - false
            - type: object
              properties:
                nsfwImage:
                  type: boolean
                nsfwText:
                  type: boolean
              required:
                - nsfwImage
                - nsfwText
          description: >-
            `false` when the profile is clean. Otherwise an object with
            `nsfwImage` and `nsfwText` booleans indicating which axes the
            scanner flagged. Clients decide whether to render, censor, or hide
            the underlying content.
      required:
        - id
        - name
        - images
        - addresses
        - metadata
        - isNSFW
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````