Knak

Knak DAM Assets API

Endpoints to retrieve DAM Assets. This is a contract the CUSTOMER implements so Knak can browse images from their own digital asset management system; the base URL is the placeholder host Knak publishes in its specification (https://yourService.com/yourDamApi) because the real host is the customer's service.

Documentation GitHub OpenAPI

Operations 2

GET /v1/dam-assets Retrieve DAM Assets #

GET /v1/search Search DAM Assets #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/knak-dam-assets-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  description: '## Overview

    An API specification to search and use DAM content in Knak.'
  version: V1
  title: Custom Digital Asset Management (DAM) API Reference DAM…
  x-logo:
    url: https://s3.amazonaws.com/assets.knak.io/img/Knak-Logo-Medium.png
servers:
- url: https://yourService.com/yourDamApi
tags:
- name: DAM Assets
  description: Endpoints to retrieve DAM Assets
paths:
  /v1/dam-assets:
    get:
      tags:
      - DAM Assets
      summary: Retrieve DAM Assets
      description: Retrieve all DAM Assets in the folder specified. If no path is given, the app should return the contents of the base folder available to the authorized user. Results are paginated, with a default page size of 10
      parameters:
      - in: query
        name: path
        required: false
        description: The path of to the folder to retrieve
        schema:
          type: string
        example: folder1/folder2
      - name: offset
        in: query
        required: false
        description: (pagination) The offset of the first result to return. Default is 0.
        schema:
          type: integer
      - name: per_page
        in: query
        required: false
        description: (pagination) The Number of items to return per page. Default is 10.
        schema:
          type: integer
      - name: Authorization
        in: header
        required: false
        description: Oauth2 bearer token
        example: Bearer xxxxxxxxx
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DamAssetsIndexResponse'
              examples:
                folder_example:
                  summary: Folder listing
                  description: Listing contents of folder1 containing images and sub-folders
                  value:
                    data:
                    - id: 24fa00d8-211a-4a5f-aa53-f1e30dca86b9
                      name: folder2
                      type: folder
                      path: /folder1/folder2
                    - id: c9ccdf9f-a876-47db-bdc7-1ce828d60d86
                      name: image1.png
                      type: image
                      path: /folder1/image1.png
                      url: https://my.cdn.com/images/c9ccdf9f-a876-47db-bdc7-1ce828d60d86.png
                      thumbnail_url: https://my.cdn.com/previews/c9ccdf9f-a876-47db-bdc7-1ce828d60d86.png\
                      metadata:
                        width: 1920
                        height: 1080
                        size: 1024
                        mime_type: image/png
                    - id: b9f22f78-be85-47f8-bff4-8d0b0152669c
                      name: image2.png
                      type: image
                      path: /folder1/image2.png
                      url: https://my.cdn.com/images/b9f22f78-be85-47f8-bff4-8d0b0152669c.png
                      thumbnail_url: https://my.cdn.com/previews/b9f22f78-be85-47f8-bff4-8d0b0152669c.png
                      metadata:
                        width: 1920
                        height: 1080
                        size: 1024
                        mime_type: image/png
                    messages:
                    - message: Search for asset by their name or ID
                      type: search
                      level: info
                    - message: No results found for the search, verify the name or ID used
                      type: empty
                      level: error
                    meta:
                      offset: 0
                      per_page: 3
                      total: 40
        401:
          description: Unauthenticated
        403:
          description: Unauthorized
      operationId: getV1DamAssets
      x-operation-id-source: derived
  /v1/search:
    get:
      tags:
      - DAM Assets
      summary: Search DAM Assets
      description: Retrieve all DAM Assets matching the search criteria. Results should be paginated with per_page items per page. The most relevant results should be provided first
      parameters:
      - in: query
        name: path
        required: false
        description: Restrict the search to Assets in the specified folder and all child folders. If no path is given, the app should search globally
        example: folderX/folderY
        schema:
          type: string
      - name: term
        in: query
        required: true
        description: Search query term or phrase.
        schema:
          type: string
        example: my_product*
      - name: offset
        in: query
        required: false
        description: (pagination) The offset of the first result to return. Default is 0.
        schema:
          type: integer
      - name: per_page
        in: query
        required: false
        description: (pagination) The Number of items to return per page. Default is 10.
        schema:
          type: integer
      - name: Authorization
        in: header
        required: false
        description: Oauth2 bearer token
        example: Bearer xxxxxxxxx
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DamAssetsSearchResponse'
        401:
          description: Unauthenticated
        403:
          description: Unauthorized
      operationId: getV1Search
      x-operation-id-source: derived
components:
  schemas:
    AssetMetaData:
      type: object
      properties:
        width:
          type: number
          description: The width of the asset in pixels
          example: 1920
        height:
          type: number
          description: The height of the asset in pixels
          example: 1080
        size:
          type: number
          description: The size of the asset in bytes
          example: 1024
        mime_type:
          type: string
          description: The mime type of the asset
          example: image/jpeg
    DamAssetsSearchResponse:
      type: object
      required:
      - data
      - meta
      properties:
        data:
          type: array
          description: The DAM Asset results
          items:
            $ref: '#/components/schemas/DamAsset'
        messages:
          type: array
          description: Custom messages to display on DAM file viewer
          items:
            $ref: '#/components/schemas/DamMessage'
        meta:
          type: object
          description: response metadata
          required:
          - offset
          - total
          properties:
            offset:
              type: number
              description: The current offset of fetched results
              example: 0
            per_page:
              type: number
              description: The number of items requested per page
              example: 1
            total:
              type: number
              description: The total number of search results
              example: 40
    DamAssetsIndexResponse:
      type: object
      required:
      - data
      - metadata
      properties:
        data:
          type: array
          description: The DAM Asset results
          items:
            $ref: '#/components/schemas/DamAsset'
        messages:
          type: array
          description: Custom messages to display on DAM file viewer
          items:
            $ref: '#/components/schemas/DamMessage'
        meta:
          type: object
          description: response metadata
          required:
          - offset
          - total
          properties:
            offset:
              type: number
              description: The current offset of fetched results
              example: 0
            per_page:
              type: number
              description: The number of items requested per page
              example: 1
            total:
              type: number
              description: The total number of search results
              example: 40
    MessageLevel:
      type: string
      enum:
      - info
      - warning
      - error
    DamMessage:
      type: object
      required:
      - message
      - type
      - level
      properties:
        message:
          type: string
          description: Message text to display
          example: Search for asset by their name or ID
        type:
          $ref: '#/components/schemas/MessageType'
        level:
          $ref: '#/components/schemas/MessageLevel'
    DamAsset:
      type: object
      required:
      - id
      - name
      - type
      - path
      properties:
        id:
          type: string
          description: Resource ID
          example: 99816c53-62b1-484d-89b9-35d4453ef770
        name:
          type: string
          description: Resource filename.
          example: myImage.jpg
        type:
          $ref: '#/components/schemas/AssetType'
        path:
          type: string
          description: Full path to resource file
          example: path/to/myimage/folder/myImage.jpg
        url:
          type: string
          description: Resource url as used for content delivery
          example: https://my.cdn.com/images/99816c53-62b1-484d-89b9-35d4453ef770.jpg
        thumbnail_url:
          type: string
          description: Resource thumbnail url for previewing.
          example: https://my.cdn.com/previews/99816c53-62b1-484d-89b9-35d4453ef770.jpg
        metadata:
          $ref: '#/components/schemas/AssetMetaData'
    AssetType:
      type: string
      enum:
      - image
      - video
      - folder
    MessageType:
      type: string
      enum:
      - search
      - empty