Appearance
Get all team folders
Retrieve a list of all team folders with their associated feeds. Supports CSV export via the format=csv query parameter.
OpenAPI definition
json
{
"openapi": "3.0.0",
"info": {
"title": "Enterprise Collections",
"description": "Feedly Enterprise API for managing team folders and collections",
"version": "1.0.0",
"contact": {
"name": "Feedly Support",
"url": ""
}
},
"servers": [
{
"url": "https://api.feedly.com/v3",
"description": "Feedly API v3"
}
],
"security": [
{
"BearerAuth": []
}
],
"components": {
"securitySchemes": {
"BearerAuth": {
"type": "http",
"scheme": "bearer",
"description": "Enterprise API key for authentication"
}
},
"schemas": {
"Feed": {
"type": "object",
"description": "Feed information within a folder",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the feed",
"example": "feed/"
},
"feedId": {
"type": "string",
"description": "Alternative feed identifier",
"example": "feed/"
},
"title": {
"type": "string",
"description": "Feed title",
"example": "Check Point Blog"
},
"description": {
"type": "string",
"description": "Feed description",
"example": "Blog"
},
"website": {
"type": "string",
"format": "uri",
"description": "Website URL for the feed",
"example": ""
},
"language": {
"type": "string",
"description": "Primary language of the feed content",
"example": "en"
},
"topics": {
"type": "array",
"description": "Topics or categories associated with the feed",
"items": {
"type": "string"
},
"example": [
"security",
"vendor",
"tech"
]
},
"subscribers": {
"type": "integer",
"description": "Number of subscribers to this feed",
"example": 9964
},
"velocity": {
"type": "number",
"format": "double",
"description": "Publishing velocity (articles per day)"
},
"estimatedEngagement": {
"type": "integer",
"description": "Estimated engagement level"
},
"created": {
"type": "integer",
"format": "int64",
"description": "Feed creation timestamp (milliseconds since epoch)",
"example": 1424817030751
},
"updated": {
"type": "integer",
"format": "int64",
"description": "Feed last update timestamp (milliseconds since epoch)",
"example": 1761742717599
},
"addedBy": {
"type": "string",
"format": "uuid",
"description": "User ID of who added this feed to the folder",
"example": "7b966855-c953-4ec8-b271-cf554996c1ab"
},
"addedDate": {
"type": "integer",
"format": "int64",
"description": "Timestamp when the feed was added to the folder (milliseconds since epoch)",
"example": 1758707494466
},
"visualUrl": {
"type": "string",
"format": "uri",
"description": "URL to the feed's visual/banner image"
},
"iconUrl": {
"type": "string",
"format": "uri",
"description": "URL to the feed's icon"
},
"coverUrl": {
"type": "string",
"format": "uri",
"description": "URL to the feed's cover image"
},
"isFeedlyFeed": {
"type": "boolean",
"description": "Whether this is a Feedly-managed feed"
},
"partial": {
"type": "boolean",
"description": "Whether this is a partial feed record",
"example": true
}
},
"required": [
"id",
"feedId",
"title",
"website",
"created",
"updated"
]
},
"Folder": {
"type": "object",
"description": "Team folder containing feeds",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the folder",
"example": "enterprise/christeam/category/fa84365d-6433-400e-bbbf-9d3c010889c4"
},
"label": {
"type": "string",
"description": "Display name for the folder",
"example": "*CTI Vendor Reports"
},
"description": {
"type": "string",
"description": "Folder description"
},
"createdBy": {
"type": "string",
"format": "uuid",
"description": "User ID of the folder creator",
"example": "7b966855-c953-4ec8-b271-cf554996c1ab"
},
"created": {
"type": "integer",
"format": "int64",
"description": "Folder creation timestamp (milliseconds since epoch)",
"example": 1758036126516
},
"updated": {
"type": "integer",
"format": "int64",
"description": "Folder last update timestamp (milliseconds since epoch)"
},
"private": {
"type": "boolean",
"description": "Whether this folder is private"
},
"collectionArchived": {
"type": "boolean",
"description": "Whether this folder is archived"
},
"disabled": {
"type": "boolean",
"description": "Whether this folder is disabled"
},
"includeFollowers": {
"type": "boolean",
"description": "Whether to include followers in this folder"
},
"feeds": {
"type": "array",
"description": "List of feeds in this folder",
"items": {
"$ref": "#/components/schemas/Feed"
}
}
},
"required": [
"id",
"label",
"createdBy",
"created",
"feeds"
]
}
}
},
"paths": {
"/enterprise/collections": {
"get": {
"operationId": "getTeamFolders",
"summary": "Get all team folders",
"description": "Retrieve a list of all team folders with their associated feeds. Supports CSV export via the `format=csv` query parameter.",
"tags": [
"Folders"
],
"parameters": [
{
"name": "includeArchived",
"in": "query",
"description": "Include archived folders in the response (default is false)",
"schema": {
"type": "boolean"
},
"example": false
},
{
"name": "format",
"in": "query",
"description": "Export format for the response",
"schema": {
"type": "string",
"enum": [
"csv",
"json"
]
},
"example": "json"
}
],
"responses": {
"200": {
"description": "Successful retrieval of team folders",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Folder"
}
},
"example": [
{
"id": "enterprise/christeam/category/fa84365d-6433-400e-bbbf-9d3c010889c4",
"label": "*CTI Vendor Reports",
"description": "",
"createdBy": "7b966855-c953-4ec8-b271-cf554996c1ab",
"created": 1758036126516,
"updated": 1761742717599,
"private": false,
"collectionArchived": false,
"disabled": false,
"includeFollowers": false,
"feeds": [
{
"id": "feed/",
"feedId": "feed/",
"title": "Check Point Blog",
"description": "Blog",
"website": "",
"language": "en",
"topics": [
"security",
"vendor",
"tech"
],
"subscribers": 9964,
"velocity": 3.8,
"estimatedEngagement": 1,
"created": 1424817030751,
"updated": 1761742717599,
"addedBy": "7b966855-c953-4ec8-b271-cf554996c1ab",
"addedDate": 1758707494466,
"isFeedlyFeed": false,
"partial": true
}
]
}
]
},
"text/csv": {
"schema": {
"type": "string"
},
"example": "id,label,description,createdBy,created,updated,private,collectionArchived,disabled,includeFollowers\n\"enterprise/christeam/category/fa84365d-6433-400e-bbbf-9d3c010889c4\",\"*CTI Vendor Reports\",\"\",\"7b966855-c953-4ec8-b271-cf554996c1ab\",1758036126516,1761742717599,false,false,false,false\n"
}
}
},
"401": {
"description": "Unauthorized - Invalid or missing API key"
},
"403": {
"description": "Forbidden - Insufficient permissions to access team folders"
}
}
}
}
},
"x-readme": {
"explorer-enabled": true,
"proxy-enabled": true
},
"_id": {
"buffer": {
"0": 105,
"1": 2,
"2": 130,
"3": 230,
"4": 110,
"5": 17,
"6": 49,
"7": 193,
"8": 172,
"9": 216,
"10": 116,
"11": 99
}
}
}