Console API

Photos

28 endpoints.

GET/api/v1/admin/businesses/{business_id}/generated

List generated photos for a business

List all generated photos across generation jobs. Pagination via cursor and limit.

Parameters

Name	In	Type	Description
`business_id`required	path	`string (uuid)`
`cursor`	query	`string \| null`
`limit`	query	`integer`	default 20
`authorization`	header	`string \| null`

Responses

200Successful Response

application/jsonSuccessResponse_list_GeneratedPhotoData__

Field Type Description

request_idrequired string

success true default true

datarequired

GeneratedPhotoData[]

GeneratedPhotoData[] fields

Field	Type	Description
`id`required	`string`	generated_photo_id (job_id:index)
`business_id`required	`string`
`photo_source`	`string`	default "generated"
`public_url`	`string \| null`	Public CDN URL of the original (no auth); null when not CDN-addressable.
`photo_metadata`	`PhotoMetadata \| null`	PhotoMetadata fields PhotoMetadata (not expanded)
`generation_status`required	`string`	Job status: queued \| processing \| completed \| failed \| stopped
`created_at`	`integer \| null`

metadata

ResponseMetadata | null

ResponseMetadata fields

Field Type Description

pagination

PaginationMetadata | null

PaginationMetadata fields

Field	Type	Description
`limit`required	`integer`
`next_cursor`	`string \| null`
`prev_cursor`	`string \| null`
`has_more`required	`boolean`
`has_prev`	`boolean`	default false
`total_count`	`integer \| null`

status_counts

object | null

object | null fields

Map of string to integer

lifecycle_counts

LifecycleCounts | null

LifecycleCounts fields

Field	Type	Description
`lead`	`integer`	default 0
`prospect`	`integer`	default 0
`customer`	`integer`	default 0
`former_customer`	`integer`	default 0

classification_counts

ClassificationCounts | null

ClassificationCounts fields

Field	Type	Description
`signal`	`object`	object fields Nested object (not expanded)
`touch`	`object`	object fields Nested object (not expanded)
`stage`	`object`	object fields Nested object (not expanded)

meta

ResponseMeta | null

ResponseMeta fields

Field	Type	Description
`total`	`integer \| null`
`total_count`	`integer \| null`
`page`	`integer \| null`
`per_page`	`integer \| null`

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

GET/api/v1/admin/businesses/{business_id}/generated/{generated_photo_id}

Serve generated photo file from GCS

Fetch generated photo bytes from GCS. generated_photo_id is 'job_id:index'.

Parameters

Name	In	Type
`business_id`required	path	`string (uuid)`
`generated_photo_id`required	path	`string`
`authorization`	header	`string \| null`

Responses

200Successful Response

image/*string (binary)

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

GET/api/v1/admin/businesses/{business_id}/photos

Get business photo library

Get business library photos. Pagination via cursor (string) and limit.

Parameters

Name	In	Type	Description
`business_id`required	path	`string (uuid)`
`cursor`	query	`string \| null`
`limit`	query	`integer`	default 20
`authorization`	header	`string \| null`

Responses

200Successful Response

application/jsonSuccessResponse_list_PhotoData__

Field Type Description

request_idrequired string

success true default true

datarequired

PhotoData[]

PhotoData[] fields

Field	Type	Description
`id`required	`string`
`business_id`required	`string`
`photo_url`	`string \| null`
`public_url`	`string \| null`	Public CDN URL of the original (no auth); null when the photo isn't CDN-addressable.
`public_url_downloadable`	`boolean \| null`	Whether browser fetch of public_url works (CORS). False for legacy R2 hosts (copy-only); null when public_url is null.
`photo_source`required	`string`
`original_filename`	`string \| null`
`photo_metadata`	`PhotoMetadata \| null`	PhotoMetadata fields PhotoMetadata (not expanded)
`is_deleted`	`boolean`	default false
`created_at`	`integer \| null`

metadata

ResponseMetadata | null

ResponseMetadata fields

ResponseMetadata, expanded above.

meta

ResponseMeta | null

ResponseMeta fields

ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

GET/api/v1/admin/businesses/{business_id}/photos/{photo_id}

Metadata (incl. ``public_url``) for one photo — the JSON counterpart of the byte-serving ``…/photos/get/{photo_id}``. 404 for missing, deleted, or cross-tenant photos. Declared after the literal ``/photos/*`` routes so it never shadows them.

Parameters

Name	In	Type
`business_id`required	path	`string (uuid)`
`photo_id`required	path	`string (uuid)`
`authorization`	header	`string \| null`

Responses

200Successful Response

application/jsonSuccessResponse_PhotoData_

Field	Type	Description
`request_id`required	`string`
`success`	`true`	default true
`data`required	`PhotoData`	PhotoData fields PhotoData, expanded above.
`metadata`	`ResponseMetadata \| null`	ResponseMetadata fields ResponseMetadata, expanded above.
`meta`	`ResponseMeta \| null`	ResponseMeta fields ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

DELETE/api/v1/admin/businesses/{business_id}/photos/{photo_id}

Delete photo from library

Soft-delete photo from business library. 404 if not found; 409 PHOTO_IN_USE (with per-module usage breakdown in ``details``) if still referenced by a module.

Parameters

Name	In	Type
`business_id`required	path	`string (uuid)`
`photo_id`required	path	`string (uuid)`
`authorization`	header	`string \| null`

Responses

204Successful Response

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

POST/api/v1/admin/businesses/{business_id}/photos/generate

Generate photos

Generate photos from description/style. Returns job ID to poll for status.

Parameters

Name	In	Type	Description
`business_id`required	path	`string (uuid)`
`authorization`	header	`string \| null`

Request bodyrequired

application/jsonGeneratePhotosBody

Field	Type	Description
`description`required	`string`
`style`	`string \| null`
`aspect_ratio`	`string \| null`

Responses

202Successful Response

application/jsonSuccessResponse_GenerateJobResponse_

Field Type Description

request_idrequired string

success true default true

datarequired

GenerateJobResponse

GenerateJobResponse fields

Field	Type	Description
`job_id`required	`string`

metadata

ResponseMetadata | null

ResponseMetadata fields

ResponseMetadata, expanded above.

meta

ResponseMeta | null

ResponseMeta fields

ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

GET/api/v1/admin/businesses/{business_id}/photos/generate/{job_id}

Get photo generation job status

Get generation job status.

Parameters

Name	In	Type
`business_id`required	path	`string (uuid)`
`job_id`required	path	`string`
`authorization`	header	`string \| null`

Responses

200Successful Response

application/jsonSuccessResponse_GenerateJobStatusData_

Field Type Description

request_idrequired string

success true default true

datarequired

GenerateJobStatusData

GenerateJobStatusData fields

Field	Type	Description
`job_id`required	`string`
`status`required	`enum`	queued \| processing \| completed \| failed \| stopped one of "queued", "processing", "completed", "failed", "stopped"
`created_at`	`integer \| null`
`generated_photo_ids`	`string[] \| null`	string[] \| null fields

metadata

ResponseMetadata | null

ResponseMetadata fields

ResponseMetadata, expanded above.

meta

ResponseMeta | null

ResponseMeta fields

ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

GET/api/v1/admin/businesses/{business_id}/photos/get/{photo_id}

Serve photo file from GCS

Fetch photo bytes from GCS and return as binary response. Requires viewer role.

Parameters

Name	In	Type
`business_id`required	path	`string (uuid)`
`photo_id`required	path	`string (uuid)`
`authorization`	header	`string \| null`

Responses

200Successful Response

image/*string (binary)

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

POST/api/v1/admin/businesses/{business_id}/photos/import-from-gallery

Import photos from industry gallery

Import selected industry gallery photos into business library.

Parameters

Name	In	Type	Description
`business_id`required	path	`string (uuid)`
`authorization`	header	`string \| null`

Request bodyrequired

application/jsonImportFromGalleryBody

Field	Type	Description
`gallery_photo_ids`required	`string[]`	min items 1 string[] fields

Responses

201Successful Response

application/jsonSuccessResponse_list_PhotoData__

Field	Type	Description
`request_id`required	`string`
`success`	`true`	default true
`data`required	`PhotoData[]`	PhotoData[] fields PhotoData, expanded above.
`metadata`	`ResponseMetadata \| null`	ResponseMetadata fields ResponseMetadata, expanded above.
`meta`	`ResponseMeta \| null`	ResponseMeta fields ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

POST/api/v1/admin/businesses/{business_id}/photos/import-from-unsplash

Import photos from Unsplash

Import photos from Unsplash by IDs or URLs (hotlinked; no upload). IDs require UNSPLASH_ACCESS_KEY.

Parameters

Name	In	Type	Description
`business_id`required	path	`string (uuid)`
`authorization`	header	`string \| null`

Request bodyrequired

application/jsonImportFromUnsplashBody

Field	Type	Description
`unsplash_photo_ids`	`string[] \| null`	string[] \| null fields
`unsplash_photo_urls`	`string[] \| null`	string[] \| null fields

Responses

201Successful Response

application/jsonSuccessResponse_list_PhotoData__

Field	Type	Description
`request_id`required	`string`
`success`	`true`	default true
`data`required	`PhotoData[]`	PhotoData[] fields PhotoData, expanded above.
`metadata`	`ResponseMetadata \| null`	ResponseMetadata fields ResponseMetadata, expanded above.
`meta`	`ResponseMeta \| null`	ResponseMeta fields ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

POST/api/v1/admin/businesses/{business_id}/photos/import-generated

Import from generated photos

Import selected generated photos (by job_id:index) into business library.

Parameters

Name	In	Type	Description
`business_id`required	path	`string (uuid)`
`authorization`	header	`string \| null`

Request bodyrequired

application/jsonImportGeneratedBody

Field	Type	Description
`generated_photo_ids`	`string[]`	string[] fields

Responses

201Successful Response

application/jsonSuccessResponse_list_PhotoData__

Field	Type	Description
`request_id`required	`string`
`success`	`true`	default true
`data`required	`PhotoData[]`	PhotoData[] fields PhotoData, expanded above.
`metadata`	`ResponseMetadata \| null`	ResponseMetadata fields ResponseMetadata, expanded above.
`meta`	`ResponseMeta \| null`	ResponseMeta fields ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

GET/api/v1/admin/businesses/{business_id}/photos/industry-gallery

Get industry gallery photos

Get photos from industry gallery. Optional industryId filter.

Parameters

Name	In	Type	Description
`business_id`required	path	`string (uuid)`
`industry_id`	query	`string \| null`
`cursor`	query	`string \| null`
`limit`	query	`integer`	default 20
`authorization`	header	`string \| null`

Responses

200Successful Response

application/jsonSuccessResponse_list_IndustryGalleryPhotoData__

Field Type Description

request_idrequired string

success true default true

datarequired

IndustryGalleryPhotoData[]

IndustryGalleryPhotoData[] fields

Field	Type	Description
`id`required	`string`
`industry_id`	`string \| null`
`photo_url`required	`string`
`public_url`	`string \| null`	Public CDN URL of the original (no auth); null when not CDN-addressable.
`public_url_downloadable`	`boolean \| null`	Whether browser fetch of public_url works (CORS). False for legacy R2 hosts (copy-only); null when public_url is null.
`photo_metadata`	`PhotoMetadata \| null`	PhotoMetadata fields PhotoMetadata (not expanded)
`created_at`required	`integer`

metadata

ResponseMetadata | null

ResponseMetadata fields

ResponseMetadata, expanded above.

meta

ResponseMeta | null

ResponseMeta fields

ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

GET/api/v1/admin/businesses/{business_id}/photos/industry-gallery/get/{photo_id}

Serve industry gallery photo file from GCS

Fetch industry gallery photo bytes from GCS and return as binary response.

Parameters

Name	In	Type
`business_id`required	path	`string (uuid)`
`photo_id`required	path	`string (uuid)`
`authorization`	header	`string \| null`

Responses

200Successful Response

image/*string (binary)

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

GET/api/v1/admin/businesses/{business_id}/photos/search-unsplash

Search Unsplash

Search Unsplash. Requires UNSPLASH_ACCESS_KEY.

Parameters

Name	In	Type	Description
`business_id`required	path	`string (uuid)`
`query`required	query	`string`	Search term
`page`	query	`integer`	default 1
`limit`	query	`integer`	default 30
`authorization`	header	`string \| null`

Responses

200Successful Response

application/jsonSuccessResponse_UnsplashSearchData_

Field Type Description

request_idrequired string

success true default true

datarequired

UnsplashSearchData

UnsplashSearchData fields

Field	Type	Description
`items`required	`UnsplashSearchResultItem[]`	UnsplashSearchResultItem[] fields UnsplashSearchResultItem (not expanded)
`page`	`integer`	default 1
`total_pages`	`integer \| null`

metadata

ResponseMetadata | null

ResponseMetadata fields

ResponseMetadata, expanded above.

meta

ResponseMeta | null

ResponseMeta fields

ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

POST/api/v1/admin/businesses/{business_id}/photos/upload

Upload photo to business library

Upload a photo (multipart/form-data). Requires GCS bucket configured.

Parameters

Name	In	Type	Description
`business_id`required	path	`string (uuid)`
`authorization`	header	`string \| null`

Request bodyrequired

multipart/form-dataBody_upload_photo_api_v1_admin_businesses__business_id__photos_upload_post

Field	Type	Description
`file`required	`string`	Image file

Responses

201Successful Response

application/jsonSuccessResponse_PhotoData_

Field	Type	Description
`request_id`required	`string`
`success`	`true`	default true
`data`required	`PhotoData`	PhotoData fields PhotoData, expanded above.
`metadata`	`ResponseMetadata \| null`	ResponseMetadata fields ResponseMetadata, expanded above.
`meta`	`ResponseMeta \| null`	ResponseMeta fields ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

GET/api/v1/admin/industries/{industry_id}/generated

List generated photos for an industry

List all generated photos across generation jobs for an industry.

Parameters

Name	In	Type	Description
`industry_id`required	path	`string`
`cursor`	query	`string \| null`
`limit`	query	`integer`	default 20
`authorization`	header	`string \| null`

Responses

200Successful Response

application/jsonSuccessResponse_list_IndustryGeneratedPhotoData__

Field Type Description

request_idrequired string

success true default true

datarequired

IndustryGeneratedPhotoData[]

IndustryGeneratedPhotoData[] fields

Field	Type	Description
`id`required	`string`	generated_photo_id (job_id:index)
`industry_id`required	`string`
`photo_source`	`string`	default "generated"
`public_url`	`string \| null`	Public CDN URL of the original (no auth); null when not CDN-addressable.
`photo_metadata`	`PhotoMetadata \| null`	PhotoMetadata fields PhotoMetadata (not expanded)
`generation_status`required	`string`	Job status: queued \| processing \| completed \| failed \| stopped
`created_at`	`integer \| null`

metadata

ResponseMetadata | null

ResponseMetadata fields

ResponseMetadata, expanded above.

meta

ResponseMeta | null

ResponseMeta fields

ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

GET/api/v1/admin/industries/{industry_id}/generated/{generated_photo_id}

Serve generated photo file from GCS

Fetch generated photo bytes from GCS. generated_photo_id is 'job_id:index'.

Parameters

Name	In	Type
`industry_id`required	path	`string`
`generated_photo_id`required	path	`string`
`authorization`	header	`string \| null`

Responses

200Successful Response

application/jsonany

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

GET/api/v1/admin/industries/{industry_id}/photos

List photos for an industry

List photos scoped to a single industry with cursor pagination.

Parameters

Name	In	Type	Description
`industry_id`required	path	`string`
`cursor`	query	`string \| null`
`limit`	query	`integer`	default 20
`authorization`	header	`string \| null`

Responses

200Successful Response

application/jsonSuccessResponse_list_IndustryGalleryPhotoData__

Field	Type	Description
`request_id`required	`string`
`success`	`true`	default true
`data`required	`IndustryGalleryPhotoData[]`	IndustryGalleryPhotoData[] fields IndustryGalleryPhotoData, expanded above.
`metadata`	`ResponseMetadata \| null`	ResponseMetadata fields ResponseMetadata, expanded above.
`meta`	`ResponseMeta \| null`	ResponseMeta fields ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

DELETE/api/v1/admin/industries/{industry_id}/photos

Delete industry gallery photos by id

Remove gallery rows whose ids are listed and belong to this industry (JSON body).

Body may be a JSON array of id strings or ``{"ids": [...]}`` (legacy ``gallery_photo_ids`` also accepted).

If you get 422 with an empty/missing body, some clients or proxies drop bodies on **DELETE**; use ``POST .../photos/delete`` with the same JSON instead.

Parameters

Name	In	Type	Description
`industry_id`required	path	`string`
`authorization`	header	`string \| null`

Responses

204Successful Response

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

POST/api/v1/admin/industries/{industry_id}/photos/delete

Delete industry gallery photos (POST; use if DELETE body is stripped)

Same behavior as ``DELETE /industries/{industry_id}/photos``; POST keeps the JSON body on strict proxies.

Parameters

Name	In	Type	Description
`industry_id`required	path	`string`
`authorization`	header	`string \| null`

Responses

204Successful Response

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

POST/api/v1/admin/industries/{industry_id}/photos/generate

Generate photos

Generate photos from description/style for an industry. Returns job ID to poll for status.

Parameters

Name	In	Type	Description
`industry_id`required	path	`string`
`authorization`	header	`string \| null`

Request bodyrequired

application/jsonGeneratePhotosBody

GeneratePhotosBody, expanded above.

Responses

202Successful Response

application/jsonSuccessResponse_GenerateJobResponse_

Field	Type	Description
`request_id`required	`string`
`success`	`true`	default true
`data`required	`GenerateJobResponse`	GenerateJobResponse fields GenerateJobResponse, expanded above.
`metadata`	`ResponseMetadata \| null`	ResponseMetadata fields ResponseMetadata, expanded above.
`meta`	`ResponseMeta \| null`	ResponseMeta fields ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

GET/api/v1/admin/industries/{industry_id}/photos/generate/{job_id}

Get photo generation job status

Get generation job status for an industry.

Parameters

Name	In	Type
`industry_id`required	path	`string`
`job_id`required	path	`string`
`authorization`	header	`string \| null`

Responses

200Successful Response

application/jsonSuccessResponse_GenerateJobStatusData_

Field	Type	Description
`request_id`required	`string`
`success`	`true`	default true
`data`required	`GenerateJobStatusData`	GenerateJobStatusData fields GenerateJobStatusData, expanded above.
`metadata`	`ResponseMetadata \| null`	ResponseMetadata fields ResponseMetadata, expanded above.
`meta`	`ResponseMeta \| null`	ResponseMeta fields ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

POST/api/v1/admin/industries/{industry_id}/photos/import-from-unsplash

Import photos from Unsplash into industry gallery

Import photos from Unsplash by IDs or URLs (hotlinked; no upload). IDs require UNSPLASH_ACCESS_KEY.

Parameters

Name	In	Type	Description
`industry_id`required	path	`string`
`authorization`	header	`string \| null`

Request bodyrequired

application/jsonImportFromUnsplashBody

ImportFromUnsplashBody, expanded above.

Responses

201Successful Response

application/jsonSuccessResponse_list_IndustryGalleryPhotoData__

Field	Type	Description
`request_id`required	`string`
`success`	`true`	default true
`data`required	`IndustryGalleryPhotoData[]`	IndustryGalleryPhotoData[] fields IndustryGalleryPhotoData, expanded above.
`metadata`	`ResponseMetadata \| null`	ResponseMetadata fields ResponseMetadata, expanded above.
`meta`	`ResponseMeta \| null`	ResponseMeta fields ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

POST/api/v1/admin/industries/{industry_id}/photos/import-generated

Import from generated photos

Import selected generated photos (by job_id:index) into industry gallery.

Parameters

Name	In	Type	Description
`industry_id`required	path	`string`
`authorization`	header	`string \| null`

Request bodyrequired

application/jsonImportGeneratedBody

ImportGeneratedBody, expanded above.

Responses

201Successful Response

application/jsonSuccessResponse_list_IndustryGalleryPhotoData__

Field	Type	Description
`request_id`required	`string`
`success`	`true`	default true
`data`required	`IndustryGalleryPhotoData[]`	IndustryGalleryPhotoData[] fields IndustryGalleryPhotoData, expanded above.
`metadata`	`ResponseMetadata \| null`	ResponseMetadata fields ResponseMetadata, expanded above.
`meta`	`ResponseMeta \| null`	ResponseMeta fields ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

GET/api/v1/admin/industries/{industry_id}/photos/search-unsplash

Search Unsplash

Search Unsplash for industry gallery workflows. Requires UNSPLASH_ACCESS_KEY.

Parameters

Name	In	Type	Description
`industry_id`required	path	`string`
`query`required	query	`string`	Search term
`page`	query	`integer`	default 1
`limit`	query	`integer`	default 30
`authorization`	header	`string \| null`

Responses

200Successful Response

application/jsonSuccessResponse_UnsplashSearchData_

Field	Type	Description
`request_id`required	`string`
`success`	`true`	default true
`data`required	`UnsplashSearchData`	UnsplashSearchData fields UnsplashSearchData, expanded above.
`metadata`	`ResponseMetadata \| null`	ResponseMetadata fields ResponseMetadata, expanded above.
`meta`	`ResponseMeta \| null`	ResponseMeta fields ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

GET/api/v1/admin/industries/{industry_id}/photos/template-defaults

List template default photos per website slot

Return each slot from the default website_photos_config with optional linked gallery photo.

Parameters

Name	In	Type	Description
`industry_id`required	path	`string`
`authorization`	header	`string \| null`

Responses

200Successful Response

application/jsonSuccessResponse_dict_str__TemplateDefaultSlotData__

Field Type Description

request_idrequired string

success true default true

datarequired

object

object fields

Map of string to TemplateDefaultSlotData

Field	Type	Description
`id`required	`string`	Slot id from website_photos_config
`label`required	`string`
`description`	`string \| null`
`group`required	`string`
`max_photos`required	`integer`
`website_photos_key`	`string \| null`
`gallery_photo`	`IndustryGalleryPhotoData \| null`	IndustryGalleryPhotoData fields IndustryGalleryPhotoData (not expanded)

metadata

ResponseMetadata | null

ResponseMetadata fields

ResponseMetadata, expanded above.

meta

ResponseMeta | null

ResponseMeta fields

ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

PUT/api/v1/admin/industries/{industry_id}/photos/template-defaults

Set or clear one template default photo slot

Set one slot key to an industry gallery photo id, or null to clear it.

Parameters

Name	In	Type	Description
`industry_id`required	path	`string`
`authorization`	header	`string \| null`

Request bodyrequired

application/jsonPutTemplateDefaultsBody

Field	Type	Description
`key`required	`string`
`photo_id`	`string \| null`

Responses

200Successful Response

application/jsonSuccessResponse_dict_str__TemplateDefaultSlotData__

Field	Type	Description
`request_id`required	`string`
`success`	`true`	default true
`data`required	`object`	object fields Map of string to TemplateDefaultSlotData TemplateDefaultSlotData, expanded above.
`metadata`	`ResponseMetadata \| null`	ResponseMetadata fields ResponseMetadata, expanded above.
`meta`	`ResponseMeta \| null`	ResponseMeta fields ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

POST/api/v1/admin/industries/{industry_id}/photos/upload

Upload photo to industry gallery

Upload an industry gallery photo (multipart/form-data). Requires GCS bucket configured.

Parameters

Name	In	Type	Description
`industry_id`required	path	`string`
`authorization`	header	`string \| null`

Request bodyrequired

multipart/form-dataBody_upload_industry_photo_api_v1_admin_industries__industry_id__photos_upload_post

Field	Type	Description
`file`required	`string`	Image file

Responses

201Successful Response

application/jsonSuccessResponse_IndustryGalleryPhotoData_

Field	Type	Description
`request_id`required	`string`
`success`	`true`	default true
`data`required	`IndustryGalleryPhotoData`	IndustryGalleryPhotoData fields IndustryGalleryPhotoData, expanded above.
`metadata`	`ResponseMetadata \| null`	ResponseMetadata fields ResponseMetadata, expanded above.
`meta`	`ResponseMeta \| null`	ResponseMeta fields ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.