Kard Organizations > ContentStrategies API
The Organizations > ContentStrategies API from Kard — 2 operation(s) for organizations > contentstrategies.
The Organizations > ContentStrategies API from Kard — 2 operation(s) for organizations > contentstrategies.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/kard:kard-organizations-contentstrategies-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Reference Organizations > ContentStrategies API
version: 1.0.0
servers:
- url: https://rewards-api.getkard.com
description: Production
- url: https://test-rewards-api.getkard.com
description: Sandbox
tags:
- name: Organizations > ContentStrategies
paths:
/v2/issuers/{organizationId}/contentStrategies:
post:
operationId: create
summary: Create
description: Create a content strategy for the organization. The strategy name must be unique within the organization.
tags:
- Organizations > ContentStrategies
parameters:
- name: organizationId
in: path
description: Unique identifier of the organization
required: true
schema:
type: string
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'201':
description: Created content strategy resource
content:
application/json:
schema:
$ref: '#/components/schemas/type_organizations_contentStrategies_ContentStrategyResponse'
'400':
description: Error response with status 400
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
'401':
description: Error response with status 401
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
'403':
description: Error response with status 403
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
'404':
description: Error response with status 404
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
'409':
description: Error response with status 409
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
'500':
description: Error response with status 500
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
requestBody:
description: Content strategy data for creation
content:
application/json:
schema:
$ref: '#/components/schemas/type_organizations_contentStrategies_CreateContentStrategyRequestBody'
get:
operationId: list
summary: List
description: List content strategies belonging to the authenticated organization
tags:
- Organizations > ContentStrategies
parameters:
- name: organizationId
in: path
description: Unique identifier of the organization
required: true
schema:
type: string
- name: filter[name]
in: query
description: Filter by exact content strategy name (unique within an organization)
required: false
schema:
type: string
- name: page[after]
in: query
description: Cursor value for the next page of results
required: false
schema:
type: string
- name: page[size]
in: query
description: Maximum number of records to return [1 - 200] (default = 200)
required: false
schema:
type: integer
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: Paginated list of content strategies
content:
application/json:
schema:
$ref: '#/components/schemas/type_organizations_contentStrategies_ContentStrategyListResponse'
'400':
description: Error response with status 400
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
'401':
description: Error response with status 401
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
'403':
description: Error response with status 403
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
'404':
description: Error response with status 404
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
'500':
description: Error response with status 500
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
/v2/issuers/{organizationId}/contentStrategies/{contentStrategyId}:
get:
operationId: get
summary: Get
description: Retrieve a specific content strategy
tags:
- Organizations > ContentStrategies
parameters:
- name: organizationId
in: path
description: Unique identifier of the organization
required: true
schema:
type: string
- name: contentStrategyId
in: path
description: Unique identifier of the content strategy (UUID v7)
required: true
schema:
type: string
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: Content strategy resource
content:
application/json:
schema:
$ref: '#/components/schemas/type_organizations_contentStrategies_ContentStrategyResponse'
'401':
description: Error response with status 401
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
'403':
description: Error response with status 403
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
'404':
description: Error response with status 404
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
'500':
description: Error response with status 500
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
put:
operationId: update
summary: Update
description: Replace a content strategy. All fields must be provided; any omitted attribute is treated as cleared.
tags:
- Organizations > ContentStrategies
parameters:
- name: organizationId
in: path
description: Unique identifier of the organization
required: true
schema:
type: string
- name: contentStrategyId
in: path
description: Unique identifier of the content strategy (UUID v7)
required: true
schema:
type: string
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: Updated content strategy resource
content:
application/json:
schema:
$ref: '#/components/schemas/type_organizations_contentStrategies_ContentStrategyResponse'
'400':
description: Error response with status 400
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
'401':
description: Error response with status 401
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
'403':
description: Error response with status 403
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
'404':
description: Error response with status 404
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
'409':
description: Error response with status 409
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
'500':
description: Error response with status 500
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
requestBody:
description: Content strategy data for update
content:
application/json:
schema:
$ref: '#/components/schemas/type_organizations_contentStrategies_UpdateContentStrategyRequestBody'
delete:
operationId: delete
summary: Delete
description: Delete a content strategy. Returns 409 if the strategy is still referenced by another resource.
tags:
- Organizations > ContentStrategies
parameters:
- name: organizationId
in: path
description: Unique identifier of the organization
required: true
schema:
type: string
- name: contentStrategyId
in: path
description: Unique identifier of the content strategy (UUID v7)
required: true
schema:
type: string
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: Response with status 200
content:
application/json:
schema:
$ref: '#/components/schemas/type_internal-organizations_DeleteResourceResponse'
'401':
description: Error response with status 401
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
'403':
description: Error response with status 403
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
'404':
description: Error response with status 404
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
'409':
description: Error response with status 409
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
'500':
description: Error response with status 500
content:
application/json:
schema:
$ref: '#/components/schemas/type_commons_ErrorResponse'
components:
schemas:
type_organizations_contentStrategies_ContentStrategyResponse:
type: object
properties:
type:
type: string
enum:
- contentStrategy
id:
type: string
description: Unique identifier of the content strategy (UUID v7)
attributes:
$ref: '#/components/schemas/type_organizations_contentStrategies_ContentStrategyAttributes'
required:
- type
- id
- attributes
description: Content strategy resource response
title: ContentStrategyResponse
type_organizations_contentStrategies_ContentStrategySort:
type: string
enum:
- NEWLY_LIVE
- EXPIRING_SOON
- HIGHEST_CASHBACK
- PERSONALIZED
- OFFERS_NEAR_YOU
description: Sort applied to the offers selected by a content strategy. A strategy may have at most one sort. The v1 starter set covers newly-live, expiring-soon, highest-cashback, personalized, and offers-near-you selections.
title: ContentStrategySort
type_commons_ErrorObject:
type: object
properties:
status:
type: string
description: Status code returned from the request
title:
type: string
description: Name of error
detail:
type: string
description: Description of the specific occurance of the error
source:
$ref: '#/components/schemas/type_commons_ErrorSource'
description: An object containing a reference to the primary source of the error
id:
type: string
description: The id of the resource which caused the error. Always returned for multi-status errors.
required:
- status
- title
- detail
title: ErrorObject
type_organizations_contentStrategies_ContentStrategyAttributes:
type: object
properties:
name:
type: string
description: Name of the content strategy (unique within an organization)
organizationId:
type: string
description: ID of the organization this content strategy belongs to
sort:
$ref: '#/components/schemas/type_organizations_contentStrategies_ContentStrategySort'
description: Sort applied when selecting offers for the strategy
filters:
$ref: '#/components/schemas/type_organizations_contentStrategies_ContentStrategyFilters'
description: Filters applied when selecting offers for the strategy
categories:
type: array
items:
$ref: '#/components/schemas/type_commons_CategoryOption'
description: Merchant categories to include
categoryExclusions:
type: array
items:
$ref: '#/components/schemas/type_commons_CategoryOption'
description: Merchant categories to exclude
merchantExclusions:
type: array
items:
type: string
description: Merchant IDs to exclude
required:
- name
- organizationId
- filters
- categories
- categoryExclusions
- merchantExclusions
description: Attributes for a content strategy
title: ContentStrategyAttributes
type_commons_CategoryOption:
type: string
enum:
- Arts & Entertainment
- Baby, Kids & Toys
- Books & Digital Media
- Clothing, Shoes & Accessories
- Computers, Electronics & Software
- Convenience
- Gas
- Department Stores
- Food & Beverage
- Health & Beauty
- Home & Garden
- Miscellaneous
- Occasions & Gifts
- Pets
- Sports & Outdoors
- Supplies & Services
- Travel
description: Category of merchant. Please use URL Encode for non single word categories. (Food & Beverage should be Food%20%26%20Beverage)
title: CategoryOption
type_organizations_contentStrategies_UpdateContentStrategyAttributes:
type: object
properties:
name:
type: string
description: Name of the content strategy (unique within an organization)
sort:
$ref: '#/components/schemas/type_organizations_contentStrategies_ContentStrategySort'
description: Sort applied when selecting offers for the strategy
filters:
$ref: '#/components/schemas/type_organizations_contentStrategies_ContentStrategyFilters'
description: Filters applied when selecting offers for the strategy
categories:
type: array
items:
$ref: '#/components/schemas/type_commons_CategoryOption'
description: Merchant categories to include
categoryExclusions:
type: array
items:
$ref: '#/components/schemas/type_commons_CategoryOption'
description: Merchant categories to exclude
merchantExclusions:
type: array
items:
type: string
description: Merchant IDs to exclude
required:
- name
- filters
- categories
- categoryExclusions
- merchantExclusions
description: Attributes for updating a content strategy. All fields are required.
title: UpdateContentStrategyAttributes
type_organizations_contentStrategies_UpdateContentStrategyRequestData:
type: object
properties:
type:
type: string
enum:
- contentStrategy
description: Resource type identifier
attributes:
$ref: '#/components/schemas/type_organizations_contentStrategies_UpdateContentStrategyAttributes'
description: Content strategy attributes for update
required:
- type
- attributes
description: Content strategy data structure for update
title: UpdateContentStrategyRequestData
type_commons_Links:
type: object
properties:
self:
type: string
prev:
type: string
next:
type: string
required:
- self
description: Related links to the API call
title: Links
type_organizations_contentStrategies_CreateContentStrategyRequestBody:
type: object
properties:
data:
$ref: '#/components/schemas/type_organizations_contentStrategies_CreateContentStrategyRequestData'
description: Content strategy data for creation
required:
- data
description: Request body for creating a content strategy
title: CreateContentStrategyRequestBody
type_organizations_contentStrategies_CreateContentStrategyAttributes:
type: object
properties:
name:
type: string
description: Name of the content strategy (unique within an organization)
sort:
$ref: '#/components/schemas/type_organizations_contentStrategies_ContentStrategySort'
description: Sort applied when selecting offers for the strategy
filters:
$ref: '#/components/schemas/type_organizations_contentStrategies_ContentStrategyFilters'
description: Filters applied when selecting offers for the strategy
categories:
type: array
items:
$ref: '#/components/schemas/type_commons_CategoryOption'
description: Merchant categories to include
categoryExclusions:
type: array
items:
$ref: '#/components/schemas/type_commons_CategoryOption'
description: Merchant categories to exclude
merchantExclusions:
type: array
items:
type: string
description: Merchant IDs to exclude
required:
- name
- filters
- categories
- categoryExclusions
- merchantExclusions
description: Attributes for creating a content strategy
title: CreateContentStrategyAttributes
type_commons_ErrorResponse:
type: object
properties:
errors:
type: array
items:
$ref: '#/components/schemas/type_commons_ErrorObject'
required:
- errors
title: ErrorResponse
type_organizations_contentStrategies_ContentStrategyListResponse:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/type_organizations_contentStrategies_ContentStrategyResponse'
description: Array of content strategy resources
links:
$ref: '#/components/schemas/type_commons_Links'
meta:
$ref: '#/components/schemas/type_internal-organizations_OrganizationPaginationMetadata'
description: Pagination metadata
required:
- data
description: Paginated list of content strategies
title: ContentStrategyListResponse
type_organizations_contentStrategies_ContentStrategyFilters:
type: object
properties:
categories:
type: array
items:
type: string
description: Merchant categories to include
categoryExclusions:
type: array
items:
type: string
description: Merchant categories to exclude
merchantExclusions:
type: array
items:
type: string
description: Merchant IDs to exclude
offerFeatures:
type: array
items:
$ref: '#/components/schemas/type_organizations_contentStrategies_OfferFeatures'
description: Offer features to filter by
description: Filters applied when selecting offers for a content strategy
title: ContentStrategyFilters
type_organizations_contentStrategies_CreateContentStrategyRequestData:
type: object
properties:
type:
type: string
enum:
- contentStrategy
description: Resource type identifier
attributes:
$ref: '#/components/schemas/type_organizations_contentStrategies_CreateContentStrategyAttributes'
description: Content strategy attributes for creation
required:
- type
- attributes
description: Content strategy data structure for creation
title: CreateContentStrategyRequestData
type_commons_EmptyObject:
type: object
properties: {}
title: EmptyObject
type_internal-organizations_OrganizationPaginationMetadata:
type: object
properties:
pageSize:
type: integer
description: Number of items per page
hasNextPage:
type: boolean
description: Whether more pages are available
required:
- pageSize
- hasNextPage
description: Pagination metadata for organization list responses
title: OrganizationPaginationMetadata
type_internal-organizations_DeleteResourceData:
type: object
properties:
type:
type: string
description: Resource type identifier
id:
type: string
description: ID of the deleted resource
attributes:
$ref: '#/components/schemas/type_commons_EmptyObject'
required:
- type
- id
- attributes
description: Deleted resource stub
title: DeleteResourceData
type_organizations_contentStrategies_OfferFeatures:
type: string
enum:
- INTERACTIVE
description: Offer feature applied to the offers selected by a content strategy. A strategy may have any number of offer features.
title: OfferFeatures
type_organizations_contentStrategies_UpdateContentStrategyRequestBody:
type: object
properties:
data:
$ref: '#/components/schemas/type_organizations_contentStrategies_UpdateContentStrategyRequestData'
description: Content strategy data for update
required:
- data
description: Request body for updating a content strategy
title: UpdateContentStrategyRequestBody
type_internal-organizations_DeleteResourceResponse:
type: object
properties:
data:
$ref: '#/components/schemas/type_internal-organizations_DeleteResourceData'
required:
- data
description: Response returned after deleting a resource
title: DeleteResourceResponse
type_commons_ErrorSource:
type: object
properties:
pointer:
type: string
description: A JSON pointer to the value in the request document that caused the error
parameter:
type: string
description: A string indicating which URI query parameter caused the error
header:
type: string
description: A string indicating the name of a single request header which caused the error
title: ErrorSource
securitySchemes:
OAuthScheme:
type: http
scheme: bearer