Paperless-ngx icon

Paperless-ngx

Consume documents and metadata from Paperless-ngx API

Tag → Get a Tag

AI-generated

Summary

Fetch a tag by its numeric ID

Inputs

  • id (required) — Positive integer ID of the tag to retrieve

Output shape

a single tag record

Returns the full tag object as defined by Paperless-ngx; may include fields like name, color, usage rights, etc. Returns an empty response if the tag does not exist.

Examples

Example 1: Retrieve a tag by its ID

Enter the desired tag ID in the 'id' field; the node will fetch the corresponding tag from Paperless-ngx and output its data.

Example 2: Get tag ID from list

Select a tag from the dropdown provided by the list mode; the node automatically populates the 'id' input and returns the selected tag.

Example 3: Handle missing tag

If the supplied ID does not exist, the node resolves without error but returns an empty response, allowing downstream handling of not‑found cases.

Links

Discussion