Skip to Content
kosemdocs
ReferenceAPIProjects

List projects

Lists the projects of an organization that the caller can open: those they hold resourcemanager.projects.get on, through a role on the project or on the organization.

GET
/v1/projects

Lists the projects of an organization that the caller can open: those they hold resourcemanager.projects.get on, through a role on the project or on the organization.

Authorization

bearer
headerAuthorizationBearer <token>

An access token, or an API key.

Query Parameters

parent*string

The organization whose projects are listed.

Match^organizations/org_[0-7][0-9a-hjkmnp-tv-z]{25}$
showDeleted?boolean

Also list the projects whose deletion was requested, which are left out otherwise.

pageSize?integer

Maximum number of projects to return. Defaults to 50; values above 500 are treated as 500.

Formatint32
Range0 <= value
pageToken?string

Page token from a previous response.

Response Body

OK

application/json
  1. response
nextPageToken*string

Token for the next page; empty on the last page.

projects*array<>

Projects, oldest first.

Example Request
curl -X GET 'https://api.kosem.ai/v1/projects?parent=string'
Example Response
{
  "nextPageToken": "string",
  "projects": [
    {
      "createTime": "2019-08-24T14:15:22Z",
      "deleteTime": "2019-08-24T14:15:22Z",
      "displayName": "string",
      "name": "string",
      "parent": "string",
      "purgeTime": "2019-08-24T14:15:22Z",
      "slug": "string",
      "state": "ACTIVE",
      "updateTime": "2019-08-24T14:15:22Z"
    }
  ]
}