openapi: 3.2.0
info:
  title: Livelike Leaderboard By Custom Id API
  version: '1'
  description: 'Operations tagged Leaderboard By Custom Id across 2 of this provider''s published API definitions: livelike-engagement-suite-openapi.yml, livelike-leaderboards-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://cf-blast.livelikecdn.com/api/v1
- url: https://cf-blast.livelikecdn.com/api/v1/leaderboards
security:
- {}
tags:
- name: Leaderboard By Custom Id
paths:
  /leaderboard-by-custom-id/{client-id}/{custom-id}/:
    get:
      summary: Get Leaderboard Details by Custom Id
      description: Getting leaderboard details by custom-id can be achieved by using the request below. Leaderboard details can be useful if you would like to know the name of the leaderboard or the type of reward a user can earn.
      operationId: get-leaderboard-by-custom-id
      parameters:
      - name: custom-id
        in: path
        description: Unique custom id mapped in your system
        schema:
          type: string
        required: true
      - name: client-id
        in: path
        description: Application Client Id
        schema:
          type: string
        required: true
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n    \"id\": \"{leaderboard_id}\",\n\t\t\"custom_id\": \"custom_id1\",\n    \"url\": \"https://cf-blast.livelikecdn.com/api/v1/leaderboards/{leaderboard_id}/\",\n    \"client_id\": \"{client_id}\",\n    \"name\": \"LiveLike Points Leaders\",\n    \"reward_item\": {\n        \"id\": \"5e1016ef-9cf8-450f-9ad6-5e3996f1cbb0\",\n        \"url\": \"https://cf-blast.livelikecdn.com/api/v1/reward-items/5e1016ef-9cf8-450f-9ad6-5e3996f1cbb0/\",\n        \"client_id\": \"client_id\",\n        \"name\": \"LiveLike Points\"\n    },\n    \"attributes\":[]\n    \"reward_item_id\": \"5e1016ef-9cf8-450f-9ad6-5e3996f1cbb0\",\n    \"is_locked\": false,\n    \"entries_url\": \"https://blastrt-prod-us-east-1.livelikecdn.com/services/leaderboards/{leaderboard_id}/entries\",\n    \"entry_detail_url_template\": \"https://blastrt-prod-us-east-1.livelikecdn.com/services/leaderboards/{leaderboard_id}/entries/{profile_id}\"\n}"
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                type: object
                properties: {}
      deprecated: false
      security: []
      tags:
      - Leaderboard By Custom Id
    servers:
    - url: https://cf-blast.livelikecdn.com/api/v1
  /leaderboard-by-custom-id/{custom-id}/:
    patch:
      summary: Update a Leaderboard by custom-id
      description: ''
      operationId: update-a-leaderboard-copy
      parameters:
      - name: custom-id
        in: path
        description: Unique Custom Id mapped in your system
        schema:
          type: string
        required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: The descriptive name of the leaderboard
                is_locked:
                  type: boolean
                  description: Whether or not scores will update in the leaderboard
                attributes:
                  type: array
                  items:
                    properties:
                      key:
                        type: string
                      value:
                        type: string
                    required:
                    - key
                    - value
                    type: object
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n    \"id\": \"{leaderboard_id}\",\n    \"custom_id\": \"custom-id1\",\n    \"url\": \"https://cf-blast.livelikecdn.com/api/v1/leaderboards/{leaderboard_id}/\",\n    \"client_id\": \"{client_id}\",\n    \"name\": \"LiveLike Points Leaders\",\n    \"reward_item\": {\n        \"id\": \"5e1016ef-9cf8-450f-9ad6-5e3996f1cbb0\",\n        \"url\": \"https://cf-blast.livelikecdn.com/api/v1/reward-items/5e1016ef-9cf8-450f-9ad6-5e3996f1cbb0/\",\n        \"client_id\": \"client_id\",\n        \"name\": \"LiveLike Points\"\n    },\n    \"attributes\":[\n      {\n        \"key\": \"key1\",\n        \"value\": \"value1\"\n      }\n    ]\n    \"reward_item_id\": \"5e1016ef-9cf8-450f-9ad6-5e3996f1cbb0\",\n    \"is_locked\": false,\n    \"entries_url\": \"https://blastrt-prod-us-east-1.livelikecdn.com/services/leaderboards/{leaderboard_id}/entries\",\n    \"entry_detail_url_template\": \"https://blastrt-prod-us-east-1.livelikecdn.com/services/leaderboards/{leaderboard_id}/entries/{profile_id}\"\n}"
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                type: object
                properties: {}
      deprecated: false
      security: []
      tags:
      - Leaderboard By Custom Id
    servers:
    - url: https://cf-blast.livelikecdn.com/api/v1/leaderboards
x-refined-from:
- livelike-engagement-suite-openapi.yml
- livelike-leaderboards-openapi.yml
x-readme-fauxas: true
x-provenance:
  method: searched
  source: https://docs.livelike.com/reference
  harvested: '2026-10-14'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://docs.livelike.com/reference/create-an-application.md
  - https://docs.livelike.com/reference/create-multiplier-1.md
  - https://docs.livelike.com/reference/create-multiplier.md
  - https://docs.livelike.com/reference/delete-an-application.md
  - https://docs.livelike.com/reference/delete-comment-quality-rules.md
  - https://docs.livelike.com/reference/list-reward-multipliers.md
  - https://docs.livelike.com/reference/listing-applications-widgets.md
  - https://docs.livelike.com/reference/retrieve-reward-multiplier-1-1-1-1.md
  - https://docs.livelike.com/reference/retrieve-reward-multiplier-1-1-1.md
  - https://docs.livelike.com/reference/retrieve-reward-multiplier-1-1.md
  - https://docs.livelike.com/reference/retrieve-reward-multiplier-1.md
  - https://docs.livelike.com/reference/retrieve-reward-multiplier.md
  - https://docs.livelike.com/reference/update-an-application.md
  merge:
    pages: 13
    deduped: 12
    conflicts_kept_first: 0