library

List files

List markdown/text DOCUMENTS in a business's library.

These are text documents (created via create_library_file), NOT uploaded images/videos — for media assets use list_library instead.

Errors: 400 invalid_value: The business_id is not a valid UUID. 401 authentication_required: API key or token is missing, invalid, or revoked. 403 permission_denied: Your plan does not include API access, or this business is not in your org. 404 resource_not_found: No business with that ID exists. 429 rate_limit_exceeded: You sent too many requests this minute.

get/api/businesses/{business_id}/files

Request

  • Base URL: https://api.mymarky.ai
  • URL: https://api.mymarky.ai/api/businesses/{business_id}/files
  • Auth: HTTP bearer

Path parameters

business_idstring required

A UUID identifier.

Query parameters

folder_idstring nullable

Filter by folder (null for root)

cursorstring nullable

The next value from the previous page's response, passed back verbatim. Leave it out for the first page. When next is null you have every result.

limitinteger

Headers

Marky-Version'2026-04-08' | '2026-07-17' | '2026-08-02' | '2026-08-04' | '2026-08-06'
Example:2026-08-06

Opt into a dated API version. Omit to stay on the floor (2026-04-08) forever — unpinned clients never break. Pin to a newer date (e.g. 2026-08-06) to receive the newest response shapes. Unknown values fall back to the floor. See https://docs.mymarky.ai for the versioning model.

Response

Successful Response

nextstring nullable

Opaque cursor for the next page; null when there are no more. Pass it back verbatim as ?cursor=. Do not construct or decode it.

Changes

No recorded changes to this operation across all 1 revision of this API.