Get Organization Projects

Platform API 3.0

Request

Returns a list of all projects accessible to the current user

Security

bearer-key

Path

orgUuidstringrequired

org UUID (from the Mend App: Administration General > Organization UUID).

Query

cursorstring

Parameter indicates the starting point for retrieving results, the first call doesn't include a cursor parameter in the request, the API response includes the first set of results along with a cursor pointing to the last item retrieved.

limitstring, <= 10000

Specifies the maximum number of items to be returned in the response.

Default:"50"

populateApplicationsstring

Add populateApplications=false to receive a slimmer response containing only the project UUID and name.

Default:"true"

excludeInactiveProjectsstring

Add excludeInactiveProjects=false to retrieve all projects, including inactive ones.

Default:"true"

GET

/api/v3.0/orgs/{orgUuid}/projects

curl -i -X GET \
  'https://baseUrl/api/v3.0/orgs/{orgUuid}/projects?cursor=string&limit=50&populateApplications=true&excludeInactiveProjects=true' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Bodyapplication/json

additionalDataobject(Provides insights into endpoint-supported pagination information.)

totalItems: The total count of data points returned in an API response.

Example:

{
  "totalItems": "422",
  "next": "http://someUrl?cursor=3",
  "cursor": 3
}

supportTokenstring(Support Token)

Example:"1171c60d"

responseArray of objects(ProjectDTOV3)

Response

{
  "additionalData": {
    "totalItems": "422",
    "next": "http://someUrl?cursor=3",
    "cursor": 3
  },
  "supportToken": "1171c60d",
  "response": [
    { … }
  ]
}