Retrieve distinct values for application categorization

GET

https://api.applivery.io/v1/organizations/{organizationId}/apps/{applicationId}/list/{applicationType}

curl -X GET "https://api.applivery.io/v1/organizations/{organizationId}/apps/{applicationId}/list/{applicationType}" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

const response = await fetch("https://api.applivery.io/v1/organizations/{organizationId}/apps/{applicationId}/list/{applicationType}", {
  method: "GET",
  headers: {
    Authorization: "Bearer <YOUR_API_KEY>",
  },
});

const data = await response.json();

import requests

response = requests.get(
    "https://api.applivery.io/v1/organizations/{organizationId}/apps/{applicationId}/list/{applicationType}",
    headers={"Authorization": "Bearer <YOUR_API_KEY>"},
)

data = response.json()

Request

Send your API key in the request header authorization

Example: Authorization: Bearer <token>

organizationId string

required

Unique identifier or URL-friendly slug for the organization that owns the applications to operate on, establishing organizational scope for all nested application operations.

Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$

applicationType string

required

Type of categorization values to retrieve from application builds, such as git branch names, git tag names, or custom tags applied during upload.

git-branchesgit-tagstags

applicationId string

required

Unique identifier or URL-friendly slug for the specific application to retrieve, update, or delete.

Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$

Responses

200 Response application/json

status boolean optional

data object optional

items array [object] optional

Array of distinct categorization values found in application builds for the requested type.

value string optional

≤ 256 characters

{
    "status": true,
    "data": {
        "items": [
            {
                "value": "string"
            }
        ]
    }
}

401 Response application/json

status boolean optional

false

error object optional

code number optional

4001

message string optional

Unauthorized

{
    "status": false,
    "error": {
        "code": 4002,
        "message": "No auth token"
    }
}

404 Response application/json

status boolean optional

false

error object optional

code number optional

3001

message string optional

Entity not found

{
    "status": false,
    "error": {
        "code": 3001,
        "message": "Entity not found"
    }
}

Request

Authorization

Path Params3

Responses