Skip to content

Kanbert (v1)

Download OpenAPI description
Languages
Servers
https://api.kanbert.int/api/v1/

Schemas

Schemas

Clients

Operations

CustomFields

Operations

Efforts

Operations

File

Operations

Projects

Operations

Tasks

Operations

Usergroups

Operations

Filter all usergroups

https://developers.kanbert.com/_bundle/openapi.json#/paths/~1user-groups/get

Request

Security
http
Query
sortstring

Available sorts are name, is_team.
You can sort by multiple options by separating them with a comma. To sort in descending order, use - sign in front of the sort, for example: -title.

Example: sort=sort=-created_at,title
includestring

Available includes are users. You can include multiple options by separating them with a comma.

page[size]integer

The number of results that will be returned per page.

Default 30
page[cursor]string

The cursor to start the pagination from.

filterstring

Allowed filter fields (with allowed operators):

FieldTypeOperators
namestringin, nin, notin, eq, ne, neq, contains, like, startswith, endswith, isnull, isnotnull, notnull
is_teambooleaneq, ne, neq, isnull, isnotnull, notnull

Filtering expression. Accepts either JSON (array/tree of conditions) or a readable string DSL.

You can check the full syntax at Docs Filtering section.

Special values:

  • me.id — current authenticated user id (usable on fields of type id). Example: id eq me.id
  • now — current date-time. Example: dueOn lt now
  • sow/eow — start/end of week. Examples: dueOn gt sow, dueOn lt eow
  • som/eom — start/end of month. Examples: dueOn gt som, dueOn lt eom
  • today — special date for today; with eq it expands to the whole day range. Example: dueOn eq today
  • today±Nd — relative day offset. Examples: today-30d, today+5d.
Example: filter=title contains "Acme" and (created_at >= "2024-01-01" or client.name contains "Corp")
curl -i -X GET \
  'https://api.kanbert.int/api/v1/user-groups?sort=sort%3D-created_at%2Ctitle&include=string&page%5Bsize%5D=30&page%5Bcursor%5D=string&filter=title+contains+%22Acme%22+and+%28created_at+%3E%3D+%222024-01-01%22+or+client.name+contains+%22Corp%22%29' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

The cursor paginated collection of UsergroupData

Bodyapplication/json
dataArray of objects(UsergroupData)required

The list of items

data[].​idstringrequired
data[].​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

data[].​namestringrequired
data[].​is_teambooleanrequired

If true, this usergroup is shown as team

data[].​usersArray of objects(UserData)required
data[].​users[].​idstringrequired
data[].​users[].​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

data[].​users[].​first_namestringrequired
data[].​users[].​last_namestringrequired
data[].​users[].​titlestring or nullrequired
data[].​users[].​title_suffixstring or nullrequired
data[].​users[].​emailstring(email)required
data[].​users[].​birthdaystring or null(date)required
data[].​users[].​genderstring or nullrequired
data[].​users[].​positionstring or nullrequired
data[].​users[].​special_rolesstring or nullrequired
data[].​users[].​skillsstring or nullrequired
data[].​users[].​profilestring or nullrequired
data[].​users[].​languagestring or nullrequired

UI language

data[].​users[].​languagesstring or nullrequired

Spoken languages

data[].​users[].​telephone_officestring or nullrequired

Mobile phone (Office)

data[].​users[].​phone_extensionstring or nullrequired

Landline phone (Office)

data[].​users[].​telephonestring or nullrequired

Mobile phone (Private)

data[].​users[].​entry_datestring or null(date)required

Date of joining the company

data[].​users[].​leave_datestring or null(date)required

Date of leaving the company - if set in the future, the employee will be archived on that date

data[].​users[].​typestring(UserType)required
Enum"user""guest""tax_advisor"
data[].​users[].​planstring(UserPlan)required
Enum"basic""standard""external""advanced""expert""guest""tax_advisor""not_assigned"
data[].​users[].​is_ownerbooleanrequired

Is Kanbert space owner

data[].​users[].​avatarFileData (object) or nullrequired
Any of:
object FileData Recursive
data[].​users[].​userGroupsArray of objects(UsergroupData)
data[].​users[].​userGroupsCountinteger
data[].​users[].​userGroupsExistsboolean
data[].​users[].​customFieldsobjectrequired

The key is the field name for your custom field, value type depends on the field type

data[].​users[].​customFields.​property name*string or boolean or integer or nulladditional property
Any of:
string
data[].​users[].​created_atstring(date-time)required
data[].​users[].​deleted_atstring or null(date-time)required
linksArray of stringsrequired
metaobjectrequired
meta.​pathstring or nullrequired

Base path for paginator generated URLs.

meta.​per_pageintegerrequired

Number of items shown per page.

meta.​next_cursorstring or nullrequired
meta.​next_cursor_urlstring or nullrequired
meta.​prev_cursorstring or nullrequired
meta.​prev_cursor_urlstring or nullrequired
Response
application/json
{ "data": [ {} ], "links": [ "string" ], "meta": { "path": "string", "per_page": 0, "next_cursor": "string", "next_cursor_url": "string", "prev_cursor": "string", "prev_cursor_url": "string" } }

Show single usergroup

https://developers.kanbert.com/_bundle/openapi.json#/paths/~1user-groups~1{id}/get

Request

Security
http
Path
idintegerrequired
Query
findBystring

The field to search by

Default "id"
Enum"id""external_id"
includestring

Available includes are users. You can include multiple options by separating them with a comma.

curl -i -X GET \
  'https://api.kanbert.int/api/v1/user-groups/{id}?findBy=id&include=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

UsergroupData

Bodyapplication/json
idstringrequired
external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

namestringrequired
is_teambooleanrequired

If true, this usergroup is shown as team

usersArray of objects(UserData)required
users[].​idstringrequired
users[].​external_idstring or nullrequired

Can be used to add an identifier to the client from an external system, must be unique

users[].​first_namestringrequired
users[].​last_namestringrequired
users[].​titlestring or nullrequired
users[].​title_suffixstring or nullrequired
users[].​emailstring(email)required
users[].​birthdaystring or null(date)required
users[].​genderstring or nullrequired
users[].​positionstring or nullrequired
users[].​special_rolesstring or nullrequired
users[].​skillsstring or nullrequired
users[].​profilestring or nullrequired
users[].​languagestring or nullrequired

UI language

users[].​languagesstring or nullrequired

Spoken languages

users[].​telephone_officestring or nullrequired

Mobile phone (Office)

users[].​phone_extensionstring or nullrequired

Landline phone (Office)

users[].​telephonestring or nullrequired

Mobile phone (Private)

users[].​entry_datestring or null(date)required

Date of joining the company

users[].​leave_datestring or null(date)required

Date of leaving the company - if set in the future, the employee will be archived on that date

users[].​typestring(UserType)required
Enum"user""guest""tax_advisor"
users[].​planstring(UserPlan)required
Enum"basic""standard""external""advanced""expert""guest""tax_advisor""not_assigned"
users[].​is_ownerbooleanrequired

Is Kanbert space owner

users[].​avatarFileData (object) or nullrequired
Any of:
object FileData Recursive
users[].​userGroupsArray of objects(UsergroupData)
users[].​userGroupsCountinteger
users[].​userGroupsExistsboolean
users[].​customFieldsobjectrequired

The key is the field name for your custom field, value type depends on the field type

users[].​customFields.​property name*string or boolean or integer or nulladditional property
Any of:
string
users[].​created_atstring(date-time)required
users[].​deleted_atstring or null(date-time)required
Response
application/json
{ "id": "string", "external_id": "string", "name": "string", "is_team": true, "users": [ {} ] }

Users

Operations