---
updatedAt: 2026-08-05T12:31:19.000Z
agentTools:
  siteIndex: https://docs.jfrog.com/llms.txt
  projectIndex: https://docs.jfrog.com/artifactory/llms.txt
---

# Get All Permissions

Returns all destination permissions configured in the Distribution service. Requires admin permissions.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "JFrog Distribution API",
    "description": "REST API for JFrog Distribution - manages distribution of release bundles to edge nodes. Supports both Release Bundles V1 and V2 workflows including distribution, remote deletion, air-gap export, signing key management, and distribution tracking.",
    "version": "1.0.0",
    "contact": {
      "name": "JFrog Support"
    }
  },
  "servers": [
    {
      "url": "https://{jfrog_url}/distribution/api",
      "description": "JFrog Platform",
      "variables": {
        "jfrog_url": {
          "default": "myserver.jfrog.io",
          "description": "Your JFrog Platform hostname (e.g., mycompany.jfrog.io)"
        }
      }
    }
  ],
  "tags": [
    {
      "name": "Permissions",
      "description": "Destination permission management"
    }
  ],
  "paths": {
    "/v1/security/permissions": {
      "get": {
        "tags": [
          "Permissions"
        ],
        "summary": "Get All Permissions",
        "description": "Returns all destination permissions configured in the Distribution service. Requires admin permissions.",
        "operationId": "getAllDistributionPermissions",
        "responses": {
          "200": {
            "description": "Success - List of permissions",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DestinationPermission"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Bad Credentials - The provided authentication is invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ErrorResponse": {
        "type": "object",
        "properties": {
          "errors": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "integer"
                },
                "message": {
                  "type": "string"
                }
              }
            }
          },
          "detail": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "status_code": {
            "type": "integer"
          }
        }
      },
      "DestinationPermission": {
        "type": "object",
        "description": "Destination permission controlling which users and groups can distribute or delete release bundles to specific edge nodes",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique permission identifier (read-only, assigned by the system)",
            "readOnly": true
          },
          "name": {
            "type": "string",
            "description": "Display name of the permission (read-only, set from the path parameter)",
            "readOnly": true
          },
          "resourceType": {
            "type": "string",
            "description": "Resource type (always \"DESTINATION\")",
            "readOnly": true,
            "enum": [
              "DESTINATION"
            ]
          },
          "distribution_destinations": {
            "type": "array",
            "description": "Rules defining which edge nodes this permission grants access to. Use site name, city name, and/or country codes to target specific nodes.",
            "items": {
              "type": "object",
              "properties": {
                "siteName": {
                  "type": "string",
                  "description": "Target site name. Use \"*\" to match all sites."
                },
                "cityName": {
                  "type": "string",
                  "description": "City name filter"
                },
                "countryCodes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Country code filters (ISO 3166-1 alpha-2)"
                }
              }
            }
          },
          "principals": {
            "type": "object",
            "description": "Users and groups with their permitted actions",
            "properties": {
              "users": {
                "type": "object",
                "description": "Map of username to list of permitted action codes (e.g., \"distribute\", \"delete\")",
                "additionalProperties": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "enum": [
                      "distribute",
                      "delete"
                    ]
                  }
                }
              },
              "groups": {
                "type": "object",
                "description": "Map of group name to list of permitted action codes (e.g., \"distribute\", \"delete\")",
                "additionalProperties": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "enum": [
                      "distribute",
                      "delete"
                    ]
                  }
                }
              }
            }
          }
        }
      }
    },
    "securitySchemes": {
      "BasicAuth": {
        "type": "http",
        "scheme": "basic"
      },
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  },
  "security": [
    {
      "BasicAuth": []
    },
    {
      "BearerAuth": []
    }
  ]
}
```