> ## Documentation Index > Fetch the complete documentation index at: https://docs.omnicommerce.sg/llms.txt > Use this file to discover all available pages before exploring further. # Create Look > Create a Look from existing catalog products and queue AI image generation for a fast preview. The response is asynchronous: poll `GET /api/v1/jobs/{jobId}?organizationId={organizationId}` until the `look_...` job completes, then fetch the generated Look with `GET /api/v1/looks/{lookId}`. ## OpenAPI ````yaml /openapi.json post /api/v1/looks openapi: 3.1.0 info: title: OmniCommerce API version: 1.0.0 license: name: Proprietary url: https://omnicommerce.sg/terms description: >- OmniCommerce API surface for agents and developer integrations. Includes public endpoints (merchant discovery, product search, compare, catalog, ACO retrieval) and authenticated endpoints (product management via API key Bearer tokens). servers: - url: https://omnicommerce.sg description: Production - url: http://localhost:3000 description: Local development security: [] tags: - name: agentic-checkout description: Merchant-fulfilled agentic checkout x-group: Agentic Checkout - name: commerce description: Root commerce discovery x-group: Commerce - name: developer-platform description: Authenticated developer platform APIs x-group: Developer Platform - name: looks description: AI-styled product looks x-group: Looks - name: oauth description: OAuth token endpoints x-group: OAuth - name: orders description: Workspace and agentic orders x-group: Orders - name: organizations description: Organization management x-group: Organizations - name: price-books description: Marketplace list-price markup rules x-group: Price Books - name: products description: Product CRUD, bulk import, and publish x-group: Products - name: promotions description: Central promotions and marketplace sync x-group: Promotions - name: public-agent description: Public agent discovery and catalog APIs x-group: Public Agent - name: settlements description: settlements x-group: Settlements - name: ucp description: Universal Commerce Protocol x-group: UCP paths: /api/v1/looks: post: tags: - looks summary: Create Look description: >- Create a Look from existing catalog products and queue AI image generation for a fast preview. The response is asynchronous: poll `GET /api/v1/jobs/{jobId}?organizationId={organizationId}` until the `look_...` job completes, then fetch the generated Look with `GET /api/v1/looks/{lookId}`. operationId: post_v1_looks requestBody: required: true content: application/json: schema: type: object additionalProperties: false required: - productIds properties: organizationId: type: string maxLength: 120 description: >- Optional for API-key requests; required for session-authenticated requests across multiple organizations. title: type: string maxLength: 160 productIds: type: array minItems: 1 maxItems: 9 description: >- Ordered OmniCommerce product UUIDs to use as visual references. The first item is the primary product; the rest are reference products. items: type: string subject: type: string maxLength: 120 description: >- Scene subject such as model, table setting, shelf, desk setup, or free text. style: type: string maxLength: 120 season: type: string maxLength: 80 timeOfDay: type: string maxLength: 80 city: type: string maxLength: 160 additionalNotes: type: string maxLength: 1000 description: Additional one-look styling guidance for the AI. model: type: string maxLength: 120 description: >- Optional image model override. Looks default to the organization's configured image model and optimize for faster preview generation. example: productIds: - 33333333-3333-5333-8333-333333333333 - 44444444-4444-5444-8444-444444444444 title: Spring city edit subject: model style: Chic season: Spring timeOfDay: Day city: Paris additionalNotes: Cafe terrace, relaxed luxury styling responses: '202': description: Look record created and preview image generation queued. content: application/json: schema: type: object required: - ok - apiVersion - operationId - status - jobId - data properties: ok: type: boolean apiVersion: type: string default: developer_v1 operationId: type: string status: type: string enum: - accepted jobId: type: string description: >- Async look generation job ID. Look jobs use the `look_` prefix. warnings: type: array items: type: string recommendations: type: array items: type: string links: type: object additionalProperties: type: string data: type: object required: - look properties: look: type: object required: - id - organizationId - status - createdAt - updatedAt - productCount properties: id: type: string description: Look UUID. organizationId: type: string title: type: - string - 'null' status: type: string enum: - draft - published subject: type: - string - 'null' style: type: - string - 'null' season: type: - string - 'null' timeOfDay: type: - string - 'null' city: type: - string - 'null' additionalNotes: type: - string - 'null' stylePrompt: type: - string - 'null' description: One-sentence prompt used for image generation. heroImageTagId: type: - string - 'null' description: >- Generated image_tags UUID when image tagging succeeded. heroImageUrl: type: - string - 'null' description: Remote HTTP(S) URL for the generated look image. createdBy: type: - string - 'null' createdAt: type: string updatedAt: type: string publishedAt: type: - string - 'null' productCount: type: integer minimum: 0 example: ok: true apiVersion: developer_v1 operationId: 8f7e8f8f-2b9e-46e6-a2c0-50d0f4612b2d status: accepted jobId: look_7e1d7c4c-7c44-4a57-bf46-75a10f1b8e31 warnings: [] recommendations: - >- Poll GET /api/v1/jobs/{jobId}?organizationId={organizationId} until status is completed or failed. links: job: >- /api/v1/jobs/look_7e1d7c4c-7c44-4a57-bf46-75a10f1b8e31?organizationId=org_123 look: /api/v1/looks/11111111-1111-4111-8111-111111111111 data: look: id: 11111111-1111-4111-8111-111111111111 organizationId: org_123 title: Spring city edit status: draft style: Chic productCount: 2 createdAt: '2026-07-04T00:00:00.000Z' updatedAt: '2026-07-04T00:00:00.000Z' '400': description: >- Bad Request - invalid payload, duplicate product IDs, or products not owned by the organization '401': description: Unauthorized '403': description: Forbidden - missing catalog:write scope or organization access '500': description: Internal Server Error security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows. ````