On this page

    1. Home
    2. API
    3. API Reference
    4. Network
    5. Network Ranking Visibility

    Network Ranking Visibility

    By default, networks may be listed on the public leaderboard if they are among the top earners. This endpoint allows you to opt-in or opt-out of this public display.


    POST /network/ranking-visibility

    Update the visibility status of your network on the global leaderboard.

    Request

    POST /network/ranking-visibility

    Headers:

    {
      "Host": "api.bringyour.com",
      "Content-Type": "application/json",
      "Authorization": "Bearer YOUR_JWT_TOKEN"
    }

    Body:

    {
      "is_public": true
    }

    Fields

    FieldTypeDescription
    is_publicbooleanSet to true to show your network on the leaderboard, or false to hide it.

    Response

    200 Success

    Status: 200 OK

    Content-Type: application/json

    {
      "error": {
        "message": "string"
      }
    }

    Fields

    FieldTypeDescription
    errorobjectReturned if the update failed (can be null).
    error.messagestringDetails on why the visibility update could not be processed.

    Example

    HTTP Request

    POST /network/ranking-visibility HTTP/1.1
    Host: api.bringyour.com
    Content-Type: application/json
    Authorization: Bearer YOUR_JWT_TOKEN
     
    {
      "is_public": false
    }

    Successful HTTP Response

    {
      "error": null
    }


    Powered by Sudoc v2.5.0
    Hide table of contents