List my folders (labels)

GET

/openapi/folder

const url = 'https://open-api.replyco.com/openapi/folder';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://open-api.replyco.com/openapi/folder \
  --header 'Authorization: Bearer <token>'

Returns the folders (labels) available to the authenticated user, ordered as they appear in the app. Each folder has an id and a name.

Use this list to resolve folder ids returned by other endpoints to their names, for example the folderThreadsNumber[].folderId values from GET /openApi/thread/threadsCount, or to pick a folderId for POST /openApi/folderThreads/assignFoldersToThreads.

Authorizations

Bearer

Responses

200

Returns the list of folders (may be empty).

application/json

Array<object>

object

string format: uuid

name

string

nullable

Example

[
  {
    "id": "8a4c2e6f-1b9d-4e7a-b3c5-6f2d8a1e9c47",
    "name": "Returns"
  },
  {
    "id": "d5b9e3a7-2c6f-4d1b-8e4a-7f3c1b9d6e52",
    "name": "VIP customers"
  }
]

401

User is not authenticated or authorized.