...
PRD - https://canvas.connectmyapps.com/api
GetMetaData
For getting of all provided APIs you need to send following request:
...
IP restriction
You can send Canvas REST API requests from any server by default.
If you want to restict access by IP addresses, then please provide your IP addresses to ConnectMyApps support for adding them into white list.
Authentication
For enabling of access to your organization data by REST API you need to set <API access> flag ON and copy provided Secret and Consumer keys. These keys are for access to Canvas REST API and you will use them in request headers. Do not share provided keys with anybody and keep them in safe place because they are not saved in Canvas and you will not be able to get them anymore.
Use following authentication request for checking your access keys:
Expand | ||
---|---|---|
| ||
Headers: Consumer:no header5D1AEF05263B497182992E324517FFFD0FED85FBEC2342B19CE02AB5ED62D6ED |
Expand | ||
---|---|---|
| ||
|
Describe
For getting of description about APIs parameters you can use following request:
|
Expand | ||
---|---|---|
| ||
Returned if the Consumer or SecretKey are incorrect or missing. |
APIs for help
There are two APIs, which describes list of all provided APIs
GetMetaData
For getting of all provided APIs you need to send following request:
Expand | ||
---|---|---|
| ||
Headers: no header |
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Describe
For getting of description about APIs parameters you can use following request:
Expand | ||
---|---|---|
| ||
Header: no header |
Expand | |||||
---|---|---|---|---|---|
| |||||
|
APIs for organization administration
Authentication
For enabling of access to your organization you need to set <API access> flag ON and copy provided Secret and Consumer keys. Do not share provided keys with anybody and keep them in safe place because they are not saved in Canvas and you will not be able to get them anymore.
Authentication request:
Accounts
Returns list of all active accounts in your organization
Expand | ||
---|---|---|
| ||
Headers: Consumer:5D1AEF05263B497182992E324517FFFD0FED85FBEC2342B19CE02AB5ED62D6ED SecretKey:a5ae515d-d53b-478c-90bd-060c616d37b7 ManagedAccountId:a4ba9a9b-ce81-4f06-81c6-032bf7d648f5
|
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
|
Expand | ||
---|---|---|
| ||
Returned if the Consumer or SecretKey are incorrect or missing. |
Refresh token
For refreshing of access token you need to send following request:
Expand | ||
---|---|---|
| ||
Headers: Consumer:5D1AEF05263B497182992E324517FFFD0FED85FBEC2342B19CE02AB5ED62D6ED |
Expand | ||
---|---|---|
| ||
|
Expand | ||
---|---|---|
| ||
Returned if the Consumer or SecretKey are incorrect or missing. |
Expand | ||
---|---|---|
| ||
Returned if refresh token is not found |
Delete authentication tokens
For deleting of authentication tokens you need to send following request:
Expand | ||
---|---|---|
| ||
Headers: Consumer:5D1AEF05263B497182992E324517FFFD0FED85FBEC2342B19CE02AB5ED62D6ED |
Expand | ||
---|---|---|
| ||
|
Expand | ||
---|---|---|
| ||
Returned if the Consumer or SecretKey are incorrect or missing. |
Expand | ||
---|---|---|
| ||
Returned if refresh token is not found |
Applications
Returns list of all third-part applications supported by CMA
Expand | ||
---|---|---|
| ||
Headers: Authorization:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIyMDAxZDFlZS1jOWUxLTRhMDctOTZkNi1hNTMyNGEzMjczY2UiLCJpc3MiOiJodHRwOi8vY2FudmFzdGVzdC5jb25uZWN0bXlhcHBzLmNvbSIsImlhdCI6MTY1MTA2ODk2OSwiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvZW1haWxhZGRyZXNzIjoibmF0YWxpYS55dWRuaWtvdmFAb3V0bG9vay5jb20iLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL3VzZXJkYXRhIjoiNmZhMTIyZTQtMGQ0Yy00YTFkLTg4NjktN2MwYTg2YTM3YmYxIiwiaHR0cDovL3NjaGVtYXMubWljcm9zb2Z0LmNvbS93cy8yMDA4LzA2L2lkZW50aXR5L2NsYWltcy9yb2xlIjoiQWRtaW4iLCJMb2dnZWRTdXBwb3J0ZWRCeUNtYSI6IlRydWUiLCJNYW5hZ2VkU3VwcG9ydGVkQnlDbWEiOiJUcnVlIiwiZXhwIjoxNjUxMDY5NTY5LCJhdWQiOiJjbWEtdXNlcnMifQ.v2Tbnw4bKuQSMAjtj36eVjrcMoE1vH93C6axpN9Y4wE |
Expand | |||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||
Code Block |
|
Account
Registers a new account and returns account Id. If account is created as inactive then an email to complete activation will be send by corresponded address.
Expand | |||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||
Body JSON structure: AddAccountApiDto Body example:
Headers: Consumer:5D1AEF05263B497182992E324517FFFD0FED85FBEC2342B19CE02AB5ED62D6ED SecretKey:a5ae515d-d53b-478c-90bd-060c616d37b7 ManagedAccountId:a4ba9a9b-ce81-4f06-81c6-032bf7d648f5
|
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Expand | ||
---|---|---|
| ||
Status Code: 401; Unauthorized |
Expand | ||
---|---|---|
| ||
|
Expand | ||
---|---|---|
| ||
|
Application APIs
Applications
Returns list of all third-part applications supported by CMA
Expand | ||
---|---|---|
| ||
Headers: Consumer:5D1AEF05263B497182992E324517FFFD0FED85FBEC2342B19CE02AB5ED62D6ED SecretKey:a5ae515d-d53b-478c-90bd-060c616d37b7 ManagedAccountId:a4ba9a9b-ce81-4f06-81c6-032bf7d648f5
|
Expand | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Expand | ||
---|---|---|
| ||
Returned if the Authorization is incorrect or missing. |
RegApplications
Returns account registerred applications
Expand | ||
---|---|---|
| ||
Headers: Consumer:5D1AEF05263B497182992E324517FFFD0FED85FBEC2342B19CE02AB5ED62D6ED SecretKey:a5ae515d-d53b-478c-90bd-060c616d37b7 ManagedAccountId:a4ba9a9b-ce81-4f06-81c6-032bf7d648f5
|
Expand | |||||
---|---|---|---|---|---|
| |||||
|
RegApplication
Registers a new application and returns Id
Expand | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
Body JSON structure: AddRegApplicationApiDto Body example 1:
Body example 2:
Headers: Consumer:5D1AEF05263B497182992E324517FFFD0FED85FBEC2342B19CE02AB5ED62D6ED SecretKey:a5ae515d-d53b-478c-90bd-060c616d37b7 ManagedAccountId:a4ba9a9b-ce81-4f06-81c6-032bf7d648f5
|
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Expand | ||
---|---|---|
| ||
Status Code: 401; Unauthorized |
Expand | ||
---|---|---|
| ||
|
Workflow APIs
WorkflowTemplates
Returns list of workflow templates provided by CMA and your organization
Expand | ||
---|---|---|
| ||
Headers: Consumer:5D1AEF05263B497182992E324517FFFD0FED85FBEC2342B19CE02AB5ED62D6ED SecretKey:a5ae515d-d53b-478c-90bd-060c616d37b7 ManagedAccountId:a4ba9a9b-ce81-4f06-81c6-032bf7d648f5
|
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Workflows
Returns list of registered workflows
Expand | ||
---|---|---|
| ||
Headers: Consumer:5D1AEF05263B497182992E324517FFFD0FED85FBEC2342B19CE02AB5ED62D6ED SecretKey:a5ae515d-d53b-478c-90bd-060c616d37b7 ManagedAccountId:a4ba9a9b-ce81-4f06-81c6-032bf7d648f5
|
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Workflow (get)
Returns registered workflow by id
Expand | ||
---|---|---|
| ||
Headers: Consumer:5D1AEF05263B497182992E324517FFFD0FED85FBEC2342B19CE02AB5ED62D6ED SecretKey:a5ae515d-d53b-478c-90bd-060c616d37b7 ManagedAccountId:a4ba9a9b-ce81-4f06-81c6-032bf7d648f5
|
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Workflow (post)
Registers a new workflow based on template
Expand | |||||||
---|---|---|---|---|---|---|---|
| |||||||
Body JSON structure: AddWorkflowApiDto Body example:
Headers: Consumer:5D1AEF05263B497182992E324517FFFD0FED85FBEC2342B19CE02AB5ED62D6ED SecretKey:a5ae515d-d53b-478c-90bd-060c616d37b7 ManagedAccountId:a4ba9a9b-ce81-4f06-81c6-032bf7d648f5
|
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Expand | ||
---|---|---|
| ||
Status Code: 401; Unauthorized |
Expand | ||
---|---|---|
| ||
|
DeleteWorkflow
Removes workflow by Id
Expand | ||
---|---|---|
| ||
Headers: Consumer:5D1AEF05263B497182992E324517FFFD0FED85FBEC2342B19CE02AB5ED62D6ED SecretKey:a5ae515d-d53b-478c-90bd-060c616d37b7 ManagedAccountId:a4ba9a9b-ce81-4f06-81c6-032bf7d648f5
|
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Expand | ||
---|---|---|
| ||
Status Code: 401; Unauthorized |
RunWorkflow
Runs workflow or needed blocks
Expand | |||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||
Body JSON structure: RunMetadataApiDto Body example 1 for running by default:
Body example 2 for running from start till block #2:
Body example 3 for running of blocks between #2 and #4:
Headers: Consumer:5D1AEF05263B497182992E324517FFFD0FED85FBEC2342B19CE02AB5ED62D6ED SecretKey:a5ae515d-d53b-478c-90bd-060c616d37b7 ManagedAccountId:a4ba9a9b-ce81-4f06-81c6-032bf7d648f5
|
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Expand | ||
---|---|---|
| ||
Status Code: 401; Unauthorized |
WorkflowScheduler
Sets ON/OFF a workflow scheduler. The scheduler frequency should be set in CRON format.
Expand | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
Body JSON structure: UpdateWorkfowSchedulerApiDto Body example:
Headers: Consumer:5D1AEF05263B497182992E324517FFFD0FED85FBEC2342B19CE02AB5ED62D6ED SecretKey:a5ae515d-d53b-478c-90bd-060c616d37b7 ManagedAccountId:a4ba9a9b-ce81-4f06-81c6-032bf7d648f5
|
Expand | |||||||
---|---|---|---|---|---|---|---|
| |||||||
or
|
Expand | ||
---|---|---|
| ||
Returned if the Authorization is incorrect or missing.Status Code: 401; Unauthorized |