List Marketing Asset Evaluations

Retrieves all marketing asset evaluations within a workspace, showing which creative materials (ads, copy, images, videos) have been tested and analyzed by AI. An asset evaluation represents an AI-powered assessment of marketing creative, measuring how effective an ad, landing page, or campaign material performs based on AI model analysis. Each evaluation contains scores, recommendations, and improvement suggestions. This endpoint returns all evaluations in a workspace, enabling users to review past creative tests, compare asset performance, and access AI feedback on marketing materials. **When to use:** User wants to see tested marketing assets, list all creative evaluations, review AI feedback on ads, check evaluation status, compare asset performance across campaigns, or discover what creative has been analyzed. **Common user queries:** - "What assets have we evaluated?" - "List all ad evaluations" - "Show me creative test results" - "Which assets were tested this month?" - "Get all asset evaluations" - "What marketing materials did AI analyze?" - "Show me ad performance tests" - "List evaluated landing pages" **Returns:** Array of asset evaluation objects with metadata and optionally detailed asset data. Example: [{"id": "uuid-456", "name": "Q1 Campaign Ads", "status": "completed", "created_at": "2024-01-20T14:00:00Z", "asset_count": 5, "is_archived": false, "assets": [{"id": "asset-1", "content": "Try our new product!", "score": 8.5, "recommendations": ["Add urgency", "Include CTA"]}]}] Required permission: `read:asset_evaluation`.

GET /v1/organizations/{organization_id}/workspaces/{workspace_id}/asset_evaluations

List Marketing Asset Evaluations

cURL

curl --request GET \
  --url https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/asset_evaluations \
  --header 'Authorization: <api-key>'

200

[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "assets": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "content_url": "<string>",
        "content": "<string>",
        "created_by_email": "<string>",
        "thumbnail_url": "<string>",
        "is_archived": true,
        "is_deleted": true,
        "tags": [
          "<string>"
        ],
        "created_at": "2023-11-07T05:31:56Z",
        "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      }
    ],
    "created_at": "2023-11-07T05:31:56Z",
    "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "brand": "<string>",
    "category": "<string>",
    "persona": "<string>",
    "attributes": [
      "<string>"
    ],
    "description": "<string>",
    "is_archived": true,
    "communication_type": "<string>",
    "tags": [
      "<string>"
    ],
    "generation_cost": -1
  }
]

Authorizations

Authorization · string · header · required

Path Parameters

organization_id · string<uuid> · required

A UUID string identifying the organization.

workspace_id · string<uuid> · required

A UUID string identifying the workspace.

Query Parameters

include_assets · boolean

Include related assets with scores and recommendations in the response.

Response

200 - application/json

id · string<uuid> · required · read-only

assets · object[] · required · read-only

Show child attributes

created_at · string<date-time> · required · read-only

created_by · string<uuid> · required

workspace_id · string<uuid> · required

name · string · required

Maximum string length: 255

source · enum<string> · required

• gpt-3.5-turbo - gpt 3.5 turbo
• gpt-4-turbo - gpt 4 turbo
• gpt-4o - gpt 4o
• gpt-4o-mini-search - gpt 4o mini search
• gpt-5 - gpt 5
• gpt-5.2 - gpt 5.2
• gpt-5.4-mini - gpt 5.4 mini
• gemini-1.5-pro - gemini 1.5 pro
• gemini-2.0-flash - gemini 2.0 flash
• gemini-2.5-flash-grounded - gemini 2.5 flash grounded
• gemini-2.5-flash - gemini 2.5 flash
• gemini-2.5-flash-lite - gemini 2.5 flash lite
• gemini-3-flash-preview - gemini 3 flash preview
• meta-llama-3.1-70B-instruct-turbo - meta llama 3.1 70B instruct turbo
• meta-llama-3.2-70B-instruct-turbo - meta llama 3.2 70B instruct turbo
• meta-llama-3.3-70B-instruct-turbo - meta llama 3.3 70B instruct turbo
• meta-llama-4-maverick - meta llama 4 maverick
• mistral-7B-instruct - mistral 7B instruct
• claude-3-5-sonnet - claude 3 5 sonnet
• claude-4-sonnet - claude 4 sonnet
• claude-4-5-sonnet - claude 4 5 sonnet
• claude-4-6-sonnet - claude 4 6 sonnet
• deepseek-chat - deepseek chat
• deepseek-reasoner - deepseek reasoner
• deepseek-v3.2-maas - deepseek v3.2 maas
• perplexity-sonar - perplexity sonar
• rufus - rufus
• google-ai-mode - google ai mode

Available options: gpt-3.5-turbo, gpt-4-turbo, gpt-4o, gpt-4o-mini-search, gpt-5, gpt-5.2, gpt-5.4-mini, gemini-1.5-pro, gemini-2.0-flash, gemini-2.5-flash-grounded, gemini-2.5-flash, gemini-2.5-flash-lite, gemini-3-flash-preview, meta-llama-3.1-70B-instruct-turbo, meta-llama-3.2-70B-instruct-turbo, meta-llama-3.3-70B-instruct-turbo, meta-llama-4-maverick, mistral-7B-instruct, claude-3-5-sonnet, claude-4-sonnet, claude-4-5-sonnet, claude-4-6-sonnet, deepseek-chat, deepseek-reasoner, deepseek-v3.2-maas, perplexity-sonar, rufus, google-ai-mode

brand · string · required

Maximum string length: 255

category · string · required

Maximum string length: 255

persona · string · required

Maximum string length: 255

status · enum<string>

• pending - pending
• in_progress - in progress
• completed - completed
• partial - partial
• failed - failed

Available options: pending, in_progress, completed, partial, failed

attributes · string[]

Maximum string length: 255

description · string

is_archived · boolean

communication_type · string

Maximum string length: 255

tags · string[]

Maximum string length: 255

generation_cost · integer

Required range: -2147483648 <= x <= 2147483647