Skip to main content

Image Field

There is only one type of image field: multi_image.

multi_image field-values can only hold one or more multi_image entries.

A multi_image field definition consists only of the common field properties and has no settings.

App creation​

POSThttps://api.tapeapp.com/v1/app

An image field can be created as part of an app creation. Here is an example request body for creating an excerpt of a Contacts app within a workspace with ID 1. The app contains a multi_image field "Portraits". Other useful fields for a contacts app, like "First Name", "Last Name" or "Notes", are omitted for brevity.

➡️    Request

curl -X POST https://api.tapeapp.com/v1/app/ \
   -u user_key_replace_with_your_api_key: \
   -H "Content-Type: application/json" \
   --data '{
    "workspace_id": 1,
    "name": "Contacts",
    "item_name": "Contact",
    "fields": [
      {
        "field_type": "multi_image",
        "config": {
          "label": "Portraits",
          "description": "Portraits of the contact.",
          "required": false
        }
      }
    ]
}'
⬅️    Response
{
  "app_id": 1,
  "workspace_id": 1,
  "slug": "contacts",
  "name": "Contacts",
  "record_name": "Contact",
  "item_name": "Contact",
  "type": "database",
  "position": 0,
  "config": {
    "item_name": "Contact",
    "name": "Contacts"
  },
  "fields": [
    {
      "field_id": 1,
      "slug": "portraits",
      "label": "Portraits",
      "type": "file",
      "field_type": "multi_image",
      "config": {
        "label": "Portraits",
        "slug": "portraits",
        "description": "Portraits of the contact.",
        "required": false,
        "always_hidden": false,
        "hidden_if_empty": false,
        "settings": {
          "multiple": true
        }
      }
    }
  ]
}

App update​

PUThttps://api.tapeapp.com/v1/app/{appId}

An image field can be created or updated as part of an app update. Here is an example request body for updating the previously created contacts app with ID 1. The update changes the description of the "Portraits" field to "Photos of the contact".

➡️    Request

curl -X PUT https://api.tapeapp.com/v1/app/1 \
   -u user_key_replace_with_your_api_key: \
   --data '{
    "app_id": 1,
    "name": "Contacts",
    "item_name": "Contact",
    "fields": [
      {
        "field_id": 1,
        "config": {
          "label": "Portraits",
          "description": "Photos of the contact.",
          "required": false
        }
      }
    ] 
  }'
⬅️    Response
{
  "app_id": 1,
  "workspace_id": 1,
  "slug": "contacts",
  "name": "Contacts",
  "item_name": "Contact",
  "type": "database",
  "position": 0,
  "config": {
    "item_name": "Contact",
    "name": "Contacts"
  },
  "fields": [
    {
      "field_id": 1,
      "slug": "portraits",
      "label": "Portraits",
      "type": "file",
      "field_type": "multi_image",
      "config": {
        "label": "Portraits",
        "slug": "portraits",
        "description": "Photos of the contact.",
        "required": false,
        "always_hidden": false,
        "hidden_if_empty": false,
        "settings": {
          "multiple": true
        }
      }
    }
  ]
}