Set Active Media Storage Location

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
PUT /media_storage/active

Makes location the caller's profile's active media storage location, where new record media is written, together with its folder and structure.

location Needs destination_root Stored as
2 Dropbox a Dropbox connection optional folder path the path as sent
3 Box a Box connection on a paid Box plan optional folder path the id of the last folder; missing folders are created
5 S3 the server's media bucket not sent -
6 OneDrive a OneDrive connection optional folder path the path as sent
7 SharePoint a SharePoint connection and site_id required document library name the library name; the library is created on the site if missing, and site_id is stored on the connection
8 Google Drive a Google Drive connection optional folder path the id of the last folder; missing folders are created
9 S3 (private) the server's private media bucket not sent -

structure is 0 (the default: root / profile id / form name / file) or 1 (root / file).

Every provider call is made before anything is stored, and the location, folder and structure are then written together, so a provider failure leaves the profile's media storage exactly as it was. Any location may be chosen by any account; there is no plan or account-type restriction beyond Box's own paid-plan requirement.

Authorization

Internal clients only, and a SERVER or COMPANY user.

Headers

  • Authorization string

    e.g. Bearer {access_token}

application/json

Body Required

  • location integer Required

    Values are 2, 3, 5, 6, 7, 8, or 9.

  • destination_root string

    the folder path (a document library name for SharePoint); not used for 5 and 9

    Maximum length is 255.

  • structure integer

    0 = root / profile id / form name / file, 1 = root / file

    Values are 0 or 1. Default value is 0.

  • site_id string

    SharePoint (7) only, required there; root or an id from GET /media_storage/connections/7/sites

Responses

  • 200 application/json

    OK - the location is now the profile's active media storage location.

    Hide response attributes Show response attributes object
    • provider string Required

      Values are dropbox, box, s3, onedrive, sharepoint, google_drive, or s3_private.

    • location integer Required

      the MEDIA_LOCATION code (2 Dropbox, 3 Box, 5 S3, 6 OneDrive, 7 SharePoint, 8 Google Drive, 9 private S3)

    • active boolean Required

      always true

    • destination_root string

      the stored root, when there is one; a folder path for OneDrive and Dropbox, a library name for SharePoint, a folder id for Box and Google Drive

    • account string

      the provider account's display name, when known

  • 400

    Bad Request - location is not one of 2, 3, 5, 6, 7, 8, 9; structure is not 0 or 1; destination_root is not a string, is longer than 255 characters, holds a control character or a ./.. segment, holds whitespace or any of " * : < > ? \ | for location 6, 7 or 8, is sent for location 5 or 9, or is missing or more than one library name for location 7; site_id is missing or not a site id for location 7, or sent for another location; or location 5 or 9 has no S3 bucket configured on this server.

  • 401

    Unauthorized - missing or invalid bearer token.

  • 403

    Forbidden - the client is not an internal client, or the token belongs to a BASIC user.

  • 409

    Conflict - the profile has no connection for location (2, 3, 6, 7, 8); connect it first with POST /media_storage/connections. Also returned when the provider grant must be reconnected.

  • 422

    Unprocessable Entity - Box only; the Box account is not on a paid plan (its upload limit is under 1 GB).

  • 502

    Bad Gateway - the provider failed while the folder or library was being found or created. Nothing was changed.

PUT /media_storage/active
curl \
 --request PUT 'https://api.iformbuilder.com/exzact/api/v81/[servername]/media_storage/active' \
 --header "Content-Type: application/json" \
 --header "Authorization: Bearer {access_token}" \
 --data '{
  "location": 7,
  "destination_root": "iFormMedia",
  "structure": 0,
  "site_id": "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE"
}'
Request example
{
  "location": 7,
  "destination_root": "iFormMedia",
  "structure": 0,
  "site_id": "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE"
}
Response examples (200)
{
  "provider": "box",
  "location": 3,
  "active": true,
  "destination_root": "163842097521",
  "account": "Ops Team"
}
{
  "provider": "s3_private",
  "location": 9,
  "active": true
}