> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.morphiaone.ai/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.morphiaone.ai/_mcp/server. # Create a catalogue Look POST https://api.morphiaone.ai/v1/catalogue/looks Content-Type: application/json Creates an `unpublished` look with revision 1 as a `draft`: an ordered list of `applications`, each either a `variant` entry naming one of your variants, a revision of it and one of its `application_id`s, or a `custom` entry naming a makeup category with its colour and options. The revision is compiled when it is written: a variant entry pins the variant revision it names, which must be approved, and a custom entry pins the category's current profile `(id, version, digest)`. An entry that does not compile is `400 INVALID_REQUEST` naming `applications[i]`. Nothing renders a look until a revision is approved and published. Send an `Idempotency-Key`: a retry with the same key and the same request answers the first response, byte for byte, with `Idempotency-Replayed: true`, so a response you did not receive is safe to retry. Requires the `catalogue.write` scope, which your account operator provisions; no other catalogue scope implies it. Served only where the catalogue is enabled for your environment. Reference: https://docs.morphiaone.ai/api-reference/endpoints/catalogue/looks-create ## Authentication - `X-API-Key` header (required) — API key for one environment of your account. Keep server-side; never expose in browser clients. ## Request ### Headers - `Idempotency-Key` (string, optional, nullable) ### Body (application/json) This endpoint expects an object. - `applications` (list of V1CatalogueLooksPostRequestBodyContentApplicationJsonSchemaApplicationsItems, required) ## Response ### 201 The look, unpublished, with revision 1 a draft - `active_revision` (integer, required, nullable) - `availability` (enum, required) - Allowed values: `unpublished`, `active`, `retired` - `created_at` (datetime, required) - `generation` (integer, required) - `id` (string, required) - `latest_revision` (integer, required) - `updated_at` (datetime, required) ## Errors ### 400 Bad Request Error Invalid look or Idempotency-Key - `error` (ErrorDetail, required) ### 401 Unauthorized Error Missing or invalid API key - `error` (ErrorDetail, required) ### 403 Forbidden Error API key lacks the catalogue.write scope - `error` (ErrorDetail, required) ### 409 Conflict Error Idempotency conflict - `error` (ErrorDetail, required) ### 503 Service Unavailable Error Catalogue unavailable - `error` (ErrorDetail, required) ## Types ### V1CatalogueLooksPostRequestBodyContentApplicationJsonSchemaApplicationsItems - `mode`: `variant` (CatalogueLookVariantEntryInput) - `variant_id` (string, required) - `application_id` (string, optional, nullable) - `revision` (integer, optional, nullable) - `mode`: `custom` (CatalogueLookCustomEntryInput) - `category` (string, required) - `color` (string, required) - `finish` (string, optional, nullable) - `intensity` (string, optional, nullable) - `placement` (string, optional, nullable) - `style` (string, optional, nullable) ### ErrorDetail - `code` (string, required) - `message` (string, required) - `request_id` (string, required) - `details` (ErrorDetailDetails, optional) - `doc_url` (string, optional, nullable) - `retryable` (boolean, optional, nullable) ### ErrorDetailDetails - map from string to any - list of map from string to any ## Examples **Request** ```json { "applications": [ { "mode": "string", "variant_id": "string" } ] } ``` **Response** ```json { "active_revision": 1, "availability": "active", "created_at": "2026-10-07T10:02:14.118000Z", "generation": 2, "id": "look_1m2n4p6q8r0s2t4v6w8x0y2z4a", "latest_revision": 1, "updated_at": "2026-10-07T10:40:22.907000Z" } ``` **SDK Code** ```python Catalogue_looksCreate_example import requests url = "https://api.morphiaone.ai/v1/catalogue/looks" payload = { "applications": [ { "mode": "string", "variant_id": "string" } ] } headers = { "X-API-Key": "", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Catalogue_looksCreate_example const url = 'https://api.morphiaone.ai/v1/catalogue/looks'; const options = { method: 'POST', headers: {'X-API-Key': '', 'Content-Type': 'application/json'}, body: '{"applications":[{"mode":"string","variant_id":"string"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Catalogue_looksCreate_example package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.morphiaone.ai/v1/catalogue/looks" payload := strings.NewReader("{\n \"applications\": [\n {\n \"mode\": \"string\",\n \"variant_id\": \"string\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("X-API-Key", "") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Catalogue_looksCreate_example require 'uri' require 'net/http' url = URI("https://api.morphiaone.ai/v1/catalogue/looks") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["X-API-Key"] = '' request["Content-Type"] = 'application/json' request.body = "{\n \"applications\": [\n {\n \"mode\": \"string\",\n \"variant_id\": \"string\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Catalogue_looksCreate_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.morphiaone.ai/v1/catalogue/looks") .header("X-API-Key", "") .header("Content-Type", "application/json") .body("{\n \"applications\": [\n {\n \"mode\": \"string\",\n \"variant_id\": \"string\"\n }\n ]\n}") .asString(); ``` ```php Catalogue_looksCreate_example request('POST', 'https://api.morphiaone.ai/v1/catalogue/looks', [ 'body' => '{ "applications": [ { "mode": "string", "variant_id": "string" } ] }', 'headers' => [ 'Content-Type' => 'application/json', 'X-API-Key' => '', ], ]); echo $response->getBody(); ``` ```csharp Catalogue_looksCreate_example using RestSharp; var client = new RestClient("https://api.morphiaone.ai/v1/catalogue/looks"); var request = new RestRequest(Method.POST); request.AddHeader("X-API-Key", ""); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"applications\": [\n {\n \"mode\": \"string\",\n \"variant_id\": \"string\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Catalogue_looksCreate_example import Foundation let headers = [ "X-API-Key": "", "Content-Type": "application/json" ] let parameters = ["applications": [ [ "mode": "string", "variant_id": "string" ] ]] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.morphiaone.ai/v1/catalogue/looks")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```