☰
Create a new Folder
Views
POST: https://{env}-api.xebo.ai/v3/survey-management/surveys/folders
Content-Type: application/json type: Bearer type
token: <access token> granted from login API
Or
x-api-key: <api key copied from the platform>
Content-Type: application/jsonRequest Body
{ "name": "Folder 1" } | Key | Type | Mandatory | Description |
| name | string | yes | Name of the folder to be created |
Request Sample
curl --location 'https://az4-api.xebo.ai/v3/survey-management/surveys/folders' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9' \ --data '{ "name": "Folder 1" } '
var data = JSON.stringify({ "name": "Folder 1" }); var xhr = new XMLHttpRequest(); xhr.withCredentials = true; xhr.addEventListener("readystatechange", function() { if(this.readyState === 4) { console.log(this.responseText); } }); xhr.open("POST", "https://az4-api.xebo.ai/v3/survey-management/surveys/folders"); xhr.setRequestHeader("Content-Type", "application/json"); xhr.setRequestHeader("Authorization", "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9"); xhr.send(data);
Responses
{ "data": { "name": "Folder 1", "uuid": "89f3622e-0f86-4ddc-a4b2-67d44c9a9665", "surveys": { "list": [], "count": 0 } } }
{
"success":false,
"code":401,
"status":"Unauthorized",
"error":"AUTHENTICATION_ERROR",
"message":"The authorization token was not provided",
}
{
"error": {
"name": "Internal Server Error",
"message": "We were not able to process your request"
}
}
Note: Please do not share your tokens in publicly accessible areas or to anyone. Also, this token generated is valid for 24 hours only. After its expiry, you can regenerate the access token from the same API endpoint by passing the username and password or from the refresh token API with the help of refresh token.