Coralogix Metrics Data Archive Service API

View and manage your storage targets for metrics.

Operations 6

GET /metrics/data-setup/v1 Get Metrics Storage Configuration #
PUT /metrics/data-setup/v1 Update Metrics Storage Configuration #
POST /metrics/data-setup/v1 Configure Tenant #
POST /metrics/data-setup/v1/disable Disable Metrics Archive #
POST /metrics/data-setup/v1/enable Enable Metrics Archive #
POST /metrics/data-setup/v1/validate Validate Metrics Storage Bucket #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/coralogix:coralogix-metrics-data-archive-service-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

coralogix-metrics-data-archive-service-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Coralogix Management Metrics Data Archive Service API
  version: '5'
  description: 'Management API for the Coralogix observability platform. The base URL is region-specific: pick the `servers` entry matching your Coralogix domain. Authentication is a bearer API key.'
servers:
- url: https://api.eu1.coralogix.com/mgmt/openapi/5
- url: https://api.eu2.coralogix.com/mgmt/openapi/5
- url: https://api.us1.coralogix.com/mgmt/openapi/5
- url: https://api.us2.coralogix.com/mgmt/openapi/5
- url: https://api.us3.coralogix.com/mgmt/openapi/5
- url: https://api.ap1.coralogix.com/mgmt/openapi/5
- url: https://api.ap2.coralogix.com/mgmt/openapi/5
- url: https://api.ap3.coralogix.com/mgmt/openapi/5
- url: https://api.gov1.coralogixgov.us/mgmt/openapi/5
security:
- apiKeyAuth: []
tags:
- name: Metrics Data Archive Service
  description: View and manage your storage targets for metrics.
  externalDocs:
    description: Find out more about archives
    url: https://coralogix.com/docs/user-guides/data-flow/s3-archive/connect-s3-archive/
paths:
  /metrics/data-setup/v1:
    get:
      description: Returns the current metrics storage configuration.
      operationId: MetricsConfiguratorPublicService_GetTenantConfig
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTenantConfigResponseV2'
          description: ''
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unauthorized request
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Internal server error
      summary: Get Metrics Storage Configuration
      tags:
      - Metrics Data Archive Service
    put:
      description: Updates the metrics storage configuration.
      operationId: MetricsConfiguratorPublicService_Update
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
              - required:
                - ibm
                type: object
              - required:
                - s3
                type: object
              - required:
                - gcs
                type: object
              - not:
                  anyOf:
                  - required:
                    - ibm
                    type: object
                  - required:
                    - s3
                    type: object
                  - required:
                    - gcs
                    type: object
                type: object
              properties:
                gcs:
                  allOf:
                  - $ref: '#/components/schemas/GcsConfig'
                  description: Google Cloud Storage configuration.
                ibm:
                  allOf:
                  - $ref: '#/components/schemas/IbmConfigV2'
                  description: IBM Cloud Object Storage configuration.
                retentionDays:
                  description: Archive retention period in days.
                  format: int64
                  minimum: 0
                  type: integer
                  x-coralogix-presence: true
                s3:
                  allOf:
                  - $ref: '#/components/schemas/S3Config'
                  description: AWS S3 storage configuration.
              title: Update Tenant Request
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
          description: ''
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unauthorized request
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Internal server error
      summary: Update Metrics Storage Configuration
      tags:
      - Metrics Data Archive Service
    post:
      description: Creates the metrics storage configuration.
      operationId: MetricsConfiguratorPublicService_ConfigureTenant
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
              - required:
                - ibm
                type: object
              - required:
                - s3
                type: object
              - required:
                - gcs
                type: object
              - not:
                  anyOf:
                  - required:
                    - ibm
                    type: object
                  - required:
                    - s3
                    type: object
                  - required:
                    - gcs
                    type: object
                type: object
              properties:
                gcs:
                  allOf:
                  - $ref: '#/components/schemas/GcsConfig'
                  description: Google Cloud Storage configuration.
                ibm:
                  allOf:
                  - $ref: '#/components/schemas/IbmConfigV2'
                  description: IBM Cloud Object Storage configuration.
                retentionPolicy:
                  $ref: '#/components/schemas/RetentionPolicyRequest'
                s3:
                  allOf:
                  - $ref: '#/components/schemas/S3Config'
                  description: AWS S3 storage configuration.
              title: Configure Tenant Request
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
          description: ''
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unauthorized request
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Internal server error
      summary: Configure Tenant
      tags:
      - Metrics Data Archive Service
  /metrics/data-setup/v1/disable:
    post:
      description: Disables the metrics storage configuration.
      operationId: MetricsConfiguratorPublicService_DisableArchive
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
          description: ''
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unauthorized request
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Internal server error
      summary: Disable Metrics Archive
      tags:
      - Metrics Data Archive Service
  /metrics/data-setup/v1/enable:
    post:
      description: Enables the metrics storage configuration.
      operationId: MetricsConfiguratorPublicService_EnableArchive
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
          description: ''
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unauthorized request
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Internal server error
      summary: Enable Metrics Archive
      tags:
      - Metrics Data Archive Service
  /metrics/data-setup/v1/validate:
    post:
      description: Validates the provided metrics storage configuration.
      operationId: MetricsConfiguratorPublicService_ValidateBucket
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
              - required:
                - ibm
                type: object
              - required:
                - s3
                type: object
              - required:
                - gcs
                type: object
              - not:
                  anyOf:
                  - required:
                    - ibm
                    type: object
                  - required:
                    - s3
                    type: object
                  - required:
                    - gcs
                    type: object
                type: object
              properties:
                gcs:
                  allOf:
                  - $ref: '#/components/schemas/GcsConfig'
                  description: Google Cloud Storage configuration.
                ibm:
                  allOf:
                  - $ref: '#/components/schemas/IbmConfigV2'
                  description: IBM Cloud Object Storage configuration.
                s3:
                  allOf:
                  - $ref: '#/components/schemas/S3Config'
                  description: AWS S3 storage configuration.
              title: Bucket Validation Request
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
          description: ''
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unauthorized request
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Internal server error
      summary: Validate Metrics Storage Bucket
      tags:
      - Metrics Data Archive Service
components:
  schemas:
    TenantConfigV2:
      type: object
      oneOf:
      - required:
        - ibm
        type: object
      - required:
        - s3
        type: object
      - required:
        - gcs
        type: object
      - type: object
        not:
          anyOf:
          - required:
            - ibm
            type: object
          - required:
            - s3
            type: object
          - required:
            - gcs
            type: object
      properties:
        disabled:
          type: boolean
          description: Whether metrics archiving is disabled for this tenant.
        gcs:
          allOf:
          - $ref: '#/components/schemas/GcsConfig'
          description: Google Cloud Storage configuration.
        ibm:
          allOf:
          - $ref: '#/components/schemas/IbmConfigV2'
          description: IBM Cloud Object Storage configuration.
        prefix:
          minLength: 0
          type: string
          description: Storage path prefix applied to all archived objects.
        retentionPolicy:
          $ref: '#/components/schemas/RetentionPolicyRequest'
        s3:
          allOf:
          - $ref: '#/components/schemas/S3Config'
          description: AWS S3 storage configuration.
        tenantId:
          minimum: 0
          type: integer
          description: Tenant identifier.
          format: int64
      description: Tenant config v2.
    S3Config:
      title: S3 Configuration
      type: object
      properties:
        bucket:
          minLength: 0
          type: string
          description: Bucket name.
        region:
          minLength: 0
          type: string
          description: Region.
      externalDocs:
        description: Find out more about metrics cost optimization
        url: https://coralogix.com/docs/user-guides/account-management/payment-and-billing/metrics-optimization/
    Error:
      type: object
      properties:
        code:
          maximum: 599
          minimum: 100
          type: integer
          description: HTTP status code of the error (for example 400, 404, 500).
          format: int32
        message:
          maxLength: 4096
          minLength: 0
          pattern: ^[\s\S]*$
          type: string
          description: Human-readable description of the error.
      description: Standard error response body returned for a failed request.
    RetentionPolicyRequest:
      title: Retenion Policy Request
      type: object
      properties:
        fiveMinutesResolution:
          minimum: 0
          type: integer
          description: The five minutes resolution.
          format: int64
          examples:
          - 2
        oneHourResolution:
          minimum: 0
          type: integer
          description: The one hour resolution.
          format: int64
          examples:
          - 3
        rawResolution:
          minimum: 0
          type: integer
          description: The raw resolution.
          format: int64
          examples:
          - 1
      externalDocs:
        description: Find out more about metrics cost optimization
        url: https://coralogix.com/docs/user-guides/account-management/payment-and-billing/metrics-optimization/
    IbmConfigV2:
      title: IBM Bucket Configuration
      type: object
      properties:
        crn:
          minLength: 0
          type: string
          description: The crn.
          examples:
          - 'crn:v1:bluemix:public:cloud-object-storage:global:a/1234567890abcdef1234567890abcdef:12345678-1234-1234-1234-1234567890ab::'
        endpoint:
          minLength: 0
          type: string
          description: Endpoint.
          examples:
          - s3.us-south.cloud-object-storage.appdomain.cloud
        serviceCrn:
          minLength: 0
          type: string
          description: The service crn.
          examples:
          - 'crn:v1:bluemix:public:cloud-object-storage:global:a/1234567890abcdef1234567890abcdef:12345678-1234-1234-1234-1234567890ab::'
      externalDocs:
        description: Find out more about metrics cost optimization
        url: https://coralogix.com/docs/user-guides/account-management/payment-and-billing/metrics-optimization/
    GcsConfig:
      title: GCS Configuration
      type: object
      properties:
        bucket:
          minLength: 0
          type: string
          description: Bucket name.
      externalDocs:
        description: Find out more about metrics cost optimization
        url: https://coralogix.com/docs/user-guides/account-management/payment-and-billing/metrics-optimization/
    GetTenantConfigResponseV2:
      type: object
      properties:
        tenantConfig:
          $ref: '#/components/schemas/TenantConfigV2'
      description: Response containing the current metrics tenant configuration.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: API key authentication
externalDocs:
  description: Coralogix API reference
  url: https://coralogix.com/docs/api-reference/v5/
x-provenance:
  method: harvested
  publisher: Coralogix
  source: https://coralogix.com/docs/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)