Navigation links let add-ons install links into a space's navigation on Cobot. The link leads to a page with an iframe that points to a URL within the external app.
The iframe's width responds to the window's width.
When passing an app_data parameter to this link it is passed on to the iframe.
POST https://:sudomain.cobot.me/api/navigation_links
Create a link.
POST https://co-up.cobot.me/api/navigation_links
Body:
{ "section": "admin/setup", "label": "My App", "iframe_url": "http://testapp.com/home" }
Response:
{ "section": "admin/setup", "label": "My App", "iframe_url": "http://testapp.com/home", "url": "https://co-up.cobot.me/api/navigation_links/cc7e75473a6911587b63d78f4e3f8eba", "user_url": "http://co-up.cobot.me/navigation_links/cc7e75473a6911587b63d78f4e3f8eba" }
Response status is 201 on success and 422 if you pass invalid parameters.
PATCH https://:sudomain.cobot.me/api/navigation_links/:id
Updates a link.
PATCH https://co-up.cobot.me/api/navigation_links/cc7e75473a6911587b63d78f4e3f8eba
Body:
{ "section": "admin/manage", "label": "My Updated App", "iframe_url": "http://testapp.com/app" }
Response:
{ "section": "admin/manage", "label": "My Updated App", "iframe_url": "http://testapp.com/app", "url": "https://co-up.cobot.me/api/navigation_links/cc7e75473a6911587b63d78f4e3f8eba", "user_url": "http://co-up.cobot.me/navigation_links/cc7e75473a6911587b63d78f4e3f8eba" }
Response status is 200 on success and 422 if you pass invalid parameters.
GET https://:subdomain.cobot.me/api/navigation_links
List an app's links.
URL:
GET https://co-up.cobot.me/api/navigation_links
Response:
[ { "section": "admin/setup", "label": "My App", "iframe_url": "http://testapp.com/home", "url": "https://co-up.cobot.me/api/navigation_links/cc7e75473a6911587b63d78f4e3f8eba", "user_url": "http://co-up.cobot.me/navigation_links/cc7e75473a6911587b63d78f4e3f8eba" } ]
DELETE https://:subdomain.cobot.me/api/navigation_links/:link_id
Delete a link.
URL:
DELETE https://co-up.cobot.me/api/navigation_links/cc7e75473a6911587b63d78f4e3f8eba
Returns an empty response with the status 204.