PermalinkAdmin API Reference

PermalinkIntroduction

Kong Enterprise’s Workspaces feature is configurable through Kong’s Admin API.

PermalinkWorkspace Object

The Workspace object describes the workspece entity, which has an ID and a name.

PermalinkAdd Workspace

Endpoint

PermalinkRequest Body

Response

HTTP 201 Created

{
  "name": "teamA",
  "created_at": 1528838706000,
  "id": "5396b1b3-ff46-4cb2-8065-5a4b35be342d"
}

PermalinkList Workspaces

Endpoint

Response

HTTP 200 OK

{
  "total": 1,
  "data": [
    {
      "created_at": 1528806517000,
      "id": "9f8008c5-722f-4637-8080-5ee96b535c33",
      "name": "default"
    }
  ]
}

PermalinkUpdate or Create a Workspace

Endpoint

PermalinkRequest Body

The behavior of PUT endpoints is the following: if the request payload does not contain an entity’s primary key (id for Workspaces), the entity will be created with the given payload. If the request payload does contain an entity’s primary key, the payload will “replace” the entity specified by the given primary key. If the primary key is not that of an existing entity, 404 NOT FOUND will be returned.

Response

HTTP 201 Created or HTTP 200 OK

PermalinkRetrieve a Workspace

Endpoint

Response

HTTP 200 OK

{
  "created_at": 1528838706000,
  "id": "5396b1b3-ff46-4cb2-8065-5a4b35be342d",
  "name": "teamA"
}

PermalinkDelete a Workspace

Endpoint

Response

HTTP 204 No Content

PermalinkUpdate a Workspace

Endpoint

PermalinkRequest Body

Response

HTTP 200 OK

{
  "name": "teamB",
  "created_at": 1528838706000,
  "id": "5396b1b3-ff46-4cb2-8065-5a4b35be342d"
}

PermalinkAdd entities to a Workspace

Workspaces are groups of entities - including workspaces. This endpoint allows one to add an entity, identified by its unique identifier, to a workspace.

Endpoint

PermalinkRequest Body

Response

HTTP 200 No Content

{
  "host": "example.com",
  "created_at": 1528927690,
  "connect_timeout": 60000,
  "id": "ecdc96cd-39d7-4a72-b661-8481a3e14e1e",
  "protocol": "http",
  "name": null,
  "read_timeout": 60000,
  "port": 80,
  "path": "/",
  "updated_at": 1528927690,
  "retries": 5,
  "write_timeout": 60000
}

The response is the representation of the entity that was added to the workspace - in this case, a Service.

PermalinkList entities that are part of a Workspace

Endpoint

Response

HTTP 200 OK

{
  "data": [
    {
      "workspace_id": "5396b1b3-ff46-4cb2-8065-5a4b35be342d",
      "entity_id": "d766d5a8-4dc8-49e8-928d-29ff5aebb927",
      "entity_type": "services",
    },
    {
      "workspace_id": "5396b1b3-ff46-4cb2-8065-5a4b35be342d",
      "entity_id": "65b66412-df45-485d-8fa8-13cda8c892ac",
      "entity_type": "workspaces",
    }
  ],
  "total": 2
}

In this case, the workspace references two entities: a Service and a Workspace (workspaces are allowed to include other workspaces).

PermalinkDelete entities from a Workspace

Endpoint

PermalinkRequest Body

Response

HTTP 204 No Content

PermalinkRetrieve an entity from a Workspace

This endpoint allows one to retrieve an entity from a workspace - useful, say, for checking if a given entity is part of a given workspace.

Endpoint

Response

HTTP 200 OK

{
  "workspace_id": "5396b1b3-ff46-4cb2-8065-5a4b35be342d",
  "entity_id": "d766d5a8-4dc8-49e8-928d-29ff5aebb927",
  "entity_type": "services"
}

PermalinkDelete a particular entity from a workspace

Endpoint

Response

HTTP 204 No Response

Next: Workspaces Examples ›