gotolstoy-com Studio API
Studio-generated asset management
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/gotolstoy-com:gotolstoy-com-studio-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API 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. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Tolstoy Studio API
version: 1.0.0
description: 'The Tolstoy developer API — programmatic access to the AI commerce platform
(AI Studio, AI Player, AI Sales Agent) for developers and AI agents.
Every endpoint requires an authenticated workspace token. Authenticate with
OAuth 2.0 (authorization server https://apilb.gotolstoy.com/mcp/v1, scope
`workspace`), or create a Tolstoy API key in your workspace and exchange it for
an access token at POST /account-service/authenticateCliApiKey with the
`X-CLI-API-Key` header. Send the token as `Authorization: Bearer ` and
include your workspace `appKey` in the request body.
This surface mirrors the official CLI (`@tolstoy-ai/cli` on npm) and the Tolstoy
MCP server (https://apilb.gotolstoy.com/mcp/v1/mcp). Full docs:
https://developers.gotolstoy.com'
contact:
name: Tolstoy Developer Hub
url: https://developers.gotolstoy.com
servers:
- url: https://api.gotolstoy.com
description: Production (Lambda APIs)
- url: https://apilb.gotolstoy.com
description: Production (load-balancer APIs)
security:
- oauth2:
- workspace
- bearerAuth: []
tags:
- name: Studio
description: Studio-generated asset management
paths:
/studio/getDraftStudioAssetCountsByProductIds:
post:
operationId: studio_getDraftStudioAssetCountsByProductIds
summary: Count draft studio assets by product IDs
tags:
- Studio
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
appKey:
type: string
productIds:
type: array
items:
type: string
minLength: 1
minItems: 1
maxItems: 200
includedFolderIds:
type: array
items:
type: string
required:
- appKey
- productIds
additionalProperties: false
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
counts:
type: array
items:
type: object
properties:
productId:
type: string
count:
type: integer
minimum: 0
required:
- productId
- count
additionalProperties: false
required:
- counts
additionalProperties: false
'400':
description: Invalid request
'401':
description: Authentication required
security:
- oauth2:
- workspace
- bearerAuth: []
/studio/getStudioAssetComments:
post:
operationId: studio_getStudioAssetComments
summary: List team comments for a Studio image asset
tags:
- Studio
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
appKey:
type: string
assetId:
type: string
required:
- appKey
- assetId
additionalProperties: false
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
comments:
type: array
items:
type: object
properties:
appKey:
type: string
assetId:
type: string
id:
type: string
body:
type: string
authorUserId:
type: string
authorEmail:
type:
- string
- 'null'
parentCommentId:
type:
- string
- 'null'
createdAt:
type: string
updatedAt:
type: string
required:
- appKey
- assetId
- id
- body
- authorUserId
- authorEmail
- parentCommentId
- createdAt
- updatedAt
additionalProperties: false
totalCount:
type: integer
minimum: 0
required:
- comments
- totalCount
additionalProperties: false
'400':
description: Invalid request
'401':
description: Authentication required
security:
- oauth2:
- workspace
- bearerAuth: []
/studio/createStudioAssetComment:
post:
operationId: studio_createStudioAssetComment
summary: Create a team comment or reply on a Studio image asset
tags:
- Studio
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
appKey:
type: string
assetId:
type: string
body:
type: string
minLength: 1
maxLength: 2000
parentCommentId:
type: string
minLength: 1
required:
- appKey
- assetId
- body
additionalProperties: false
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
appKey:
type: string
assetId:
type: string
id:
type: string
body:
type: string
authorUserId:
type: string
authorEmail:
type:
- string
- 'null'
parentCommentId:
type:
- string
- 'null'
createdAt:
type: string
updatedAt:
type: string
required:
- appKey
- assetId
- id
- body
- authorUserId
- authorEmail
- parentCommentId
- createdAt
- updatedAt
additionalProperties: false
'400':
description: Invalid request
'401':
description: Authentication required
security:
- oauth2:
- workspace
- bearerAuth: []
components:
securitySchemes:
oauth2:
type: oauth2
description: Tolstoy's OAuth 2.0 authorization server (also used by the MCP server). Grants workspace-scoped access to the authenticated account.
flows:
authorizationCode:
authorizationUrl: https://apilb.gotolstoy.com/mcp/v1/oauth/authorize
tokenUrl: https://apilb.gotolstoy.com/mcp/v1/oauth/token
refreshUrl: https://apilb.gotolstoy.com/mcp/v1/oauth/token
scopes:
workspace: Full access to the authenticated Tolstoy workspace.
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: Workspace access token. Obtain one via OAuth 2.0, or create a Tolstoy API key in your workspace and exchange it at POST /account-service/authenticateCliApiKey with the X-CLI-API-Key header. Include your workspace appKey in each request body.
externalDocs:
description: Tolstoy developer documentation
url: https://developers.gotolstoy.com