API ReferenceBrand kits
Get a brand import
Status, progress per source and, once status is ready, the draft kit: name, colours (with roles), colour conflicts, fonts, logos, voice, voice samples, guidelines, don'ts, example designs and warnings — every value with the sources it came from. While queued or reading, read again every 10–20 seconds. A ready draft is kept for 7 days.
Authorization
api-key AuthorizationBearer <token>
Workspace API key (nim_live_...)
In: header
Path Parameters
id*string
Format
uuidResponse Body
application/json
curl -X GET "https://example.com/v1/brand-kits/imports/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "status": "queued", "sources": [ { "kind": "website", "label": "Brand book.pdf", "state": "waiting", "error": "string" } ], "draft": { "name": { "value": "string", "sources": [ { "index": 0, "kind": "website", "label": "Brand book.pdf", "detail": "p.3" } ], "options": [ { "value": "string", "sources": [ { "index": 0, "kind": "website", "label": "Brand book.pdf", "detail": "p.3" } ] } ] }, "colors": [ { "hex": "#5F8EFD", "role": "primary", "sources": [ { "index": 0, "kind": "website", "label": "Brand book.pdf", "detail": "p.3" } ] } ], "colorConflicts": [ { "role": "primary", "options": [ { "hex": "#515DEF", "sources": [ { "index": 0, "kind": "website", "label": "Brand book.pdf", "detail": "p.3" } ] } ] } ], "fonts": { "heading": { "family": "Anton", "weight": 700, "sources": [ { "index": 0, "kind": "website", "label": "Brand book.pdf", "detail": "p.3" } ], "options": [ { "family": "Anton", "weight": 700, "sources": [ { "index": 0, "kind": "website", "label": "Brand book.pdf", "detail": "p.3" } ] } ] }, "subheading": { "family": "Anton", "weight": 700, "sources": [ { "index": 0, "kind": "website", "label": "Brand book.pdf", "detail": "p.3" } ], "options": [ { "family": "Anton", "weight": 700, "sources": [ { "index": 0, "kind": "website", "label": "Brand book.pdf", "detail": "p.3" } ] } ] }, "body": { "family": "Anton", "weight": 700, "sources": [ { "index": 0, "kind": "website", "label": "Brand book.pdf", "detail": "p.3" } ], "options": [ { "family": "Anton", "weight": 700, "sources": [ { "index": 0, "kind": "website", "label": "Brand book.pdf", "detail": "p.3" } ] } ] } }, "fontUploads": [ { "family": "Circular Std", "sources": [ { "index": 0, "kind": "website", "label": "Brand book.pdf", "detail": "p.3" } ] } ], "logos": [ { "mediaId": "5a8ffac5-2288-485d-b463-90c3cd9941ad", "url": "string", "sources": [ { "index": 0, "kind": "website", "label": "Brand book.pdf", "detail": "p.3" } ] } ], "voice": { "value": "string", "sources": [ { "index": 0, "kind": "website", "label": "Brand book.pdf", "detail": "p.3" } ], "options": [ { "value": "string", "sources": [ { "index": 0, "kind": "website", "label": "Brand book.pdf", "detail": "p.3" } ] } ] }, "voiceSamples": [ { "text": "string", "sources": [ { "index": 0, "kind": "website", "label": "Brand book.pdf", "detail": "p.3" } ] } ], "guidelines": { "value": "string", "sources": [ { "index": 0, "kind": "website", "label": "Brand book.pdf", "detail": "p.3" } ] }, "doNots": [ { "text": "string", "sources": [ { "index": 0, "kind": "website", "label": "Brand book.pdf", "detail": "p.3" } ] } ], "examples": [ { "mediaId": "5a8ffac5-2288-485d-b463-90c3cd9941ad", "postId": "1d33c5d7-f0cb-41cc-a647-907f16832fc3", "sources": [ { "index": 0, "kind": "website", "label": "Brand book.pdf", "detail": "p.3" } ] } ], "examplesCount": 8, "warnings": [ "string" ] }, "creditsReserved": 45, "creditsUsed": 31, "error": "string", "brandKitId": "0d0050df-b55b-4bc4-9157-db98df0f07d0", "targetBrandKitId": "37cd2e00-cd59-451a-a807-f46d0b6f5445", "target": { "brandKitId": "0d0050df-b55b-4bc4-9157-db98df0f07d0", "brandKitName": "JobCanDo", "hasLogo": true, "colors": { "kit": [ "#5F8EFD" ], "found": [ "string" ], "added": [ "string" ] }, "fonts": { "heading": { "kit": { "family": "Poppins", "weight": 700 }, "found": { "family": "Poppins", "weight": 700 } }, "subheading": { "kit": { "family": "Poppins", "weight": 700 }, "found": { "family": "Poppins", "weight": 700 } }, "body": { "kit": { "family": "Poppins", "weight": 700 }, "found": { "family": "Poppins", "weight": 700 } } }, "voice": { "kit": "string", "found": "string" }, "guidelines": { "kit": "string", "found": "string" }, "defaults": { "colors": "kit", "fonts": { "body": "found" }, "voice": "kit", "guidelines": "kit" }, "brandBooks": [ { "importId": "84402506-7f34-4409-8ec1-a4e0ffb6b608", "mediaId": "5a8ffac5-2288-485d-b463-90c3cd9941ad", "name": "Brand guidelines.pdf", "images": 6, "addedAt": "2019-08-24T14:15:22Z" } ] }, "expiresAt": "2019-08-24T14:15:22Z", "createdAt": "2019-08-24T14:15:22Z"}Empty