JFrog Artifactory

JFrog Artifactory System & Configuration API

System health, version, and configuration management

GitHub OpenAPI

Operations 6

GET /api/system/ping JFrog Artifactory System Health Ping #
GET /api/system/version JFrog Artifactory Get Version Information #
GET /api/system/configuration JFrog Artifactory Get System Configuration #
PATCH /api/system/configuration JFrog Artifactory Update System Configuration #
GET /api/system/licenses JFrog Artifactory Get License Information #
GET /api/system/storage JFrog Artifactory Get Storage Summary #

Documentation

📖
Documentation
https://jfrog.com/help/r/jfrog-rest-apis/artifactory-rest-apis
📖
Authentication
https://jfrog.com/help/r/jfrog-rest-apis/authentication
📖
Documentation
https://jfrog.com/help/r/jfrog-artifactory-documentation/artifactory-query-language
📖
Documentation
https://jfrog.com/help/r/jfrog-artifactory-documentation/docker-registry
📖
Documentation
https://jfrog.com/help/r/jfrog-rest-apis/builds

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/artifactory/refs/heads/main/openapi/artifactory-system-configuration-api-openapi.yml

Code Examples

💻
CodeExamples
https://jfrog.com/help/r/jfrog-artifactory-documentation/aql-examples

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/artifactory/refs/heads/main/json-schema/artifactory-repository-configuration.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/artifactory/refs/heads/main/json-schema/artifactory-file-info.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/artifactory/refs/heads/main/json-schema/artifactory-permission-target.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/artifactory/refs/heads/main/json-schema/artifactory-build-info.json

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/artifactory-system-configuration-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.

GitHub Google LinkedIn

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

OpenAPI Specification

artifactory-system-configuration-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: JFrog Artifactory Query Language (AQL) AQL Search System & Configuration API
  description: Advanced search API using Artifactory Query Language (AQL), a SQL-like query language for finding and filtering artifacts, builds, and entries in JFrog Artifactory. AQL provides powerful querying capabilities including domain queries, field filtering, sorting, limiting, and inclusion of related entities.
  version: 7.x
  contact:
    name: JFrog Support
    url: https://jfrog.com/support/
    email: support@jfrog.com
  license:
    name: Proprietary
    url: https://jfrog.com/terms-of-service/
  termsOfService: https://jfrog.com/terms-of-service/
servers:
- url: https://{server}/artifactory
  description: JFrog Artifactory Server
  variables:
    server:
      default: myserver.jfrog.io
      description: Your JFrog Platform deployment URL
security:
- BearerAuth: []
- ApiKeyAuth: []
- BasicAuth: []
tags:
- name: System & Configuration
  description: System health, version, and configuration management
paths:
  /api/system/ping:
    get:
      operationId: systemPing
      summary: JFrog Artifactory System Health Ping
      description: Returns a simple "OK" if Artifactory is accessible. Used for health checks.
      tags:
      - System & Configuration
      security: []
      responses:
        '200':
          description: Artifactory is accessible
          content:
            text/plain:
              schema:
                type: string
                example: OK
  /api/system/version:
    get:
      operationId: getSystemVersion
      summary: JFrog Artifactory Get Version Information
      description: Returns the Artifactory version and revision information along with enabled addons.
      tags:
      - System & Configuration
      responses:
        '200':
          description: Version information
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VersionInfo'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /api/system/configuration:
    get:
      operationId: getSystemConfiguration
      summary: JFrog Artifactory Get System Configuration
      description: Returns the global system configuration XML (artifactory.config.xml).
      tags:
      - System & Configuration
      responses:
        '200':
          description: System configuration XML
          content:
            application/xml:
              schema:
                type: string
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
    patch:
      operationId: updateSystemConfiguration
      summary: JFrog Artifactory Update System Configuration
      description: Applies a YAML patch to update specific parts of the system configuration.
      tags:
      - System & Configuration
      requestBody:
        required: true
        content:
          application/yaml:
            schema:
              type: string
      responses:
        '200':
          description: Configuration updated successfully
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
  /api/system/licenses:
    get:
      operationId: getLicenseInfo
      summary: JFrog Artifactory Get License Information
      description: Returns the license details for the current Artifactory instance.
      tags:
      - System & Configuration
      responses:
        '200':
          description: License information
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LicenseInfo'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /api/system/storage:
    get:
      operationId: getStorageSummary
      summary: JFrog Artifactory Get Storage Summary
      description: Returns a summary of storage usage across all repositories.
      tags:
      - System & Configuration
      responses:
        '200':
          description: Storage summary information
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StorageSummary'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  responses:
    Unauthorized:
      description: Unauthorized - authentication required
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    BadRequest:
      description: Bad request - invalid input
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Forbidden:
      description: Forbidden - insufficient permissions
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  schemas:
    StorageSummary:
      type: object
      properties:
        binariesSummary:
          type: object
          properties:
            binariesCount:
              type: string
              description: Total number of binaries
            binariesSize:
              type: string
              description: Total size of binaries
            artifactsSize:
              type: string
              description: Total size of artifacts
            optimization:
              type: string
              description: Storage optimization percentage
            itemsCount:
              type: string
              description: Total number of items
            artifactsCount:
              type: string
              description: Total number of artifacts
        fileStoreSummary:
          type: object
          properties:
            storageType:
              type: string
              description: Storage backend type
            storageDirectory:
              type: string
              description: Storage directory path
            totalSpace:
              type: string
              description: Total storage space
            usedSpace:
              type: string
              description: Used storage space
            freeSpace:
              type: string
              description: Free storage space
        repositoriesSummaryList:
          type: array
          items:
            type: object
            properties:
              repoKey:
                type: string
                description: Repository key
              repoType:
                type: string
                description: Repository type
              foldersCount:
                type: integer
                description: Number of folders
              filesCount:
                type: integer
                description: Number of files
              usedSpace:
                type: string
                description: Space used by this repository
              itemsCount:
                type: integer
                description: Total items count
              packageType:
                type: string
                description: Package type
              percentage:
                type: string
                description: Percentage of total storage
    VersionInfo:
      type: object
      properties:
        version:
          type: string
          description: Artifactory version number
          example: 7.77.5
        revision:
          type: string
          description: Build revision
          example: '77700900'
        addons:
          type: array
          items:
            type: string
          description: List of enabled add-on modules
        license:
          type: string
          description: License type
          example: Enterprise+
    LicenseInfo:
      type: object
      properties:
        type:
          type: string
          description: License type
          example: Enterprise+
        validThrough:
          type: string
          description: License expiration date
          example: '2026-12-31T00:00:00.000Z'
        licensedTo:
          type: string
          description: Organization the license is issued to
    ErrorResponse:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              status:
                type: integer
                description: HTTP status code
              message:
                type: string
                description: Error message
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: Access token authentication
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-JFrog-Art-Api
      description: API key authentication via header
    BasicAuth:
      type: http
      scheme: basic
      description: HTTP Basic authentication
externalDocs:
  description: Artifactory Query Language Documentation
  url: https://jfrog.com/help/r/jfrog-artifactory-documentation/artifactory-query-language