> ## Documentation Index > Fetch the complete documentation index at: https://docs.shareofmodel.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Marketing Creative Assets > Retrieves all marketing creative assets within a workspace, showing the complete inventory of materials available for evaluation and analysis. Assets are the individual marketing materials (ad copy, images, videos, landing page content, headlines, descriptions) that can be tested and evaluated by AI. This endpoint provides an overview of all creative content in the workspace, enabling users to discover available materials, compare assets across different evaluations, track asset usage, and identify which creative has been tested. Essential for cross-evaluation asset comparison and understanding the complete creative inventory. **When to use:** User wants to see all available creative assets, discover what marketing materials exist, compare the same asset across multiple evaluations, track which creative has been tested, find specific assets by name or type, or get an overview of the workspace's creative inventory. **Common user queries:** - "What assets do we have in the workspace?" - "List all marketing creative materials" - "Show me available ads and copy" - "Which assets have been created?" - "Get all creative assets for comparison" - "List assets by type (images, video, text)" - "Show me the asset inventory" - "What creative materials can I evaluate?" **Returns:** Array of asset objects with metadata (id, name, type, content preview, creation date). Example: [{"id": "asset-1", "name": "Hero Ad - Summer Campaign", "type": "image", "content_preview": "Image: beachside lifestyle...", "created_at": "2024-01-10T09:00:00Z", "created_by": "user@example.com", "tags": ["summer", "lifestyle"], "is_archived": false}, {"id": "asset-2", "name": "CTA Button Copy", "type": "text", "content": "Start Your Free Trial Today!", "created_at": "2024-01-12T14:30:00Z"}] Required permission: `read:asset_evaluation`. ## OpenAPI ````yaml https://openapi.shareofmodel.ai/swagger.json get /v1/organizations/{organization_id}/workspaces/{workspace_id}/assets openapi: 3.0.3 info: title: Share Of Model API version: v1 description: >- ## Model Context Protocol (MCP) In addition to this REST API, Share of Model exposes a **Model Context Protocol** server that lets AI assistants (Claude Desktop, Claude Code, MCP Inspector, custom agents…) call our endpoints directly as tools. Any MCP-compatible client can interact with Share of Model without writing custom integration code — connect once with your usual login and start asking the assistant to query the data for you. ### Connecting from Claude Desktop Open **Settings → Connectors**, scroll to the bottom and click **Add custom connector**, then paste `https://mcp.shareofmodel.ai/mcp/`. A browser window opens for you to log in with your Share of Model account (same login as the web app), and the assistant gains access to the tools. ### Connecting from Claude Code ```bash claude mcp add --transport http share-of-model https://mcp.shareofmodel.ai/mcp/ ``` The first time you call a tool, Claude Code opens your browser to complete the login. ### Connecting from MCP Inspector ```bash npx @modelcontextprotocol/inspector ``` In the Inspector UI, pick **Streamable HTTP** as transport, paste `https://mcp.shareofmodel.ai/mcp/`, and click **Connect**. The first connection prompts you to log in. ### Available tools Only endpoints tagged `mcp` in this OpenAPI spec are exposed as MCP tools, and only read-only (`GET`) routes are exposed. Everything tagged `mcp` below is callable from any compliant MCP client. ### Example prompts Once connected, try asking your assistant things like: - _"List the workspaces I have access to."_ - _"Show me the latest searches in workspace X."_ - _"Compare the share of model between brand A and brand B over the last 30 days."_ For more details on the protocol itself, see the [Model Context Protocol specification](https://modelcontextprotocol.io/). servers: - description: Production API url: https://api.shareofmodel.ai/ - description: Development API url: https://api.dev.shareofmodel.ai/ security: [] tags: - name: Auth description: Endpoints needed for API authentication. - name: Organizations description: Endpoints related to organizations, to list all available organizations. - name: Workspaces description: Endpoints related to workspaces, to list all available workspaces. - name: Analyses description: Endpoints related to analyses and analyses management. - name: Asset Evaluations description: Endpoints related to assets and asset evaluations. - name: Brand Catalog description: Endpoints related to general brand information. - name: Content Briefs description: Endpoints related to content briefs generation and optimisation. - name: Metrics description: >+ Endpoints related to brand metrics. **LEXICON** **Brand Awareness**: What opinion the LLMs have concerning specific brands, related to certain categories. **Brand Perception**: The general sentiment of the LLMs towards a brand, based on the pros and cons they mention. paths: /v1/organizations/{organization_id}/workspaces/{workspace_id}/assets: get: tags: - Assets summary: List Marketing Creative Assets description: >- Retrieves all marketing creative assets within a workspace, showing the complete inventory of materials available for evaluation and analysis. Assets are the individual marketing materials (ad copy, images, videos, landing page content, headlines, descriptions) that can be tested and evaluated by AI. This endpoint provides an overview of all creative content in the workspace, enabling users to discover available materials, compare assets across different evaluations, track asset usage, and identify which creative has been tested. Essential for cross-evaluation asset comparison and understanding the complete creative inventory. **When to use:** User wants to see all available creative assets, discover what marketing materials exist, compare the same asset across multiple evaluations, track which creative has been tested, find specific assets by name or type, or get an overview of the workspace's creative inventory. **Common user queries:** - "What assets do we have in the workspace?" - "List all marketing creative materials" - "Show me available ads and copy" - "Which assets have been created?" - "Get all creative assets for comparison" - "List assets by type (images, video, text)" - "Show me the asset inventory" - "What creative materials can I evaluate?" **Returns:** Array of asset objects with metadata (id, name, type, content preview, creation date). Example: [{"id": "asset-1", "name": "Hero Ad - Summer Campaign", "type": "image", "content_preview": "Image: beachside lifestyle...", "created_at": "2024-01-10T09:00:00Z", "created_by": "user@example.com", "tags": ["summer", "lifestyle"], "is_archived": false}, {"id": "asset-2", "name": "CTA Button Copy", "type": "text", "content": "Start Your Free Trial Today!", "created_at": "2024-01-12T14:30:00Z"}] Required permission: `read:asset_evaluation`. operationId: list_assets parameters: - in: query name: include_email schema: type: boolean description: Include email of the asset creator if True. - in: path name: organization_id schema: type: string format: uuid description: A UUID string identifying the organization. required: true - in: path name: workspace_id schema: type: string format: uuid description: A UUID string identifying the workspace. required: true responses: '200': content: application/json: schema: type: array items: $ref: '#/components/schemas/Asset' description: '' security: - Bearer: [] components: schemas: Asset: type: object properties: id: type: string format: uuid readOnly: true created_by_email: type: string nullable: true name: type: string maxLength: 255 content_url: type: string maxLength: 255 thumbnail_url: type: string maxLength: 255 content_type: enum: - image - text - video type: string description: |- * `image` - image * `text` - text * `video` - video x-spec-enum-id: 0343cca47d7cc465 content: type: string is_archived: type: boolean is_deleted: type: boolean tags: type: array items: type: string maxLength: 255 created_at: type: string format: date-time nullable: true created_by: type: string format: uuid nullable: true required: - content - content_type - content_url - id - name securitySchemes: Bearer: type: apiKey in: header name: Authorization ````