The checklist of what we need to build your app, text answers and file uploads.
GET /v1/materials
Get the materials checklist. Lists every checklist item with its status (missing, received, approved, needs_changes), what it accepts and the files you sent. missing lists the required items we still need.
Scope: project:read
Response (200)
| Field | Type | Description |
|---|
objectrequired | "materials" | |
completerequired | boolean | True when no required item is missing. |
missingrequired | array of "logo" | "colors" | "services" | "photos" | "bio" | "hours" | "store" | |
used_bytesrequired | integer | |
quota_bytesrequired | integer | |
itemsrequired | array of MaterialItem | |
Responses
200 The checklist.401 Missing, invalid or expired access token. API Gateway answers {"message": "Unauthorized"}; a token without a linked project gets 403 no_project.403 The token does not have the scope this operation needs. API Gateway answers {"message": "Forbidden"} (or insufficient_scope from the API).429 Too many requests (rate_limited). Each user can make 120 requests per minute; wait for the number of seconds in Retry-After. API Gateway also caps the whole API.
Example
curl https://api.lemobb.com/v1/materials \
-H "Authorization: Bearer $LEMOBB_TOKEN"
PUT /v1/materials/{item}/text
Save a text answer. Saves the text answer of an item that accepts text (colors, services, bio, hours, store). It replaces the previous answer and sends the item back to review. An empty text clears the answer.
Scope: materials:write
Path parameters
| Field | Type | Description |
|---|
itemrequired | string | Checklist item id. One of: logo, colors, services, photos, bio, hours, store. |
Request body
| Field | Type | Description |
|---|
textrequired | string | Empty text clears the answer. max 10000 chars. |
Response (200)
| Field | Type | Description |
|---|
idrequired | "logo" | "colors" | "services" | "photos" | "bio" | "hours" | "store" | |
titlerequired | string | |
hintrequired | string | What we need for this item. |
requiredrequired | boolean | |
statusrequired | "missing" | "received" | "approved" | "needs_changes" | |
textrequired | string | null | |
noterequired | string | null | Note from our team (e.g. what to fix). |
acceptsrequired | object | |
accepts.textrequired | object | null | |
accepts.text.max_lengthrequired | integer | |
accepts.filesrequired | object | null | |
accepts.files.formatsrequired | array of object | |
accepts.files.formats[].formatrequired | "svg" | "png" | "jpeg" | "webp" | "heic" | "pdf" | "csv" | "txt" | "docx" | "xlsx" | |
accepts.files.formats[].content_typerequired | string | |
accepts.files.max_bytesrequired | integer | |
accepts.files.max_filesrequired | integer | |
filesrequired | array of object | |
files[].idrequired | string | |
files[].namerequired | string | |
files[].sizerequired | integer | |
files[].uploaded_atrequired | string (date-time) | |
Responses
200 The updated item.400 The request is invalid (invalid_request, invalid_json) or breaks an item rule (text_not_accepted, text_too_long, files_not_accepted, file_type_not_accepted, file_too_large, too_many_files, quota_exceeded, upload_missing).401 Missing, invalid or expired access token. API Gateway answers {"message": "Unauthorized"}; a token without a linked project gets 403 no_project.403 The token does not have the scope this operation needs. API Gateway answers {"message": "Forbidden"} (or insufficient_scope from the API).404 Unknown checklist item (unknown_item) or upload (upload_not_found).429 Too many requests (rate_limited). Each user can make 120 requests per minute; wait for the number of seconds in Retry-After. API Gateway also caps the whole API.
Example
curl -X PUT https://api.lemobb.com/v1/materials/hours/text \
-H "Authorization: Bearer $LEMOBB_TOKEN" \
-H "Content-Type: application/json" \
-d '{"text": "Mon-Fri 9am-6pm, Sat 10am-2pm. Closed on Sundays."}'
POST /v1/materials/{item}/upload-url
Create an upload URL. Checks the file against the item's rules (format, size, number of files and your storage quota) and returns a pre-signed URL valid for 10 minutes. PUT the file to url with the Content-Type in headers, then confirm it with POST /v1/materials/{item}/files. Limit: 30 per hour.
Scope: materials:write
Path parameters
| Field | Type | Description |
|---|
itemrequired | string | Checklist item id. One of: logo, colors, services, photos, bio, hours, store. |
Request body
| Field | Type | Description |
|---|
file_namerequired | string | min 1 chars, max 500 chars. |
content_typerequired | string | MIME type, e.g. image/png. max 200 chars. |
sizerequired | integer | Exact file size in bytes. min 1. |
Response (200)
| Field | Type | Description |
|---|
objectrequired | "upload_url" | |
upload_idrequired | string | |
methodrequired | "PUT" | |
urlrequired | string | Pre-signed URL. Valid for 10 minutes. |
headersrequired | object | Send exactly these headers with the PUT. |
headers.Content-Typerequired | string | |
expires_atrequired | string (date-time) | |
Responses
200 Where to upload the file.400 The request is invalid (invalid_request, invalid_json) or breaks an item rule (text_not_accepted, text_too_long, files_not_accepted, file_type_not_accepted, file_too_large, too_many_files, quota_exceeded, upload_missing).401 Missing, invalid or expired access token. API Gateway answers {"message": "Unauthorized"}; a token without a linked project gets 403 no_project.403 The token does not have the scope this operation needs. API Gateway answers {"message": "Forbidden"} (or insufficient_scope from the API).404 Unknown checklist item (unknown_item) or upload (upload_not_found).429 Too many requests (rate_limited). Each user can make 120 requests per minute; wait for the number of seconds in Retry-After. API Gateway also caps the whole API.
Example
curl -X POST https://api.lemobb.com/v1/materials/logo/upload-url \
-H "Authorization: Bearer $LEMOBB_TOKEN" \
-H "Content-Type: application/json" \
-d '{"file_name": "logo.png", "content_type": "image/png", "size": 48213}'
# Then upload the file to the returned url:
curl -X PUT "$UPLOAD_URL" -H "Content-Type: image/png" --data-binary @logo.png
POST /v1/materials/{item}/files
Confirm an uploaded file. Confirms a file after the PUT. We check that the size and the file signature match what you declared; if not, the file is discarded (422 file_rejected). On success the file is added to the item.
Scope: materials:write
Path parameters
| Field | Type | Description |
|---|
itemrequired | string | Checklist item id. One of: logo, colors, services, photos, bio, hours, store. |
Request body
| Field | Type | Description |
|---|
upload_idrequired | string | pattern ^[0-9a-f-]{36}\.[a-z]+$. |
Response (200)
| Field | Type | Description |
|---|
idrequired | "logo" | "colors" | "services" | "photos" | "bio" | "hours" | "store" | |
titlerequired | string | |
hintrequired | string | What we need for this item. |
requiredrequired | boolean | |
statusrequired | "missing" | "received" | "approved" | "needs_changes" | |
textrequired | string | null | |
noterequired | string | null | Note from our team (e.g. what to fix). |
acceptsrequired | object | |
accepts.textrequired | object | null | |
accepts.text.max_lengthrequired | integer | |
accepts.filesrequired | object | null | |
accepts.files.formatsrequired | array of object | |
accepts.files.formats[].formatrequired | "svg" | "png" | "jpeg" | "webp" | "heic" | "pdf" | "csv" | "txt" | "docx" | "xlsx" | |
accepts.files.formats[].content_typerequired | string | |
accepts.files.max_bytesrequired | integer | |
accepts.files.max_filesrequired | integer | |
filesrequired | array of object | |
files[].idrequired | string | |
files[].namerequired | string | |
files[].sizerequired | integer | |
files[].uploaded_atrequired | string (date-time) | |
Responses
200 The updated item.400 The request is invalid (invalid_request, invalid_json) or breaks an item rule (text_not_accepted, text_too_long, files_not_accepted, file_type_not_accepted, file_too_large, too_many_files, quota_exceeded, upload_missing).401 Missing, invalid or expired access token. API Gateway answers {"message": "Unauthorized"}; a token without a linked project gets 403 no_project.403 The token does not have the scope this operation needs. API Gateway answers {"message": "Forbidden"} (or insufficient_scope from the API).404 Unknown checklist item (unknown_item) or upload (upload_not_found).422 The file does not match its declared type or size and was discarded.429 Too many requests (rate_limited). Each user can make 120 requests per minute; wait for the number of seconds in Retry-After. API Gateway also caps the whole API.
Example
curl -X POST https://api.lemobb.com/v1/materials/logo/files \
-H "Authorization: Bearer $LEMOBB_TOKEN" \
-H "Content-Type: application/json" \
-d '{"upload_id": "3f1c2a9e-8d7b-4c6a-9f0e-1b2c3d4e5f60.png"}'