Get Media

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://apidocs.zerionsoftware.com/doc/iformbuilder-v81/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
{
  "iFormBuilder V81 MCP server": {
    "url": "https://apidocs.zerionsoftware.com/doc/iformbuilder-v81/mcp"
  }
}

Close
GET /profiles/{profile_id}/media

Streams a private media file referenced by a record's image/file field. The url is the stored value: privates3://, privatecloudfiles://, OneDriveApi:, SharePointApi:, GoogleDriveApi:, DropboxApi:, or a Box (https://*.box.com/shared/static/...) or Dropbox (https://*.dropbox.com/...?raw=1) link. Box and Dropbox links are fetched only from their own hosts, over HTTPS, with bounded retries and timeouts.

Headers

  • Authorization string

    e.g. Bearer {access_token}

Path parameters

  • profile_id string Required

    id of the profile

Query parameters

  • url string Required

    URL of the private media file, as returned in a record's image/file field

Responses

  • 200 */*

    OK - the file's raw bytes with the stored Content-Type.

  • 400 application/json

    Bad Request - the url names a storage path with a dot segment (./..), a privatecloudfiles:// path with an empty target or a dot segment, ?, # or control character, or a connector id (OneDriveApi:, SharePointApi:, GoogleDriveApi:, DropboxApi:) containing a dot segment, ?, # or a control character.

    Hide response attribute Show response attribute object
    • error_message string Required

      human-readable reason for the failure

  • 401 application/json

    Unauthorized - missing or invalid bearer token.

    Hide response attribute Show response attribute object
    • error_message string Required

      human-readable reason for the failure

  • 403 application/json

    Forbidden - the caller cannot access profile_id, or a privates3:// url names a bucket outside the server's private media buckets (mediaAWSS3Info.privateMediaBucket plus oldPrivateMediaBucketList), or a privatecloudfiles:// url names a country, region and container outside the server's private Cloud Files locations (mediaPrivateMainServerLocationInfo, mediaPrivateBackupServerLocationInfo plus oldPrivateCloudFilesLocationList), or either names a server other than this one or one in oldServerIdList, or (for a caller without server scope) another profile.

    Hide response attribute Show response attribute object
    • error_message string Required

      human-readable reason for the failure

  • 404 application/json

    Not Found - the object does not exist or is empty, or the url is not a recognised private media reference.

    Hide response attribute Show response attribute object
    • error_message string Required

      human-readable reason for the failure

  • 409 application/json

    Conflict - the profile's cloud-drive connection must be reconnected (reconnect required).

    Hide response attribute Show response attribute object
    • error_message string Required

      human-readable reason for the failure

  • 502 application/json

    Bad Gateway - storage failed for a reason other than a missing object (any other S3 or Cloud Files error), or a Box/Dropbox host failed, timed out, redirected outside the provider, or was still answering 202 after 3 attempts.

    Hide response attribute Show response attribute object
    • error_message string Required

      human-readable reason for the failure

GET /profiles/{profile_id}/media
curl \
 --request GET 'https://api.iformbuilder.com/exzact/api/v81/[servername]/profiles/self/media?url=string' \
 --header "Authorization: Bearer {access_token}"
Response examples (200)
@file
Response examples (400)
{
  "error_message": "string"
}
Response examples (401)
{
  "error_message": "string"
}
Response examples (403)
{
  "error_message": "string"
}
Response examples (404)
{
  "error_message": "string"
}
Response examples (409)
{
  "error_message": "string"
}
Response examples (502)
{
  "error_message": "string"
}