Skip to content

CollectionFoldersService.md

Latest commit

 

History

History
195 lines (139 loc) · 6.75 KB

CollectionFoldersService.md

File metadata and controls

195 lines (139 loc) · 6.75 KB
Raw

CollectionFoldersService

A list of all methods in the CollectionFoldersService service. Click on the method name to view detailed information about that method.

Methods Description
getFolderComments Gets all comments left by users in a folder.
createFolderComment Creates a comment on a folder. To create a reply on an existing comment, include the threadId property in the request body. Note: This endpoint accepts a max of 10,000 characters.
updateFolderComment Updates a comment on a folder. Note: This endpoint accepts a max of 10,000 characters.
deleteFolderComment Deletes a comment from a folder. On success, this returns an HTTP 204 No Content response. Note: Deleting the first comment of a thread deletes all the comments in the thread.

getFolderComments

Gets all comments left by users in a folder.

  • HTTP Method: GET
  • Endpoint: /collections/{collectionId}/folders/{folderId}/comments

Parameters

Name Type Required Description
collectionId string ✅ The collection's unique ID.
folderId string ✅ The folder's unique ID.

Return Type

CommentResponseObject

Example Usage Code Snippet

import { PostmanApi } from '@postman/api-sdk';

(async () => {
  const postmanApi = new PostmanApi({
    apiKey: 'YOUR_API_KEY',
  });

  const data = await postmanApi.collectionFolders.getFolderComments(
    '12345678-12ece9e1-2abf-4edc-8e34-de66e74114d2',
    '12345678-65a99e60-8e0a-4b6e-b79c-7d8264cc5caa',
  );

  console.log(data);
})();

createFolderComment

Creates a comment on a folder. To create a reply on an existing comment, include the threadId property in the request body. Note: This endpoint accepts a max of 10,000 characters.

  • HTTP Method: POST
  • Endpoint: /collections/{collectionId}/folders/{folderId}/comments

Parameters

Name Type Required Description
body CommentCreate ✅ The request body.
collectionId string ✅ The collection's unique ID.
folderId string ✅ The folder's unique ID.

Return Type

CommentUpdatedCreatedObject

Example Usage Code Snippet

import { CommentCreate, PostmanApi, TaggedUsers, UserName, UserNameType } from '@postman/api-sdk';

(async () => {
  const postmanApi = new PostmanApi({
    apiKey: 'YOUR_API_KEY',
  });

  const userNameType = UserNameType.USER;

  const userName: UserName = {
    type: userNameType,
    id: '87654321',
  };

  const taggedUsers: TaggedUsers = {
    _userName_: userName,
  };

  const commentCreate: CommentCreate = {
    body: 'This is an example.',
    threadId: 12345,
    tags: taggedUsers,
  };

  const data = await postmanApi.collectionFolders.createFolderComment(
    '12345678-12ece9e1-2abf-4edc-8e34-de66e74114d2',
    '12345678-65a99e60-8e0a-4b6e-b79c-7d8264cc5caa',
    commentCreate,
  );

  console.log(data);
})();

updateFolderComment

Updates a comment on a folder. Note: This endpoint accepts a max of 10,000 characters.

  • HTTP Method: PUT
  • Endpoint: /collections/{collectionId}/folders/{folderId}/comments/{commentId}

Parameters

Name Type Required Description
body CommentUpdate ✅ The request body.
collectionId string ✅ The collection's unique ID.
folderId string ✅ The folder's unique ID.
commentId number ✅ The comment's ID.

Return Type

CommentUpdatedCreatedObject

Example Usage Code Snippet

import { CommentUpdate, PostmanApi, TaggedUsers, UserName, UserNameType } from '@postman/api-sdk';

(async () => {
  const postmanApi = new PostmanApi({
    apiKey: 'YOUR_API_KEY',
  });

  const userNameType = UserNameType.USER;

  const userName: UserName = {
    type: userNameType,
    id: '87654321',
  };

  const taggedUsers: TaggedUsers = {
    _userName_: userName,
  };

  const commentUpdate: CommentUpdate = {
    body: 'This is an example.',
    tags: taggedUsers,
  };

  const data = await postmanApi.collectionFolders.updateFolderComment(
    '12345678-12ece9e1-2abf-4edc-8e34-de66e74114d2',
    '12345678-65a99e60-8e0a-4b6e-b79c-7d8264cc5caa',
    46814,
    commentUpdate,
  );

  console.log(data);
})();

deleteFolderComment

Deletes a comment from a folder. On success, this returns an HTTP 204 No Content response. Note: Deleting the first comment of a thread deletes all the comments in the thread.

  • HTTP Method: DELETE
  • Endpoint: /collections/{collectionId}/folders/{folderId}/comments/{commentId}

Parameters

Name Type Required Description
collectionId string ✅ The collection's unique ID.
folderId string ✅ The folder's unique ID.
commentId number ✅ The comment's ID.

Example Usage Code Snippet

import { PostmanApi } from '@postman/api-sdk';

(async () => {
  const postmanApi = new PostmanApi({
    apiKey: 'YOUR_API_KEY',
  });

  const data = await postmanApi.collectionFolders.deleteFolderComment(
    '12345678-12ece9e1-2abf-4edc-8e34-de66e74114d2',
    '12345678-65a99e60-8e0a-4b6e-b79c-7d8264cc5caa',
    46814,
  );

  console.log(data);
})();