Projects

Project management operations

List projects

get

Lists projects

Authorizations
X-Auth-TokenstringRequired

Authentication token obtained from the authentication service

Query parameters
domain_idstringOptional

Filter by domain ID

enabledbooleanOptional

Filter by enabled status

is_domainbooleanOptional

Filter by is_domain flag

namestringOptional

Filter by project name

parent_idstringOptional

Filter by parent project ID

tagsstringOptional

Filter by tags

tags-anystringOptional

Filter by any of the specified tags

not-tagsstringOptional

Filter by not having any of the specified tags

not-tags-anystringOptional

Filter by not having all of the specified tags

limitinteger · min: 1Optional

Requests a page size of items

markerstringOptional

The ID of the last-seen item for pagination

Header parameters
X-Auth-TokenstringRequired

A valid authentication token

Responses
200

Projects listed successfully

application/json
get
/projects
GET /v3/projects HTTP/1.1
Host: identity.example.com
X-Auth-Token: text
Accept: */*
{
  "projects": [
    {
      "id": "text",
      "name": "text",
      "description": "text",
      "enabled": true,
      "domain_id": "text",
      "domain": {
        "id": "text",
        "name": "text",
        "description": "text",
        "enabled": true,
        "links": {
          "self": "text",
          "previous": "text",
          "next": "text"
        },
        "options": {}
      },
      "parent_id": "text",
      "is_domain": true,
      "tags": [
        "text"
      ],
      "options": {},
      "links": {
        "self": "text",
        "previous": "text",
        "next": "text"
      }
    }
  ],
  "links": {
    "self": "text",
    "previous": "text",
    "next": "text"
  }
}

Create project

post

Creates a project

Authorizations
X-Auth-TokenstringRequired

Authentication token obtained from the authentication service

Header parameters
X-Auth-TokenstringRequired

A valid authentication token

Body
Responses
post
/projects
POST /v3/projects HTTP/1.1
Host: identity.example.com
X-Auth-Token: text
Content-Type: application/json
Accept: */*
Content-Length: 147

{
  "project": {
    "name": "text",
    "description": "text",
    "enabled": true,
    "domain_id": "text",
    "parent_id": "text",
    "is_domain": true,
    "tags": [
      "text"
    ],
    "options": {}
  }
}
{
  "project": {
    "id": "text",
    "name": "text",
    "description": "text",
    "enabled": true,
    "domain_id": "text",
    "domain": {
      "id": "text",
      "name": "text",
      "description": "text",
      "enabled": true,
      "links": {
        "self": "text",
        "previous": "text",
        "next": "text"
      },
      "options": {}
    },
    "parent_id": "text",
    "is_domain": true,
    "tags": [
      "text"
    ],
    "options": {},
    "links": {
      "self": "text",
      "previous": "text",
      "next": "text"
    }
  }
}

Show project details

get

Shows details for a project

Authorizations
X-Auth-TokenstringRequired

Authentication token obtained from the authentication service

Path parameters
project_idstringRequired

The project ID

Query parameters
include_limitsbooleanOptional

Include project limits in response

Header parameters
X-Auth-TokenstringRequired

A valid authentication token

Responses
200

Project details retrieved successfully

application/json
get
/projects/{project_id}
GET /v3/projects/{project_id} HTTP/1.1
Host: identity.example.com
X-Auth-Token: text
Accept: */*
{
  "project": {
    "id": "text",
    "name": "text",
    "description": "text",
    "enabled": true,
    "domain_id": "text",
    "domain": {
      "id": "text",
      "name": "text",
      "description": "text",
      "enabled": true,
      "links": {
        "self": "text",
        "previous": "text",
        "next": "text"
      },
      "options": {}
    },
    "parent_id": "text",
    "is_domain": true,
    "tags": [
      "text"
    ],
    "options": {},
    "links": {
      "self": "text",
      "previous": "text",
      "next": "text"
    }
  }
}

Delete project

delete

Deletes a project

Authorizations
X-Auth-TokenstringRequired

Authentication token obtained from the authentication service

Path parameters
project_idstringRequired

The project ID

Header parameters
X-Auth-TokenstringRequired

A valid authentication token

Responses
delete
/projects/{project_id}
DELETE /v3/projects/{project_id} HTTP/1.1
Host: identity.example.com
X-Auth-Token: text
Accept: */*

No content

Update project

patch

Updates a project

Authorizations
X-Auth-TokenstringRequired

Authentication token obtained from the authentication service

Path parameters
project_idstringRequired

The project ID

Header parameters
X-Auth-TokenstringRequired

A valid authentication token

Body
Responses
200

Project updated successfully

application/json
patch
/projects/{project_id}
PATCH /v3/projects/{project_id} HTTP/1.1
Host: identity.example.com
X-Auth-Token: text
Content-Type: application/json
Accept: */*
Content-Length: 147

{
  "project": {
    "name": "text",
    "description": "text",
    "enabled": true,
    "domain_id": "text",
    "parent_id": "text",
    "is_domain": true,
    "tags": [
      "text"
    ],
    "options": {}
  }
}
{
  "project": {
    "id": "text",
    "name": "text",
    "description": "text",
    "enabled": true,
    "domain_id": "text",
    "domain": {
      "id": "text",
      "name": "text",
      "description": "text",
      "enabled": true,
      "links": {
        "self": "text",
        "previous": "text",
        "next": "text"
      },
      "options": {}
    },
    "parent_id": "text",
    "is_domain": true,
    "tags": [
      "text"
    ],
    "options": {},
    "links": {
      "self": "text",
      "previous": "text",
      "next": "text"
    }
  }
}

Last updated

Was this helpful?