Entries (realtime)

Update an attachment field

Updates an attachment field for the attachment identified by the specified token.

put/attachment/{token}/update-field/{field_slug}

Headers

Accept'application/vnd.Creative Force.v2.3+json' | 'application/vnd.Creative Force.v2.3+xml' required

Defines the response type.

Request body

{"stackTrail":"components:requestBodies:AttachmentFieldUpdate:content:application/json:schema:properties:value","oasType":"schema","type":"unknown","description":"New value for the attachment field identified by `field_slug`. The accepted value depends on the type and configuration of the field.\n\nUse a string for text fields, a number for numeric fields, an ISO 8601 date for date fields, and an option slug for choice fields. A value outside the option set of a choice field returns a `422` response. For file-type fields, use an object containing the base64-encoded file data and a filename."}

Response

Attachment field updated.

createdstring date-time

Time the attachment was created.

orderinteger

Position of the attachment within its tab.

tokenstring

Token identifying the attachment file. Same value as file.token.

updatedstring date-time

Time the attachment was last updated.

Example response

{
  "entry": {
    "slug": "AbCdEfGh",
    "link": "https://api.au.cr4ce.com/entry/AbCdEfGh",
    "title": "Project title"
  },
  "attachment_fields": [
    {
      "slug": "IjKlMnOp",
      "link": "https://api.au.cr4ce.com/field/IjKlMnOp",
      "label": {
        "en_GB": "Type of attachment"
      },
      "title": {
        "en_GB": "Type of attachment"
      },
      "value": "Photo",
      "translated": {
        "en_GB": "Photo"
      }
    },
    {
      "slug": "QrStUvWx",
      "link": "https://api.au.cr4ce.com/field/QrStUvWx",
      "label": {
        "en_GB": "<p>URL</p>"
      },
      "title": {
        "en_GB": "URL"
      },
      "value": "https://example.com/image.svg",
      "translated": {
        "en_GB": "https://example.com/image.svg"
      }
    }
  ],
  "created": "2025-04-27T01:00:00Z",
  "file": {
    "token": "AbCdEfGhIjKlMnOp",
    "link": "https://api.au.cr4ce.com/file/AbCdEfGhIjKlMnOp",
    "download": "https://files.au.cr4ce.com/file/AbCdEfGhIjKlMnOp/example.pdf?Expires=1781485359&Signature=REDACTED&Key-Pair-Id=REDACTED",
    "filename": "example.pdf"
  },
  "order": 1,
  "tab": {
    "slug": "YzAbCdEf",
    "link": "https://api.au.cr4ce.com/tab/YzAbCdEf",
    "name": {
      "en_GB": "Attachments"
    }
  },
  "token": "AbCdEfGhIjKlMnOp",
  "updated": "2025-04-27T01:05:00Z"
}

Changes

Changed in 2 of the 50 revisions of this API.10

Jul 7, 2026v29b9103538ceb2See the full diff
- ○
  api tag Entries (realtime) added
  api-tag-added
- ○
  api tag Entry (realtime) removed
  api-tag-removed
Jul 1, 2026v2e96a96d4507e8See the full diff
- ○
  added the media type application/xml for the response with the status 200
  response-media-type-added
- ○
  added the media type application/xml for the response with the status 400
  response-media-type-added
- ○
  added the media type application/xml for the response with the status 401
  response-media-type-added
- ○
  added the media type application/xml for the response with the status 403
  response-media-type-added
- ○
  added the media type application/xml for the response with the status 404
  response-media-type-added
- ○
  added the media type application/xml for the response with the status 422
  response-media-type-added
- ○
  added the media type application/xml for the response with the status 429
  response-media-type-added
- ○
  added the media type application/xml for the response with the status 503
  response-media-type-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history