Skip to content

DataImportList

The user’s latest imports, newest first.

object
items
required
Array<object>

An import of a CSV file, with its progress.

object
id
required

The ID of a resource, a UUIDv7 in its canonical string form.

string format: uuid
kind
required

What a CSV file lists: following (the accounts the user follows), followed_tags (the hashtags the user follows, followed_hashtags.csv: one hashtag per line without its #, a file of this server that Mastodon does not have), blocks (the accounts the user blocks), mutes (the accounts the user mutes), domain_mutes (the domains the user mutes; Mastodon’s blocked_domains.csv with the header #domain, which a Mastodon user’s blocked domains become here), or bookmarks (the posts the user bookmarked).

string
Allowed values: following followed_tags blocks mutes domain_mutes bookmarks
mode
required

merge adds the file’s entries and keeps what the user has; overwrite also removes what the user has that the file does not list.

string
Allowed values: merge overwrite
state
required

in_progress until every entry and removal is done, then finished.

string
Allowed values: in_progress finished
created_at
required

When the import started.

string format: date-time
total
required

The number of entries to add and things to remove.

integer
processed
required

How many of them are done, including the failed ones.

integer
failed
required

How many of them could not be carried out: an account or post that cannot be found or acted on, a follow that a block stops, or a domain that cannot be muted (this server’s own, or one beyond the most muted domains allowed).

integer

Example generated

{
"items": [
{
"id": "01890a5d-ac96-774b-bcce-b302099a8057",
"kind": "following",
"mode": "merge",
"state": "in_progress",
"created_at": "2026-04-15T12:00:00Z",
"total": 1,
"processed": 1,
"failed": 1
}
]
}

For LLMs and coding agents:llms.txt,llms-full.txt, llms-small.txt

Analytics on this site