Edge Delta Agent Configs API

The Agent Configs API from Edge Delta — 3 operation(s) for agent configs.

Operations 6

GET /v1/orgs/{org_id}/confs
POST /v1/orgs/{org_id}/confs
POST /v1/orgs/{org_id}/confs/validate
GET /v1/orgs/{org_id}/confs/{conf_id}
PUT /v1/orgs/{org_id}/confs/{conf_id}
DELETE /v1/orgs/{org_id}/confs/{conf_id}

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/edge-delta-agent-configs-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

edge-delta-agent-configs-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  description: 'Edge Delta API provides endpoints to manage your configs/integrations/rehydrations and more. Generate an API token to get started: https://app.edgedelta.com/admin/organization#api-tokens'
  title: Edge Delta Access Agent Configs API
  contact:
    name: API Support
    email: support@edgedelta.com
  version: '1.0'
servers:
- url: https://api.edgedelta.com
tags:
- name: Agent Configs
paths:
  /v1/orgs/{org_id}/confs:
    get:
      security:
      - ApiKeyAuth: []
      description: Return org's agent configurations that user has read access to
      tags:
      - Agent Configs
      parameters:
      - description: Org ID
        name: org_id
        in: path
        required: true
        schema:
          type: string
      - description: Should be set to 'true' if the contents won't be fetched
        name: empty_contents
        in: query
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/core.Conf'
    post:
      security:
      - ApiKeyAuth: []
      description: Creates a new config from the yml content passed in body
      tags:
      - Agent Configs
      parameters:
      - description: Org ID
        name: org_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/core.Conf'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/core.ConfCreateRequest'
        description: Config Create Request
        required: true
  /v1/orgs/{org_id}/confs/validate:
    post:
      security:
      - ApiKeyAuth: []
      description: Validate agent configuration
      tags:
      - Agent Configs
      parameters:
      - description: Org ID
        name: org_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/core.ConfigValidationResult'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/core.ConfValidateRequest'
        description: Config Validate Request
        required: true
  /v1/orgs/{org_id}/confs/{conf_id}:
    get:
      security:
      - ApiKeyAuth: []
      description: Returns the requested config
      tags:
      - Agent Configs
      parameters:
      - description: Org ID
        name: org_id
        in: path
        required: true
        schema:
          type: string
      - description: Config ID
        name: conf_id
        in: path
        required: true
        schema:
          type: string
      - description: Should be set to 'true' if the content won't be fetched
        name: empty_content
        in: query
        schema:
          type: string
      - description: Should be set to 'true' if the content would be fully resolved (i.e with children etc)
        name: resolve_content
        in: query
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/core.Conf'
    put:
      security:
      - ApiKeyAuth: []
      description: Updates the config for given id
      tags:
      - Agent Configs
      parameters:
      - description: Org ID
        name: org_id
        in: path
        required: true
        schema:
          type: string
      - description: Config ID
        name: conf_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/core.UpdateConfRequest'
        description: Update config request
        required: true
    delete:
      security:
      - ApiKeyAuth: []
      description: Deletes the config with given id
      tags:
      - Agent Configs
      parameters:
      - description: Org ID
        name: org_id
        in: path
        required: true
        schema:
          type: string
      - description: Config ID
        name: conf_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
components:
  schemas:
    core.Conf:
      type: object
      properties:
        cluster_name:
          type: string
        content:
          type: string
        created:
          type: string
        creator:
          type: string
        deployed_timestamp:
          description: Config-history timestamp currently deployed
          type: integer
        description:
          type: string
        environment:
          $ref: '#/components/schemas/core.EnvironmentType'
        fleet_subtype:
          $ref: '#/components/schemas/core.FleetSubtype'
        fleet_type:
          $ref: '#/components/schemas/core.FleetType'
        id:
          type: string
        metadata:
          description: Stores status (updated/updates available/deleted) of compound nodes
          allOf:
          - $ref: '#/components/schemas/core.ConfMetadata'
        orgID:
          type: string
        purpose:
          $ref: '#/components/schemas/core.ConfPurpose'
        retrieved:
          description: Latest retrieval time for installation. Will move to a separate table once obscured hostID for install host is implemented
          type: string
        rollout_task_id:
          type: string
        status:
          $ref: '#/components/schemas/core.FleetStatus'
        tag:
          type: string
        updated:
          type: string
        updater:
          type: string
        version:
          $ref: '#/components/schemas/core.ConfigVersion'
    core.ConfValidateRequest:
      type: object
      properties:
        content:
          type: string
        fleet_type:
          $ref: '#/components/schemas/core.FleetType'
        version:
          $ref: '#/components/schemas/core.ConfigVersion'
    core.ConfMetadata:
      type: object
      properties:
        compound_nodes:
          $ref: '#/components/schemas/core.ConfCompoundNodesMetadata'
        node_references:
          type: array
          items:
            type: string
        telemetry_gen_templates:
          type: array
          items:
            type: string
    core.ConfCompoundNodesMetadata:
      type: object
      properties:
        deleted:
          description: IDs of compound nodes that have been deleted
          type: array
          items:
            type: string
        updated:
          description: IDs of compound nodes updated to latest version
          type: array
          items:
            type: string
        updates_available:
          description: IDs of compound nodes that have updates available
          type: array
          items:
            type: string
    core.ConfPurpose:
      type: string
      enum:
      - user-defined
      - edgedelta-ai
      x-enum-varnames:
      - ConfPurposeUserDefined
      - ConfPurposeEdgedeltaAI
    core.ConfigVersion:
      type: string
      enum:
      - v2
      - v3
      x-enum-varnames:
      - ConfigV2
      - ConfigV3
    core.EnvironmentType:
      type: string
      enum:
      - Kubernetes
      - Helm
      - Docker
      - MacOS
      - Linux
      - Windows
      x-enum-varnames:
      - KubernetesEnvironmentType
      - HelmEnvironmentType
      - DockerEnvironmentType
      - MacOSEnvironmentType
      - LinuxEnvironmentType
      - WindowsEnvironmentType
    core.FleetStatus:
      type: string
      enum:
      - running
      - suspended
      x-enum-varnames:
      - FleetRunning
      - FleetSuspended
    core.ConfigValidationResult:
      type: object
      properties:
        error: {}
        reason:
          type: string
        valid:
          type: boolean
    core.ConfCreateRequest:
      type: object
      required:
      - environment
      - tag
      properties:
        cluster_name:
          description: Pipelines with same cluster name will be grouped together
          type: string
        content:
          type: string
        description:
          description: Description of the pipeline
          type: string
        environment:
          description: Environment where the pipeline will be deployed
          enum:
          - Kubernetes
          - Windows
          - MacOS
          - Linux
          - Docker
          allOf:
          - $ref: '#/components/schemas/core.EnvironmentType'
        fleet_subtype:
          description: FleetSubtype is required when Environment is Kubernetes
          enum:
          - Edge
          - Coordinator
          - Gateway
          allOf:
          - $ref: '#/components/schemas/core.FleetSubtype'
        fleet_type:
          $ref: '#/components/schemas/core.FleetType'
        tag:
          description: Tag is used to identify the pipeline
          type: string
    core.FleetType:
      type: string
      enum:
      - Edge
      - Cloud
      - IngestionPipeline
      - Edge-extended
      - Cloud-extended
      x-enum-varnames:
      - EdgeFleetType
      - CloudFleetType
      - IngestionPipelineFleetType
      - EdgeExtendedFleetType
      - CloudExtendedFleetType
    core.FleetSubtype:
      type: string
      enum:
      - Edge
      - Coordinator
      - Gateway
      x-enum-varnames:
      - EdgeFleetSubtype
      - CoordinatorFleetSubtype
      - GatewayFleetSubtype
    core.UpdateConfRequest:
      type: object
      properties:
        cluster_name:
          type: string
        content:
          type: string
        content_changed:
          type: boolean
        description:
          type: string
        tag:
          type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      name: X-ED-API-Token
      in: header