Get Resources

📁 Media Center Files

Description

This API retrieves media center content based on specified filters such as type, tags, sorting, and custom lists. It supports pagination and advanced filtering options.

HTTP Method: GET

Endpoint: /mcenter/v1/get

Request Details

Headers

Key	Type	Required	Description
x-api-key	string	Yes	API key provided by the Networked Team or generated via the Platform.
spaceId	string	No	Id of the space for which the media center files are needed. (optional) By default the data of the community Media center is returned .

Query Parameters

Parameter	Type	Required	Description
start	number	Yes	The offset from which to start fetching results.
count	number	Yes	The number of items to fetch.
data[]	array	Yes	Array of integers representing media types to fetch (e.g., 0, 1, 3).
communityCollection	boolean	No	Whether to include community-level collection items.
sortBy	number	No	Field to sort by (e.g., `3` for created time).
orderBy	number	No	Sorting order (1 for ascending, -1 for descending).
startDate	string	No	Start date for filtering (nullable).
endDate	string	No	End date for filtering (nullable).
withTag	string	No	Filter items that contain a specific tag (nullable).
noTag	string	No	Filter items that do not contain a specific tag (nullable).
keyFilter	string	No	To be used for searching the media center file , search will include any file name, description , customList name , TagName or CustomList Tag name if it matches and have's it .

Sample Response

{
  "data": {
    "start": 0,
    "count": 2,
    "nextStart": false,
    "content": [
      {
        "id": "682fc48db83c900012105cb9",
        "name": "Image Pasted at 2025-5-21 18-46.gif",
        "type": 20,
        "description": "",
        "url": "https://ntwc-us-east-2-qa-eks-s3-media-storage.s3.amazonaws.com/community-67959032bc6bea0012fdc671/file-1747960973368-Image Pasted at 2025-5-21 18-46.gif",
        "pinnedToTop": false,
        "size": 53588,
        "creationTime": 1747960973355,
        "createdBy": {
          "id": "6787893423126f0012a92ed6",
          "name": "Spencer Johnson Spencer",
          "image": "https://ntwc-us-east-2-qa-eks-s3-files-storage.s3.us-east-2.amazonaws.com/user-6787893423126f0012a92ed6/file_1741258763688_image (25).png",
          "title": " Software Development Test Engineer WBC Community Test Engineer"
        },
        "tags": [
          {
            "_id": "68385bc7b83c90001210ccd4",
            "user": "6683ae18795e3b0012ec9a40",
            "community": "67959032bc6bea0012fdc671",
            "name": "tag1",
            "__v": 0
          }
        ],
        "customList": [
          {
            "tags": ["68385c47b83c90001210cd9a", "68385c47b83c90001210cd9b"],
            "_id": "68385c59b83c90001210cdf6",
            "customList": "68385c47b83c90001210cd98",
            "customListInfo": {
              "_id": "68385c47b83c90001210cd98",
              "isMainFilter": true,
              "name": "Priority",
              "community": "67959032bc6bea0012fdc671",
              "user": "6683ae18795e3b0012ec9a40",
              "__v": 0
            },
            "tagInfo": [
              {
                "_id": "68385c47b83c90001210cd9a",
                "name": "High",
                "user": "6683ae18795e3b0012ec9a40",
                "customList": "68385c47b83c90001210cd98",
                "__v": 0
              },
              {
                "_id": "68385c47b83c90001210cd9b",
                "name": "Medium",
                "user": "6683ae18795e3b0012ec9a40",
                "customList": "68385c47b83c90001210cd98",
                "__v": 0
              }
            ]
          }
        ]
      }
    ]
  },
  "error": false,
  "message": "Success"
}

Response Interface

interface MediaCenterResponse {
  data: {
    start: number;
    count: number;
    nextStart: boolean | number;
    content: {
      id: string;
      name: string;
      type: number;
      description: string;
      url: string;
      pinnedToTop: boolean;
      size: number;
      creationTime: number;
      createdBy: {
        id: string;
        name: string;
        image: string;
        title: string;
      };
      tags: {
        _id: string;
        user: string;
        community: string;
        name: string;
        __v: number;
      }[];
      customList: {
        tags: string[];
        _id: string;
        customList: string;
        customListInfo: {
          _id: string;
          isMainFilter: boolean;
          name: string;
          community: string;
          user: string;
          __v: number;
        };
        tagInfo: {
          _id: string;
          name: string;
          user: string;
          customList: string;
          __v: number;
        }[];
      }[];
    }[];
  };
  error: boolean;
  message: string;
}

Response Field Descriptions

Key	Type	Description
data.start	number	Pagination offset from the start of the result set.
data.count	number	Number of results returned in this response.
data.nextStart	boolean or number	False if no more pages; otherwise, the offset for the next page.
data.content[].id	string	Unique identifier for the content item.
data.content[].name	string	Display name of the content.
data.content[].type	number	Type of media (e.g., image, video, etc.).
data.content[].description	string	Optional description of the content.
data.content[].url	string	URL to access the content.
data.content[].pinnedToTop	boolean	Whether the content is pinned.
data.content[].size	number	Size of the content in bytes.
data.content[].creationTime	number	Unix timestamp (ms) when the content was created.
data.content[].createdBy	object	Information about the user who created the content.
data.content[].tags[]	array	Array of tags associated with the content.
data.content[].customList[]	array	Custom metadata associated with the content, like priority or status.

Reference

🔗 Response Codes

Notes

The data[] query parameter is a list of media types. Its exact mappings (e.g., 0 = Image, 1 = Video) should be referenced from internal enum mappings.

Results can be filtered using tag or custom list-based filtering.

📁 Media Center Files#

Description#

Request Details#

Headers#

Query Parameters#

Sample Response#

Response Interface#

Response Field Descriptions#

Reference#

Notes#

Request

Responses