Add files to a Log entry

POST

/api/v1/notes/journal/entries/{block_id}/attachments

curl --request POST \
  --url https://example.com/api/v1/notes/journal/entries/example/attachments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "attachments": [ { "target": "example", "text": "example" } ] }'

Requires a signed-in User with the data scope and file access in the Home. It adds file links under the Log entry. It returns 400 for invalid input or 404 when the entry or a file is missing. Route: /api/v1/notes/journal/entries/{block_id}/attachments. Inputs: block_id. Do not automatically replay this operation after an uncertain result.

Authorizations

• installationBearer
• browserSession

Parameters

Path Parameters

block_id

required

string

Request Body^required

Media typeapplication/json

Existing Home files to append to one Journal entry (#421). Keeping the batch explicit lets the server validate every target before one checked Daily note write.

object

attachments

required

Array<object>

>= 1 items <= 32 items

One composer attachment: a Home-relative file path and its link text (#421).

object

target

required

string

text

required

string

Example^generated

{
  "attachments": [
    {
      "target": "example",
      "text": "example"
    }
  ]
}

Responses

200

Media typeapplication/json

object

attachments

required

Array<object>

object

embed

required

boolean

target

required

string

text

required

string

date

required

string

end

string | null

etag

required

string

id

required

string

start

required

string

tags

required

Array<string>

title

required

string

zone

string | null

Example^generated

{
  "attachments": [
    {
      "embed": true,
      "target": "example",
      "text": "example"
    }
  ],
  "date": "example",
  "end": "example",
  "etag": "example",
  "id": "example",
  "start": "example",
  "tags": [
    "example"
  ],
  "title": "example",
  "zone": "example"
}

400

Invalid attachment

404

No Log entry has this block ID