> ## Documentation Index > Fetch the complete documentation index at: https://docs.adside.ai/llms.txt > Use this file to discover all available pages before exploring further. # Comments create > Pin feedback to a creative revision CLI: `adside creatives comments create` ## OpenAPI ````yaml /api-reference/openapi.yaml post /v1/workspaces/{workspaceId}/creatives/{dropId}/items/{creativeId}/comments openapi: 3.1.0 info: title: Adside API version: 1.0.0 description: >- Campaigns, creatives, assets and reporting across your ad accounts. Call it with a personal API key as a bearer token, or with the `adside` CLI: each page names its command. servers: - url: https://api.adside.ai description: Production security: - userAccess: [] tags: - name: Account - name: Reporting - name: Meta - name: Google Ads - name: LinkedIn - name: TikTok - name: Reddit - name: Snapchat - name: X - name: Google Tag Manager - name: Creatives - name: Creative styles - name: Media - name: Characters - name: Assets - name: Brands - name: Brain - name: Research - name: Boards - name: Artifacts - name: Audiences - name: Ad comments - name: Publications - name: Routines - name: Skills - name: To-dos - name: Audit - name: Credits paths: /v1/workspaces/{workspaceId}/creatives/{dropId}/items/{creativeId}/comments: post: tags: - Creatives summary: Comments create description: |- Pin feedback to a creative revision CLI: `adside creatives comments create` operationId: creatives.comments.create parameters: - name: workspaceId in: path required: true schema: type: string minLength: 1 - name: dropId in: path required: true schema: type: string minLength: 1 - name: creativeId in: path required: true schema: type: string minLength: 1 requestBody: required: true content: application/json: schema: $schema: https://json-schema.org/draft/2020-12/schema type: object properties: creativeRevisionId: type: string minLength: 1 maxLength: 300 target: oneOf: - type: object properties: kind: type: string const: creative required: - kind - type: object properties: kind: type: string const: element previewVariant: type: string enum: - story - portrait - square - landscape - wide - twitter - link x: type: number minimum: 0 maximum: 1 'y': type: number minimum: 0 maximum: 1 width: type: number exclusiveMinimum: 0 maximum: 1 height: type: number exclusiveMinimum: 0 maximum: 1 elementRole: type: string maxLength: 120 elementText: type: string maxLength: 500 elementId: type: string maxLength: 240 sourcePath: type: string minLength: 1 maxLength: 500 sourceLine: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 timeSeconds: type: number minimum: 0 selectionSource: type: string enum: - render - live contextAssetId: type: string minLength: 1 visualEdit: oneOf: - type: object properties: id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ kind: type: string const: text nodePath: minItems: 1 maxItems: 40 type: array items: type: integer minimum: 0 maximum: 10000 before: type: string maxLength: 4000 after: type: string minLength: 1 maxLength: 4000 required: - id - kind - nodePath - before - after - type: object properties: id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ kind: type: string const: resize nodePath: minItems: 1 maxItems: 40 type: array items: type: integer minimum: 0 maximum: 10000 before: type: object properties: width: type: number exclusiveMinimum: 0 maximum: 1 height: type: number exclusiveMinimum: 0 maximum: 1 required: - width - height after: type: object properties: width: type: number exclusiveMinimum: 0 maximum: 1 height: type: number exclusiveMinimum: 0 maximum: 1 required: - width - height required: - id - kind - nodePath - before - after - type: object properties: id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ kind: type: string const: reorder nodePath: minItems: 1 maxItems: 40 type: array items: type: integer minimum: 0 maximum: 10000 blockPath: minItems: 1 maxItems: 40 type: array items: type: integer minimum: 0 maximum: 10000 placement: type: string enum: - before - after anchor: type: object properties: nodePath: minItems: 1 maxItems: 40 type: array items: type: integer minimum: 0 maximum: 10000 blockPath: minItems: 1 maxItems: 40 type: array items: type: integer minimum: 0 maximum: 10000 elementRole: type: string minLength: 1 maxLength: 120 elementText: type: string maxLength: 500 sourcePath: type: string minLength: 1 maxLength: 500 sourceLine: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 elementId: type: string maxLength: 240 required: - nodePath - blockPath - elementRole - elementText - sourcePath - sourceLine required: - id - kind - nodePath - blockPath - placement - anchor required: - kind - previewVariant - x - 'y' - width - height - type: object properties: kind: type: string const: region previewVariant: type: string enum: - story - portrait - square - landscape - wide - twitter - link x: type: number minimum: 0 maximum: 1 'y': type: number minimum: 0 maximum: 1 width: type: number exclusiveMinimum: 0 maximum: 1 height: type: number exclusiveMinimum: 0 maximum: 1 elementRole: type: string maxLength: 120 elementText: type: string maxLength: 500 elementId: type: string maxLength: 240 sourcePath: type: string minLength: 1 maxLength: 500 sourceLine: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 timeSeconds: type: number minimum: 0 selectionSource: type: string enum: - render - live contextAssetId: type: string minLength: 1 required: - kind - previewVariant - x - 'y' - width - height body: type: string minLength: 1 maxLength: 10000 required: - creativeRevisionId - target - body additionalProperties: false responses: '201': description: Success content: application/json: schema: $schema: https://json-schema.org/draft/2020-12/schema type: object properties: commentId: type: string required: - commentId additionalProperties: false security: - userAccess: [] components: securitySchemes: userAccess: type: http scheme: bearer description: >- A personal API key (`adside_pat_…`) or a token from `adside login`. Either carries the permissions of the person it belongs to. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.