[ Web Proxy ]
URL:
Viewing: https://docs.getmesa.com/for-developers/admin-api [Back]  [Original]

Admin API | MESA Docs
[] []
[] []
On this page
For the complete documentation index, see llms.txt. This page is also available as Markdown.
Copy
On this page
  1. For developers

Admin API

The MESA Admin API allows you to programmatically interact with MESA. All requests must include your API key which can be found in My Account > Connections.

Key
Value

{url}

https://api.getmesa.com/v1

{uuid}

Your stores unique identifier: {{uuid}}.myshopify.com

Workflows

Get list of automations

gethttp://{{url}}/admin/{uuid}/automations.json

Returns a list of automations for a store, sorted by most recently created first.

Path parameters
uuidstringRequired
Header parameters
x-api-keystringOptionalExample: {{api_key}}
Body
application/json
objectOptionalExample: {"automations":[{"uuid":"my-store","created_by":"","key":"etsy_order_send_to_google_sheets","name":"Send Etsy orders to Google Sheets","version":"1.0.0","template":"etsy/order/send_to_google_sheets","description":"Consolidate your Etsy orders in Google Sheets for real-time tracking and improved order management. This template will automatically send Etsy order details to a Google Sheets spreadsheet when a customer completes an order on Etsy.","video":"","is_premium":false,"tags":[],"source":"","destination":"","enabled":false,"did_complete":false,"logging":true,"debug":false,"setup":"incomplete","seconds":135,"notifications":{"enabled":false,"emails":["example@theshoppad.com"]},"_id":"65f1fdbbb54ac273e806026b","created_at":"Mar 13 2020","updated_at":"Mar 13 2024"}]}
Responses
200

Successful response

application/json
get/admin/{uuid}/automations.json
HTTP
Copy
GET /admin/{uuid}/automations.json HTTP/1.1
Host: {{url}}
Content-Type: application/json
Accept: */*
Content-Length: 776

{
  "automations": [
    {
      "uuid": "my-store",
      "created_by": "",
      "key": "etsy_order_send_to_google_sheets",
      "name": "Send Etsy orders to Google Sheets",
      "version": "1.0.0",
      "template": "etsy/order/send_to_google_sheets",
      "description": "Consolidate your Etsy orders in Google Sheets for real-time tracking and improved order management. This template will automatically send Etsy order details to a Google Sheets spreadsheet when a customer completes an order on Etsy.",
      "video": "",
      "is_premium": false,
      "tags": [],
      "source": "",
      "destination": "",
      "enabled": false,
      "did_complete": false,
      "logging": true,
      "debug": false,
      "setup": "incomplete",
      "seconds": 135,
      "notifications": {
        "enabled": false,
        "emails": [
          "example@theshoppad.com"
        ]
      },
      "_id": "65f1fdbbb54ac273e806026b",
      "created_at": "Mar 13 2020",
      "updated_at": "Mar 13 2024"
    }
  ]
}
200

Successful response

Get the mesa.json file for an automation

gethttp://{{url}}/admin/{uuid}/automations/{automation_key}.json
Path parameters
uuidstringRequired
automation_keystringRequired
Header parameters
x-api-keystringOptionalExample: {{api_key}}
Content-TypestringOptionalExample: application/json
Responses
200

Successful response

application/json
get/admin/{uuid}/automations/{automation_key}.json
HTTP
Copy
GET /admin/{uuid}/automations/{automation_key}.json HTTP/1.1
Host: {{url}}
Accept: */*
200

Successful response

Create or update an Automation configuration

posthttp://{{url}}/admin/{uuid}/automations.json

Updates the Inputs, Outputs, Credentials and Storage for an automation. Updating scripts requires separate calls to the Script POST endpoing for each script.

Path parameters
uuidstringRequired
Header parameters
x-api-keystringOptionalExample: {{api_key}}
Body
application/json
objectOptionalExample: {"key":"","name":"","config":{"inputs":[],"outputs":[],"secrets":[],"storage":[],"files":[],"overwrite":false}}
Responses
200

Successful response

application/json
post/admin/{uuid}/automations.json
HTTP
Copy
POST /admin/{uuid}/automations.json HTTP/1.1
Host: {{url}}
Content-Type: application/json
Accept: */*
Content-Length: 111

{
  "key": "",
  "name": "",
  "config": {
    "inputs": [],
    "outputs": [],
    "secrets": [],
    "storage": [],
    "files": [],
    "overwrite": false
  }
}
200

Successful response

Uninstall an Automation

deletehttp://{{url}}/admin/{uuid}/automations/{automation_key}.json
Path parameters
uuidstringRequired
automation_keystringRequiredExample: new_workflow_1
Header parameters
x-api-keystringOptionalExample: {{api_key}}
Responses
200

Successful response

application/json
delete/admin/{uuid}/automations/{automation_key}.json
HTTP
Copy
DELETE /admin/{uuid}/automations/{automation_key}.json HTTP/1.1
Host: {{url}}
Accept: */*
200

Successful response

Connections

Get a list of Credentials

gethttp://{{url}}/admin/{uuid}/{automation_key}/credentials.json

Returns a list of all Credential names. Credential values are not available via the Admin API.

Path parameters
uuidstringRequired
automation_keystringRequired
Header parameters
x-api-keystringOptionalExample: {{api_key}}
Responses
200

Successful response

application/json
get/admin/{uuid}/{automation_key}/credentials.json
HTTP
Copy
GET /admin/{uuid}/{automation_key}/credentials.json HTTP/1.1
Host: {{url}}
Accept: */*
200

Successful response

Create a new Credential

posthttp://{{url}}/admin/{uuid}/{automation_key}/credentials.json
Path parameters
uuidstringRequired
automation_keystringRequiredExample: new_workflow_1
Header parameters
x-api-keystringOptionalExample: {{api_key}}
Body
application/json
objectOptionalExample: {"secret":{"key":"mysecret","value":"myvalue"}}
Responses
200

Successful response

application/json
post/admin/{uuid}/{automation_key}/credentials.json
HTTP
Copy
POST /admin/{uuid}/{automation_key}/credentials.json HTTP/1.1
Host: {{url}}
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "secret": {
    "key": "mysecret",
    "value": "myvalue"
  }
}
200

Successful response

Update an existing Credential

puthttp://{{url}}/admin/{uuid}/{automation_key}/credentials/{credential_key}.json
Path parameters
uuidstringRequired
automation_keystringRequiredExample: new_workflow_1
secret_keystringRequired
Header parameters
x-api-keystringOptionalExample: {{api_key}}
Body
application/json
objectOptionalExample: {"secret":{"value":"myvalue"}}
Responses
200

Successful response

application/json
put/admin/{uuid}/{automation_key}/credentials/{credential_key}.json
HTTP
Copy
PUT /admin/{uuid}/{automation_key}/credentials/{credential_key}.json HTTP/1.1
Host: {{url}}
Content-Type: application/json
Accept: */*
Content-Length: 30

{
  "secret": {
    "value": "myvalue"
  }
}
200

Successful response

Delete a Credential

deletehttp://{{url}}/admin/{uuid}/{automation_key}/credentials/{credential_key}.json
URL Parameters
Key Description
{{uuid}} Your store's unique identifier: {{uuid}}.myshopify.com.
{{automation_key}} The automation's key. Example: shoppad/mesa-templates/shopify/draft-order/remove.
{{secret_key}} The key of the Credential, which can be obtained from the Credentials tab of the Mesa Dashboard.
Path parameters
uuidstringRequired
automation_keystringRequiredExample: new_workflow_1
secret_keystringRequiredExample: googlesheets_1
Header parameters
x-api-keystringOptionalExample: {{api_key}}
Responses
200

Successful response

application/json
delete/admin/{uuid}/{automation_key}/credentials/{credential_key}.json
HTTP
Copy
DELETE /admin/{uuid}/{automation_key}/credentials/{credential_key}.json HTTP/1.1
Host: {{url}}
Accept: */*
200

Successful response

Storage

Get a list of all Storage items

gethttp://{{url}}/admin/{uuid}/{automation_key}/storage.json

Note: Storage has been deprecated in favor of Data by MESA. Returns a list of all Storage item names. To get a Storage value, call GET {{url}}/admin/{{uuid}}/storage/{{storage_name}}.json

Path parameters
uuidstringRequired
automation_keystringRequiredExample: new_workflow_1
Header parameters
x-api-keystringOptionalExample: {{api_key}}
Responses
200

Successful response

application/json
get/admin/{uuid}/{automation_key}/storage.json
HTTP
Copy
GET /admin/{uuid}/{automation_key}/storage.json HTTP/1.1
Host: {{url}}
Accept: */*
200

Successful response

Create a new Storage item

posthttp://{{url}}/admin/{uuid}/{automation_key}/storage.json

Note: Storage has been deprecated in favor of Data by MESA. Value parameter can be a string, an object, an array, or a boolean value.

Path parameters
uuidstringRequired
automation_keystringRequiredExample: new_workflow_1
Header parameters
x-api-keystringOptionalExample: {{api_key}}
Body
application/json
objectOptionalExample: {"storage":{"key":"{{storage_key}}","value":{"mykey":"myvalue"}}}
Responses
200

Successful response

application/json
post/admin/{uuid}/{automation_key}/storage.json
HTTP
Copy
POST /admin/{uuid}/{automation_key}/storage.json HTTP/1.1
Host: {{url}}
Content-Type: application/json
Accept: */*
Content-Length: 65

{
  "storage": {
    "key": "{{storage_key}}",
    "value": {
      "mykey": "myvalue"
    }
  }
}
200

Successful response

Get the value of a Storage item

gethttp://{{url}}/admin/{uuid}/{automation_key}/storage/{storage_key}.json

Note: Storage has been deprecated in favor of Data by MESA.

Path parameters
uuidstringRequired
automation_keystringRequiredExample: new_workflow_1
storage_keystringRequiredExample: storage_1
Header parameters
x-api-keystringOptionalExample: {{api_key}}
Responses
200

Successful response

application/json
get/admin/{uuid}/{automation_key}/storage/{storage_key}.json
HTTP
Copy
GET /admin/{uuid}/{automation_key}/storage/{storage_key}.json HTTP/1.1
Host: {{url}}
Accept: */*
200

Successful response

Update an existing Storage item

puthttp://{{url}}/admin/{uuid}/{automation_key}/storage/{storage_key}.json

Note: Storage has been deprecated in favor of Data by MESA. Value parameter can be a string, an object, an array, or a boolean value.

Path parameters
uuidstringRequired
automation_keystringRequiredExample: new_workflow_1
storage_keystringRequiredExample: storage_1
Header parameters
x-api-keystringOptionalExample: {{api_key}}
Body
application/json
objectOptionalExample: {"storage":{"value":"mynewstringvalue"}}
Responses
200

Successful response

application/json
put/admin/{uuid}/{automation_key}/storage/{storage_key}.json
HTTP
Copy
PUT /admin/{uuid}/{automation_key}/storage/{storage_key}.json HTTP/1.1
Host: {{url}}
Content-Type: application/json
Accept: */*
Content-Length: 40

{
  "storage": {
    "value": "mynewstringvalue"
  }
}
200

Successful response

Deletes a Storage item

deletehttp://{{url}}/admin/{uuid}/{automation_key}/storage/{storage_key}.json

Note: Storage has been deprecated in favor of Data by MESA. Delete a Storage item.

Path parameters
uuidstringRequired
automation_keystringRequiredExample: new_workflow_1
storage_keystringRequiredExample: storage_1
Header parameters
x-api-keystringOptionalExample: {{api_key}}
Responses
200

Successful response

application/json
delete/admin/{uuid}/{automation_key}/storage/{storage_key}.json
HTTP
Copy
DELETE /admin/{uuid}/{automation_key}/storage/{storage_key}.json HTTP/1.1
Host: {{url}}
Accept: */*
200

Successful response

Scripts

Get a list of Scripts

gethttp://{{url}}/admin/{uuid}/{automation_key}/scripts.json

Returns a list of all Scripts, including the Script code.

Path parameters
uuidstringRequired
Header parameters
x-api-keystringOptionalExample: {{api_key}}
Responses
200

Successful response

application/json
get/admin/{uuid}/{automation_key}/scripts.json
HTTP
Copy
GET /admin/{uuid}/{automation_key}/scripts.json HTTP/1.1
Host: {{url}}
Accept: */*
200

Successful response

Create or update a Script

posthttp://{{url}}/admin/{uuid}/{automation_key}/scripts.json
Path parameters
uuidstringRequired
automation_keystringRequiredExample: new_workflow_1
Header parameters
x-api-keystringOptionalExample: {{api_key}}
Body
application/json
objectOptionalExample: {"script":{"filename":"myscript.js","code":"// Javascript goes here"}}
Responses
200

Successful response

application/json
post/admin/{uuid}/{automation_key}/scripts.json
HTTP
Copy
POST /admin/{uuid}/{automation_key}/scripts.json HTTP/1.1
Host: {{url}}
Content-Type: application/json
Accept: */*
Content-Length: 70

{
  "script": {
    "filename": "myscript.js",
    "code": "// Javascript goes here"
  }
}
200

Successful response

Delete a Script

deletehttp://{{url}}/admin/{uuid}/{automation_key}/scripts.json
Path parameters
uuidstringRequired
Header parameters
x-api-keystringOptionalExample: {{api_key}}
Responses
200

Successful response

application/json
delete/admin/{uuid}/{automation_key}/scripts.json
HTTP
Copy
DELETE /admin/{uuid}/{automation_key}/scripts.json HTTP/1.1
Host: {{url}}
Accept: */*
200

Successful response

Testing

Run a test

posthttp://{{url}}/admin/{uuid}/{automation_key}/triggers/{trigger_key}/test.json

Trigger a test with a specific that is passed as the payload body parameter. To test an actual payload, consider running a test in the UI and replaying the task with POST replay.json.

Path parameters
uuidstringRequired
automation_keystringRequiredExample: new_workflow_1
trigger_keystringRequiredExample: shopify_1
Header parameters
x-api-keystringOptionalExample: {{api_key}}
Body
application/json
objectOptionalExample: {"payload":{}}
Responses
200

Successful response

application/json
post/admin/{uuid}/{automation_key}/triggers/{trigger_key}/test.json
HTTP
Copy
POST /admin/{uuid}/{automation_key}/triggers/{trigger_key}/test.json HTTP/1.1
Host: {{url}}
Content-Type: application/json
Accept: */*
Content-Length: 14

{
  "payload": {}
}
200

Successful response

Tasks

Replay a task

posthttp://{{url}}/admin/{uuid}/tasks/{task_id}/replay.json

Restart the execution of the workflow from a specific task. Data from all steps previous to this task in the original workflow run will be available.

Path parameters
uuidstringRequired
task_idstringRequired

To find the Task ID, click on a step in the Activity List > Request Details, and copy the last ID hash from the URL

Example: 65f3459357ca4e809608c8fb
Header parameters
x-api-keystringOptionalExample: {{api_key}}
Body
Responses
200

Successful response

application/json
post/admin/{uuid}/tasks/{task_id}/replay.json
HTTP
Copy
POST /admin/{uuid}/tasks/{task_id}/replay.json HTTP/1.1
Host: {{url}}
Accept: */*
200

Successful response

Templates

Install a template from the Mesa Template library

posthttp://{{url}}/admin/{uuid}/templates/install.json
Path parameters
uuidstringRequired
Header parameters
x-api-keystringOptionalExample: {{api_key}}
Body
application/json
objectOptionalExample: {"template":"shoppad/mesa-templates/tests/kitchen-sink","force":true}
Responses
200

Successful response

application/json
post/admin/{uuid}/templates/install.json
HTTP
Copy
POST /admin/{uuid}/templates/install.json HTTP/1.1
Host: {{url}}
Content-Type: application/json
Accept: */*
Content-Length: 69

{
  "template": "shoppad/mesa-templates/tests/kitchen-sink",
  "force": true
}
200

Successful response

Logs

Get the 50 most recent log entries

gethttp://{{url}}/admin/{uuid}/logs.json

Returns a list of the most recent 50 log entries.

Path parameters
uuidstringRequired
Header parameters
x-api-keystringOptionalExample: {{api_key}}
Responses
200

Successful response

application/json
get/admin/{uuid}/logs.json
HTTP
Copy
GET /admin/{uuid}/logs.json HTTP/1.1
Host: {{url}}
Accept: */*
200

Successful response

Last updated 10 months ago


Web Proxy Viewer  |  New URL  |  Original Page