Optimizely Badges API
The Badges API from Optimizely — 7 operation(s) for badges.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/optimizely-badges-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
OpenAPI Specification
openapi: 3.2.0
info:
version: admin-v1
title: Admin API V1 Badges API
servers:
- url: https://dogfood.commerce.insitesandbox.com
security: []
tags:
- name: Badges
paths:
/api/v1/admin/Badges:
get:
tags:
- Badges
summary: Returns the EntitySet Badges
operationId: Badges_Get
parameters:
- name: $expand
in: query
description: Expands related entities inline.
required: false
schema:
type: string
- name: $filter
in: query
description: Filters the results, based on a Boolean condition.
required: false
schema:
type: string
- name: $select
in: query
description: Selects which properties to include in the response.
required: false
schema:
type: string
- name: $apply
in: query
description: Aggregates the results according to one or more transformations.
required: false
schema:
type: string
- name: $orderby
in: query
description: Sorts the results.
required: false
schema:
type: string
- name: $top
in: query
description: Returns only the first n results.
required: false
schema:
type: integer
format: int32
- name: $skip
in: query
description: Skips the first n results.
required: false
schema:
type: integer
format: int32
- name: $count
in: query
description: Includes a count of the matching results in the response.
required: false
schema:
type: boolean
responses:
'200':
description: OK
content:
'*/*':
schema:
type: object
deprecated: false
security:
- access_token: []
post:
tags:
- Badges
summary: Post a new entity to EntitySet Badges
operationId: Badges_Post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Insite.Data.Entities.Badge'
description: The entity to post
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
type: object
deprecated: false
security:
- access_token: []
/api/v1/admin/Badges({id}):
get:
tags:
- Badges
summary: Returns the entity with the key from Badges
operationId: Badges_GetById
parameters:
- name: id
in: path
description: 'key: id'
required: true
schema:
type: string
format: uuid
- name: $expand
in: query
description: Expands related entities inline.
required: false
schema:
type: string
- name: $select
in: query
description: Selects which properties to include in the response.
required: false
schema:
type: string
responses:
'200':
description: OK
content:
'*/*':
schema:
type: object
deprecated: false
security:
- access_token: []
put:
tags:
- Badges
summary: Replace entity in EntitySet Badges
operationId: Badges_PutById
parameters:
- name: id
in: path
description: 'key: id'
required: true
schema:
type: string
format: uuid
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Insite.Data.Entities.Badge'
description: The entity to put
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
type: object
deprecated: false
security:
- access_token: []
delete:
tags:
- Badges
summary: Delete entity in EntitySet Badges
operationId: Badges_DeleteById
parameters:
- name: id
in: path
description: 'key: id'
required: true
schema:
type: string
format: uuid
- name: If-Match
in: header
description: If-Match header
required: false
schema:
type: string
responses:
'200':
description: OK
content:
'*/*':
schema:
type: object
deprecated: false
security:
- access_token: []
patch:
tags:
- Badges
summary: Update entity in EntitySet Badges
operationId: Badges_PatchById
parameters:
- name: id
in: path
description: 'key: id'
required: true
schema:
type: string
format: uuid
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Insite.Data.Entities.Badge'
description: The entity to patch
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
type: object
deprecated: false
security:
- access_token: []
/api/v1/admin/Badges/Default.Default():
get:
tags:
- Badges
summary: Call operation Default
operationId: Badges_Default
responses:
'200':
description: OK
content:
'*/*':
schema:
type: object
deprecated: false
security:
- access_token: []
/api/v1/admin/badges/delete:
delete:
tags:
- Badges
operationId: Badges_DeleteRoute
parameters:
- name: ids
in: query
required: true
explode: true
schema:
type: array
items:
type: string
format: uuid
responses:
'200':
description: OK
content:
'*/*':
schema:
type: object
deprecated: false
security:
- access_token: []
/api/v1/admin/badges({key})/attributevalues({attributevalueKey}):
get:
tags:
- Badges
operationId: Badges_GetAttributeValueByKeyAndAttributevaluekey
parameters:
- name: key
in: path
required: true
schema:
type: string
format: uuid
- name: attributevalueKey
in: path
required: true
schema:
type: string
format: uuid
- name: $expand
in: query
description: Expands related entities inline.
required: false
schema:
type: string
- name: $select
in: query
description: Selects which properties to include in the response.
required: false
schema:
type: string
responses:
'200':
description: OK
content:
'*/*':
schema:
type: object
deprecated: false
security:
- access_token: []
/api/v1/admin/badges({key})/customproperties({custompropertyKey}):
get:
tags:
- Badges
operationId: Badges_GetCustomPropertyByKeyAndCustompropertykey
parameters:
- name: key
in: path
required: true
schema:
type: string
format: uuid
- name: custompropertyKey
in: path
required: true
schema:
type: string
format: uuid
- name: $expand
in: query
description: Expands related entities inline.
required: false
schema:
type: string
- name: $select
in: query
description: Selects which properties to include in the response.
required: false
schema:
type: string
responses:
'200':
description: OK
content:
'*/*':
schema:
type: object
deprecated: false
security:
- access_token: []
/api/v1/admin/badges({key})/products({productKey}):
get:
tags:
- Badges
operationId: Badges_GetProductByKeyAndProductkey
parameters:
- name: key
in: path
required: true
schema:
type: string
format: uuid
- name: productKey
in: path
required: true
schema:
type: string
format: uuid
- name: $expand
in: query
description: Expands related entities inline.
required: false
schema:
type: string
- name: $select
in: query
description: Selects which properties to include in the response.
required: false
schema:
type: string
responses:
'200':
description: OK
content:
'*/*':
schema:
type: object
deprecated: false
security:
- access_token: []
components:
schemas:
Insite.Data.Entities.Badge:
type: object
properties:
id:
format: uuid
type: string
example: 00000000-0000-0000-0000-000000000000
name:
maxLength: 255
minLength: 0
type: string
tagName:
maxLength: 1024
minLength: 0
type: string
sortOrder:
format: int32
type: integer
activateOn:
format: date-time
type: string
deactivateOn:
format: date-time
type: string
displayOnProductImages:
type: boolean
displayOnBadgeWidget:
type: boolean
ruleManagerId:
format: uuid
type: string
example: 00000000-0000-0000-0000-000000000000
badgeType:
maxLength: 50
minLength: 0
type: string
displayText:
maxLength: 512
minLength: 0
type: string
textColorHexCode:
maxLength: 6
minLength: 0
type: string
badgeColorHexCode:
maxLength: 6
minLength: 0
type: string
largeImageBadgePath:
maxLength: 1024
minLength: 0
type: string
largeImageTextSize:
maxLength: 50
minLength: 0
type: string
otherImageBadgePath:
maxLength: 1024
minLength: 0
type: string
otherImageTextSize:
maxLength: 50
minLength: 0
type: string
imageAltText:
maxLength: 1024
minLength: 0
type: string
detailWidgetBadgeSize:
maxLength: 50
minLength: 0
type: string
badgeStyle:
maxLength: 50
minLength: 0
type: string
largeImagePlacement:
maxLength: 50
minLength: 0
type: string
otherImagePlacement:
maxLength: 50
minLength: 0
type: string
createdOn:
format: date-time
type: string
createdBy:
type: string
modifiedOn:
format: date-time
type: string
modifiedBy:
type: string
securitySchemes:
access_token:
type: apiKey
description: Token used to access storefront API.
name: access_token
in: query