Folders & tags | INBIO Docs

Read-only lookups for the folders and tags in your workspace — handy for populating filters or resolving names to folder_id values when creating links. Both require the links:read scope.

To assign a folder or tags, pass folder_id / tags when you create or update a link. Tags are created on the fly.

List folders

GET /api/v1/folders · scope links:read

curl https://in.bio/api/v1/folders \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

{
  "data": [
    {
      "id": 3,
      "name": "Marketing",
      "color": "#2563eb",
      "position": 0,
      "links_count": 24,
      "created_at": "2026-05-01T09:00:00+00:00"
    }
  ]
}

Field	Type	Description
`id`	integer	Folder identifier — pass as `folder_id` on a link.
`name`	string	Display name.
`color`	string \| null	Hex color, if set.
`position`	integer	Sort order in the dashboard.
`links_count`	integer	Number of links in the folder.
`created_at`	string	ISO 8601 timestamp.

GET /api/v1/tags · scope links:read

curl https://in.bio/api/v1/tags \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

{
  "data": [
    { "id": 8, "name": "marketing", "links_count": 41, "created_at": "2026-05-01T09:00:00+00:00" }
  ]
}

Field	Type	Description
`id`	integer	Tag identifier.
`name`	string	Tag name — pass in a link’s `tags` array.
`links_count`	integer	Number of links with this tag.
`created_at`	string	ISO 8601 timestamp.