Mackerel API Documents (v0)


  • POST/PUT input should be JSON (application/json) valid against RFC. The success response is in JSON (application/json) as well.
  • X-Api-Key header (required): the API key of the organization to which targeted hosts and services belong.
    • You can see your API keys in the Dashboard.
    • Each API key's Read and Write permissions can be configured.
      • API keys that only have Read permission cannot be used for APIs that require Write permission.


Data types

  • Host ID <hostId>
    • This is a string that is provided by Mackerel when a host is registered. It is used to distinguish and identify each unique host the agent is running on.
  • Service name <serviceName>
    • This is the name of a service registered with Mackerel.

Need even more help?

Send us an email at We'll get back to you right away.

Email Us


This is the page containing Mackerel's instructional documents.