Get a list of all applications for a project.

GET <your-unleash-url>/api/admin/projects/:projectId/applications

Authorization

name: Authorizationtype: apiKeyin: headerdescription: API key needed to access this API

This endpoint returns an list of all the applications for a project.

Request

Path Parameters

• projectId string required

Query Parameters

• query string

  The search query for the application name, sdk, environment

• offset string

  The number of applications to skip when returning a page. By default it is set to 0.

• limit string

  The number of applications to return in a page. By default it is set to 50.

• sortBy string

  The field to sort the results by. By default it is set to "appName".

• sortOrder string

  The sort order for the sortBy. By default it is det to "asc".

Responses

• 200
• 401
• 403
• 404

---

projectApplicationsSchema

application/json

Schema

Schema

• total integer required

  The total number of project applications.

• applications object[]required

  All applications defined for a specific project.

  Array [

  name string required

  Name of the application that is using the SDK. This is the same as the appName in the SDK configuration.

  environments string[] required

  The environments that the application is using. This is the same as the environment in the SDK configuration.

  instances string[] required

  The instances of the application that are using the SDK.

  sdks object[]required

  The SDKs that the application is using.

  Array [

  name string required

  Name of the SDK package that the application is using.

  versions string[] required

  The versions of the SDK that the application is using.

  ]

  ]

Example (from schema)

{
  "total": 50,
  "applications": [
    {
      "name": "string",
      "environments": [
        "development",
        "production"
      ],
      "instances": [
        "prod-b4ca",
        "prod-ac8a"
      ],
      "sdks": [
        {
          "name": "unleash-client-node",
          "versions": [
            "4.1.1"
          ]
        }
      ]
    }
  ]
}

Authorization information is missing or invalid. Provide a valid API token as the authorization header, e.g. authorization:*.*.my-admin-token.

application/json

Schema

Schema

• id string

  The ID of the error instance

• name string

  The name of the error kind

• message string

  A description of what went wrong.

Example (from schema)

{
  "id": "9c40958a-daac-400e-98fb-3bb438567008",
  "name": "AuthenticationRequired",
  "message": "You must log in to use Unleash. Your request had no authorization header, so we could not authorize you. Try logging in at /auth/simple/login."
}

The provided user credentials are valid, but the user does not have the necessary permissions to perform this operation

application/json

Schema

Schema

• id string

  The ID of the error instance

• name string

  The name of the error kind

• message string

  A description of what went wrong.

Example (from schema)

{
  "id": "9c40958a-daac-400e-98fb-3bb438567008",
  "name": "NoAccessError",
  "message": "You need the \"UPDATE_ADDON\" permission to perform this action in the \"development\" environment."
}

The requested resource was not found.

application/json

Schema

Schema

• id string

  The ID of the error instance

• name string

  The name of the error kind

• message string

  A description of what went wrong.

Example (from schema)

{
  "id": "9c40958a-daac-400e-98fb-3bb438567008",
  "name": "NotFoundError",
  "message": "Could not find the addon with ID \"12345\"."
}

Authorization

name: Authorizationtype: apiKeyin: headerdescription: API key needed to access this API

Request

Base URL

<your-unleash-url>

Security Scheme

apiKeybearerToken

apiKey

projectId — path required

query — query

offset — query

limit — query

sortBy — query

sortOrder — query

curl / cURL

curl -L -X GET '<your-unleash-url>/api/admin/projects/:projectId/applications' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'

python / requests

curl -L -X GET '<your-unleash-url>/api/admin/projects/:projectId/applications' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'

go / native

curl -L -X GET '<your-unleash-url>/api/admin/projects/:projectId/applications' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'

nodejs / axios

curl -L -X GET '<your-unleash-url>/api/admin/projects/:projectId/applications' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'

ruby / Net::HTTP

curl -L -X GET '<your-unleash-url>/api/admin/projects/:projectId/applications' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'

csharp / RestSharp

curl -L -X GET '<your-unleash-url>/api/admin/projects/:projectId/applications' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'

php / cURL

curl -L -X GET '<your-unleash-url>/api/admin/projects/:projectId/applications' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'

java / OkHttp

curl -L -X GET '<your-unleash-url>/api/admin/projects/:projectId/applications' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'

powershell / RestMethod

curl -L -X GET '<your-unleash-url>/api/admin/projects/:projectId/applications' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'