API referenceLists
Update a list
Its name or description. 409 `list_exists` when the new name is taken.
PATCH
Its name or description. 409 list_exists when the new name is taken.
apiKey writeheader
AuthorizationBearer <token>A workspace API key (pf_…), created under Developers → API keys.
Scope: write
id*stringMatch
^(list)_[0-9A-Za-z]{8}$idempotency-key?stringRun this write once: a retry with the same key gets the first answer (24 hours).
Length
1 <= length <= 255application/json- body
name?stringLength
1 <= length <= 100description?|Length
length <= 500folderId?|Match
^(folder)_[0-9A-Za-z]{8}$OK
application/json- response
id*stringMatch
^(list)_[0-9A-Za-z]{8}$name*stringdescription*string|nullfolder*|The folder it’s in; null at the top level
profilesCount*integercreatedAt*stringFormat
date-timeupdatedAt*stringFormat
date-timecurl -X PATCH 'https://api.postforge.dev/v1/lists/string' \ -H 'Content-Type: application/json' \ -d '{}'{ "id": "string", "name": "string", "description": "string", "folder": { "id": "string", "name": "string" }, "profilesCount": 0, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z"}