Account8

AccountPlan6

Aggregation5

Auth1

BalanceChargeSchedule6

Balances8

BalanceTransactionSchedule6

Bill20

BillConfig2

BillGroupingKey5

BillJob5

Charge5

Commitments6

CompoundAggregation5

Contract6

Counter5

CounterAdjustments5

CounterPricing5

CreditReason5

Credits5

Currency5

CustomField2

DataExplorer20

DataExplorerV26

DebitReason5

Debits5

Events4

ExportAdHoc1

ExportDestination6

ExportJob2

ExportSchedule5

External Mapping8

ExternalMappings2

IntegrationConfigs12

IntegrationCredentials5

IntegrationDestinations22

IntegrationRuns7

IntegrationTransformations7

Invitations3

Line Item1

LookupTable5

LookupTableRevision6

LookupTableRevisionData13

Marketplace Integrations1

Measurements6

Meter5

MeterGroup5

Notifications6

OrganizationConfig2

OrgUsers6

PermissionPolicy13

Plan5

PlanGroup5

PlanGroupLink5

PlanTemplate5

Pricing5

Product5

ResourceGroup9

ScheduledEventConfigurations5

ServiceUser6

ServiceUserCredentials6

StatementDefinition5

StatementJob5

Support3

TransactionType5

User1

Measurements

Generate Upload URL

Changed on Oct 16, 2026

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

Request

Base URL
https://api.m3ter.com
Auth
OAuth 2
Authorization codehttps://m3ter.auth.us-east-1.amazoncognito.com/oauth2/authorize, token URL https://m3ter.auth.us-east-1.amazoncognito.com/oauth2/token
Client credentialsToken URL /oauth/token
Scopesmeasurements:fileUpload
TypeScript
https://skmtc.dev/m3ter-com/apis/m3ter-api/docs/organizations/:orgId/fileuploads/measurements/generateUploadUrl/post.ts
A function with typed inputs. Its response is checked against the schema.

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

Changes

Oct 16, 202685c514abc692 Revision changes
- breaking
  the response's property type changed from no type to object for status
- info
  removed subschema #1 subschema #2 from the response property allOf list for the response status
Aug 1, 20259f9e5f3dbde7 Revision changes
- breaking
  request property was restricted to a list of enum values
- breaking
  the request property became required
- info
  added the new application/json enum value to the request property
- info
  added the new text/json enum value to the request property

Operation history (3 revisions)