Learn about our new features recently updated daily.

Learn More

Read all projects & applications (Team included)

Used to read all projects and applications a user has access to, including those under the team.

API

GET https://api.beaglesecurity.com/rest/v2/projects?include_team=true

Required scope: read_project

Request headers

Authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Now that you have explored project management, you can dive into Application in Beagle Security. Applications can be web applications or APIs, and you can manage them using APIs to create,retrieve,modify,delete,and list applications under a project.

Last modified: 2025/03/10

Example request

cURL

Java

  
            curl --location --request GET  \
    'https://api.beaglesecurity.com/rest/v2/projects' \
     --header 'Authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'

                    // This token will be generated from Beagle security settings -> Access token
                    BeagleSecurityClient client = BeagleSecurityClientBuilder.instance()
                        .withAPIToken("xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx")
                        .build();

                    // Gets all the projects and its applications under a user
                    List<ProjectWithApplication> projects = client.getAllProjects();

Response

200 400 401


{
"code": "SUCCESS",
"message": "Success",
"projects": [
  {
    "name": "Default project",
    "description": "New project",
    "projectKey": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "applications": [
      {
        "name": "Default application",
        "url": "http://196.168.0.7:80",
        "applicationToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "applicationType": "API",
        "signatureStatus": "Verified",
        "hostingType": "internal"
      },
      {
        "name": "Default application 2",
        "url": "http://example.com",
        "applicationToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "applicationType": "WEB",
        "signatureStatus": "NotVerified",
        "hostingType": "public"
      }
    ]
  },
  {
    "name": "Default project 2",
    "description": "New project",
    "projectKey": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "applications": [
      {
        "name": "Default application 3",
        "url": "http://example2.com",
        "applicationToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "applicationType": "WEB",
        "signatureStatus": "Verified",
        "hostingType": "public"
      }
    ]
  }
]
}

                    {
"code": "FAILED",
"message": "Failed to get projects."
}

                    {
"code": "NOT_AUTHORIZED",
"message": "Not authorized"
}
            </div>
            
    
        Is this page useful?
        Help us improve this website by providing feedback.

        
            
                
                    
                
                
                    
                
            

            Thanks for your feedback!
            Error submitting feedback. Please try again.

            
                
                
            
        
    


        </div>
    </div>
</div>
</div>

Next