Skip to main content
POST
/
plaud
/
files
/
organize
Organize into a folder
curl --request POST \
  --url https://{deployment}/api/v1/plaud/files/organize \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "file_ids": [
    "f1",
    "f2"
  ],
  "tag_name": "Interviews",
  "color": "#46cf6c",
  "match_mode": "fold",
  "create_if_missing": true
}
'
{
  "tag": {
    "id": "<string>",
    "name": "<string>",
    "color": "<string>"
  },
  "tag_created": true,
  "files_assigned": 123
}

Authorizations

​
X-API-KEY
string
header
required

Your deployment's API key (MMK_API_KEY). Your Plaud account credentials are stored server-side — you do not send them.

Body

application/json
​
file_ids
string[]
required
Minimum array length: 1
​
tag_name
string
required
​
color
string

Optional; only used when creating a new tag.

​
icon
string

Optional 4-char hex glyph code; only used when creating.

​
match_mode
enum<string>
default:exact

exact = case-sensitive match; fold = case-insensitive.

Available options:
exact,
fold
​
create_if_missing
boolean
default:true

Create the tag when no match exists.

Response

Organize result

​
tag
object
​
tag_created
boolean

True if the tag was created during this call.

​
files_assigned
integer