postLinkUsageWithHttpInfo method

Future<Response> postLinkUsageWithHttpInfo(IngestReq ingestReq)

Reports usage samples from the device collector.

Reports usage samples from the device collector. It ingests a batch of usage samples and answers with how many were accepted, whether history was durably stored, and the links they refreshed. A report also REFRESHES one link per distinct (machine, provider, account) it names, so a running collector keeps the accounts overview current without a separate registration call. A caller can only ever report for THEMSELVES: org and subject come from the validated bearer, never from the body, so no sample can be attributed to another user or tenant. History is FAIL-SOFT and stored says which happened — a warehouse outage still accepts the report and refreshes the links rather than failing the device, and answers 202 either way. Send either one sample inline or up to 256 in samples; an empty batch or an over-long one is 400, as is a provider, window class or kind outside the closed vocabulary — an unrecognized window is refused rather than rewritten, because a silently reclassified sample would fill a dashboard with a class nobody reported.

Note: This method returns the HTTP Response.

Parameters:

• IngestReq ingestReq (required):

Implementation

Future<Response> postLinkUsageWithHttpInfo(IngestReq ingestReq,) async {
  // ignore: prefer_const_declarations
  final path = r'/v1/link/usage';

  // ignore: prefer_final_locals
  Object? postBody = ingestReq;

  final queryParams = <QueryParam>[];
  final headerParams = <String, String>{};
  final formParams = <String, String>{};

  const contentTypes = <String>['application/json'];


  return apiClient.invokeAPI(
    path,
    'POST',
    queryParams,
    postBody,
    headerParams,
    formParams,
    contentTypes.isEmpty ? null : contentTypes.first,
  );
}