Create a new post (idea) in a specified space. The post can include file(s). To upload a file:
- Get the upload URL from /api/files/getuploadurl and note the fileKey value from the response.
- Use the fileKey from step one as the fileId in the request body.
URL Parameters
Name | Description | Location | Required | Default Value |
---|
spaceId | Unique identifier of the space. | path | Yes | |
notify | Boolean value that determines whether members are notified. | query | No | true |
Body Parameters
Name | Description | JSON type | Required | Default Value |
---|
content | Object with task properties.- bodyText: (string) message text to send
- data: (array) array of objects representing attached files
- fileId: (string) fileKey from /files/getuploadurl
- fileSize: (int) size of file in bytes
- fileType: (string) 'image', 'video', 'audio', or (default) 'document'
- name: (string) file name
- provider: (string) 'native'
- providerFileType: (string) MIME type
- thumbnailFile: (string) fileKey of thumbnail from /files/getuploadurl
- description: (string) optional description.
| object | Yes | |
Authentication
JwtAuthenticator, Oauth2Authenticator, AnonymousAuthenticator
Authorization
PERM_TOPIC_UPDATE
Example Request
URL
POST https://spacesapis.avayacloud.com/api/spaces/{spaceId}/ideas
Headers
Authorization: "jwt eyJhbGciOiJSUzI1NiIsIdfgdfgnR5cCI6IkpXVCJ9.eyJ1c2VyX2lkX3NpZyI6ImxPWHpxNzVzR3J3X0xwWEMyRGRMakhyYXJlWVhyTzFMdEZHZkhkOWNkTXciLCJwcm9kdWN0X3R5cGUiOiJhY2NvdW50cyIsImxhc3R1cGRhdGV0aW1lIjoiMjAxNy0wMS0zMFQxMzo1ODo0Ny4yMDYiLCJpc3MiOiJ6YW5nLmlvIiwicHVibGlja2V5aWQiOiJhZ3h6Zm05dVpYTnVZVEl3TVRSeUdnc1NEVWRLZDNSUWRXSnNhV05MWlhrdfgdWdJQ2dsUEtFakFvTSIsImV4cCI6MTQ5NTM5MTIwMywidXNlcl9pZCI6ImFneHpmbTl1WlhOdVlUSXdNVFJ5RVFzU0JGVnpaWElZZ0lEQXMtX25fUW9NIiwidmVyIjoiMi4wIn0.SqZpw1uPIebqW3qlDsm0-DWYFKEH0SgPwtD-tSESWOF-5hLkZMqJH28ooWux2S7s9riIew7pTVPnZpTgJa5zHcEAG0gXSEJVOqmpGp_4ufM8YtZoZMpBFjyAkwyAt-ILkGUYIo0GU5WyzMPLV8YLXfgdfgOgkE2MGGOajBkjPmC2Db3pA0D0M9k-21EL1gwWBC5YIq0PDAkgulegwl6khRmB8irJQ-dfg-d-KV9eYfFpsCdJKRGzSfqg"
Or
Authorization: "bearer f746696f5de4528u128ae2f274eea253e8a7943a"
Body
{
"content": {
"bodyText": "idea with a file upload",
"description": "this is a idea with a file uploaded",
"data": [{
"fileId": "ec6b2632-c3ae-404d-a6b4-c04bcc49b5ea",
"fileSize": 3239,
"fileType": "document",
"icon": "",
"name": "env2 (1)",
"provider": "native",
"providerFileType": ""
}]
}
}
Example Response
{
"data": [
{
"sender": {
"_id": "5efc5417aa4a347af96de290",
"type": "user",
"username": "example@gmail.com",
"displayname": "test test",
"picture_url": "https://storage.googleapis.com/onesna/pictures/pfpic_example_29bef4a8-99b0-4901-86c7-567a64d9dcbb"
},
"content": {
"endTime": null,
"mediaMode": "audio",
"virtualEndTime": null,
"meetingStatus": "active",
"bodyText": "idea with a file upload",
"description": "this is a idea with a file uploaded",
"data": [
{
"metaData": {
"paging": 0,
"prvwProvd": "gcs",
"stgeProvd": "gcs"
},
"keywords": [],
"convertStatus": 0,
"convertStart": null,
"nextSchedule": null,
"pages": 0,
"recordingId": null,
"type": null,
"provider": "native",
"providerFileType": "",
"fileType": "document",
"name": "env2 (1)",
"fileId": "ec6b2632-c3ae-404d-a6b4-c04bcc49b5ea",
"icon": "",
"thumbnail": "",
"description": "",
"previewFile": "",
"fileSize": 3239,
"thumbnailFile": "",
"path": "https://storage.googleapis.com/spaces2020/logan%2Fec6b2632-c3ae-404d-a6b4-c04bcc49b5ea?GoogleAccessId=spaces2020@spaces-2018.iam.gserviceaccount.com&Expires=1596639567&Signature=eH0IxjSLLTcwN85e%2Bk1G78TdO%2FmOPJOxdVtoa4Taxd9zJBJ3vgAn1xOKY0YoqxSdN%2FfXAjYQv6e3EHR6zs3tJ%2B34NUq1wElIBeC2FEXaZDntwqyWLMn9gmIPR%2Bo5%2BCzAWr10dm4rPIZIGD8G%2FwjAZa13AyC7YVh6D8%2BZ%2FnbJaO5dY55mGdtJRYomIYKmQ6lLDUhumCKBOGBM8TefCIw6n8zuoFfx4ndKUrArAfD9kN1gtZawXJouoJM8YwdOuavGf0fa1lOgHGxIIIWMf3qfL9iOiBRoblrEwYwJSgo8odvbz48ViaysPFYLJ9Lkq2FTA%2FFzWRYBb8djs8CszSwoaA%3D%3D&response-content-disposition=attachment%3B%20filename%3D%22env2%20(1)%22"
}
],
"status": "pending",
"dueDate": "2020-08-05T12:59:26.731Z",
"startTime": "2020-08-05T12:59:26.734Z",
"recordings": []
},
"chatCount": 0,
"likeCount": 0,
"status": 0,
"_id": "5f2aad2e58d92a3e7d6563fa",
"category": "idea",
"topicId": "5f2276a8fe5c16664f01c5be",
"created": "2020-08-05T12:59:26.728Z",
"modified": "2020-08-05T12:59:26.728Z"
}
]
}