> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metrics-man.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Metrics Receiver

> Send your application's metrics to this endpoint.

### Body

<ParamField header="Authorization" type="string" required>
  API access key generated for you application.
</ParamField>

<ParamField body="application_id" type="number" required>
  The unique ID of your application.
</ParamField>

<ParamField body="timestamp" type="number">
  Unix timestamp of creation of your metric. You can specify the granularity from seconds to nanoseconds. Just make sure it is as realtime as possible. If not specified, it will be auto filled.
</ParamField>

<ParamField body="creator" type="string" required>
  Name/ID of client/person who creating this metrics.
</ParamField>

<ParamField body="metric_id" type="string" required>
  The unique ID of your metric. You can pre-register this from console for easy querying.
</ParamField>

<ParamField body="tags" type="object">
  Key-value pair of string tags to assign to this metric.
</ParamField>

### Response

Response will be a plain string stating the status of request.

Response Status Codes and their probable meanings.

<Tabs>
  <Tab title="201">
    **Response**: submitted\
    **Status**: Your metric has been successfully recorded.
  </Tab>

  <Tab title="400">
    **Response**: error reading request body\
    **Status**: The request you send is of invalid format. Please cross check the data types and structure once.
  </Tab>

  <Tab title="401">
    **Response**: missing header 'Authorization'\
    **Status**: Your request did not contain the requried header and hence has been discarded.

    **Response**: unknown token\
    **Status**: The access key you send in header was not registered with us.
  </Tab>

  <Tab title="403">
    **Response**: unknown token\
    **Status**: Most likely the token you sent was not registered for your application, or, it simply does not exist.
  </Tab>

  <Tab title="500">
    **Response**: something went wrong\
    **Status**: Something went wrong from our side internally and we were not able to register your metric.
  </Tab>
</Tabs>

<ResponseExample>
  ```json Success Response theme={null}
  submitted
  ```

  ```json Error Response theme={null}
  something went wrong
  ```
</ResponseExample>