Sign in

v10

latestOpenAPI 3.0.1raw.githubusercontent.com2025-12-033223581.2 MB
Measurements

Generate Upload URL

Generate a URL for uploading a file containing measurements to the platform in preparation for the measurements it contains to be ingested:

  • An upload URL is returned together with an upload job id:
  • You can then upload your data measurements file using a PUT request using the returned upload URL as the endpoint.
  • You can use the returned upload job id with other calls to the File Upload Service for any follow-up or troubleshooting.

Important:

  • The contentLength request parameter is required.
  • The upload URL is time limited - it is valid for one minute.

Part of the file upload service for submitting measurements data files.

post/organizations/{orgId}/fileuploads/measurements/generateUploadUrl

Path parameters

orgIdstring required

UUID of the Organization. The Organization represents your company as a direct customer of the m3ter platform.

Request body

fileNamestring required

The name of the measurements file to be uploaded.

contentType'application/json' | 'text/json' required

The media type of the entity body sent, for example: "contentType":"text/json".

NOTE: Currently only a JSON formatted file type is supported by the File Upload Service.

contentLengthinteger required

The size of the body in bytes. For example: "contentLength": 485, where 485 is the size in bytes of the file to upload.

NOTE: Required.

Response

Returns the upload URL and jobId

jobIdstring

UUID of the upload job

urlstring

The URL

headersobject

The headers