Workspace (Projects) API from June 8th 2026
Kenesto Workspace API Documentation

Workspace API

Create Workspace Delete Workspace Demote Lifecycle State Promote Lifecycle State Retrieve Workspaces Edit Project Share Project Get Project Participants Permissions Set Project State Add Project Participants Update Project Participants Remove Project Participants

Kenesto Workspace API

Base URL
https://{kenesto-hostname}/Kenesto.Web.API/KWorkspacesV3.svc/
POST Create Workspace ▼

Create a new workspace.

Endpoint

https://{kenesto-hostname}/Kenesto.Web.API/KWorkspacesV3.svc/CreateWorkspace

Parameters

Name Type Required Description
token string yes User session token
name string yes Workspace name
description string yes Workspace description
color string yes Workspace color
userData string no Optional user data

Request Example

{
  "token": "encrypted-token-value",
  "name": "Engineering Workspace",
  "description": "Engineering project workspace",
  "color": "#3366CC",
  "userData": "optional free text"
}

Response Example

{
  "success": true,
  "operation": "CreateWorkspace",
  "message": "CreateWorkspace completed successfully.",
  "data": {
    "workspaceId": "11111111-1111-1111-1111-111111111111",
    "name": "Engineering Workspace",
    "description": "Engineering project workspace",
    "color": "#3366CC"
  }
}
POST Delete Workspace ▼

Delete a workspace.

Endpoint

https://{kenesto-hostname}/Kenesto.Web.API/KWorkspacesV3.svc/DeleteWorkspace

Request Example

{
  "token": "encrypted-token-value",
  "workspaceId": "11111111-1111-1111-1111-111111111111",
  "deleteLinkedContent": false,
  "userData": "optional free text"
}

Response Example

{
  "success": true,
  "operation": "DeleteWorkspace",
  "message": "DeleteWorkspace completed successfully.",
  "data": {
    "result": "ok"
  }
}
POST Demote Lifecycle State ▼

Demote workspace to previous lifecycle state.

Endpoint

https://{kenesto-hostname}/Kenesto.Web.API/KWorkspacesV3.svc/DemoteLifeCycleState

Request Example

{
  "token": "encrypted-token-value",
  "workspaceId": "11111111-1111-1111-1111-111111111111",
  "demoteToState": "Draft",
  "userData": "optional free text"
}
POST Promote Lifecycle State ▼

Promote workspace to next lifecycle state.

Endpoint

https://{kenesto-hostname}/Kenesto.Web.API/KWorkspacesV3.svc/PromoteLifeCycleState

Request Example

{
  "token": "encrypted-token-value",
  "workspaceId": "11111111-1111-1111-1111-111111111111",
  "promoteToState": "Released",
  "userData": "optional free text"
}
POST Retrieve Workspaces ▼

Retrieve all workspaces for the current user.

Endpoint

https://{kenesto-hostname}/Kenesto.Web.API/KWorkspacesV3.svc/RetrieveWorkspaces

Request Example

{
  "token": "encrypted-token-value"
}

Response Example

{
  "success": true,
  "operation": "RetrieveWorkspaces",
  "message": "RetrieveWorkspaces completed successfully.",
  "data": {
    "count": 1
  }
}
POST Edit Project ▼

Edit an existing project.

Endpoint

https://app.kenesto.com/Kenesto.Web.API/KProjects.svc/EditProject

Parameters

Name Type Required Description
token string yes A valid session token.
projectId Guid yes Project Id.
name string no Project name.
description string no Project description.
color string no GRAY, RED, ORANGE, YELLOW, GREEN, BLUE, PURPLE
userData string no User Data – free text.

Request Example

{
  "token":"encrypted-token",
  "projectId":"3749e826-f983-4f97-84db-5c0a58c2a496",
  "name":"New Dev Project2",
  "description":"New all about the Project Dev Project2",
  "color":"RED"
}

Response Example

{
  "EditProjectResult": {
    "ErrorMessage": null,
    "ResponseStatus": "OK"
  }
}
POST Share Project ▼

Share a project with users or groups.

Endpoint

https://app.kenesto.com/Kenesto.Web.API/KProjects.svc/ShareProject

Request Example

{
  "token":"encrypted-token",
  "projectId":"a6a9e1eb-9357-41fc-8e15-45fd6c6ce76c",
  "usersPermissions":[
    {
      "UserEmail":"[email protected]",
      "PermissionTypeValue":"ALLOW_UPDATE_VERSIONS",
      "AllowDelete":true,
      "AllowCreateWorkspace":true
    }
  ]
}

Response Example

{
  "ShareProjectResult": {
    "ErrorMessage": null,
    "ResponseStatus": "OK"
  }
}
POST Get Project Participants Permissions ▼

Retrieve project participant permissions.

Endpoint

https://app.kenesto.com/Kenesto.Web.API/KProjects.svc/GetProjectParticipantsPermissions

Request Example

{
  "token":"encrypted-token",
  "projectId":"a6a9e1eb-9357-41fc-8e15-45fd6c6ce76c"
}

Response Example

{
  "GetProjectParticipantsPermissionsResult": {
    "ResponseStatus": "OK"
  }
}
POST Set Project State ▼

Set the current project state.

Endpoint

https://app.kenesto.com/Kenesto.Web.API/KProjects.svc/SetProjectState

Request Example

{
  "token":"encrypted-token",
  "projectId":"3749e826-f983-4f97-84db-5c0a58c2a496",
  "projectState":"PR_ACTIVE"
}

Response Example

{
  "SetProjectStateResult": {
    "ResponseStatus": "OK"
  }
}
POST Add Project Participants ▼

Add new project participants.

Endpoint

https://app.kenesto.com/Kenesto.Web.API/KProjects.svc/AddProjectParticipants
POST Update Project Participants ▼

Update existing project participants.

Endpoint

https://app.kenesto.com/Kenesto.Web.API/KProjects.svc/UpdateProjectParticipants
POST Remove Project Participants ▼

Remove project participants.

Endpoint

https://app.kenesto.com/Kenesto.Web.API/KProjects.svc/RemoveProjectParticipants

Request Example

{
  "token":"encrypted-token",
  "projectId":"a6a9e1eb-9357-41fc-8e15-45fd6c6ce76c",
  "usersPermissions":[
    {
      "UserEmail":"[email protected]"
    }
  ]
}

Response Example

{
  "RemoveProjectParticipants": {
    "ResponseStatus": "OK"
  }
}
```