List the competences an employee can still be given

Lists the active competences an employee does not have yet, optionally filtered by name.

The picker list for adding a competence to an employee: every ACTIVE competence of the catalogue minus the ones the employee already has (with any value). An unknown userId simply returns every active competence. The complete list is returned (no paging), ordered by group name and then competence name.

Use it to:

Offer the competences that can be added to an employee before calling create or batch create

Not for:

Reading the employee's current competences — GET /v2/employee-competences

Behaviour:

Idempotent.
Safe to retry.
Changes are visible to the next read immediately.

Call first: GET /v1/user

Next: POST /v2/employee-competences, POST /v2/employee-competences/bulk

See also: GET /v2/employee-competences

curl -X GET "https://app3.timelog.com/your-account/api/v2/employee-competences/available?userId=123&searchText=example_string" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

import requests
import json

url = "https://app3.timelog.com/your-account/api/v2/employee-competences/available?userId=123&searchText=example_string"
headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_TOKEN"
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch("https://app3.timelog.com/your-account/api/v2/employee-competences/available?userId=123&searchText=example_string", {
  method: "GET",
  headers: {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_TOKEN"
}
});

const data = await response.json();
console.log(data);

package main

import (
    "fmt"
    "net/http"
)

func main() {

    req, err := http.NewRequest("GET", "https://app3.timelog.com/your-account/api/v2/employee-competences/available?userId=123&searchText=example_string", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    fmt.Println("Response Status:", resp.Status)
}

require 'net/http'
require 'json'

uri = URI('https://app3.timelog.com/your-account/api/v2/employee-competences/available?userId=123&searchText=example_string')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'

response = http.request(request)
puts response.body

{
  "Entities": [
    {
      "Properties": {
        "GroupId": 123,
        "GroupName": "John Doe",
        "CompetenceId": 123,
        "CompetenceName": "John Doe"
      },
      "Links": [
        {
          "Href": "example_string",
          "Rel": "example_string"
        }
      ],
      "Actions": [
        {}
      ]
    }
  ],
  "Links": [
    {
      "Href": "example_string",
      "Rel": "example_string"
    }
  ]
}

{
  "Code": 200,
  "Message": "Invalid model state error.",
  "Details": [
    "…"
  ],
  "Parameters": "…",
  "Url": "https://app{server-number}.timelog.com/{account}/api/v2/employee-competences/available"
}

{
  "code": "UnsupportedApiVersion",
  "error": "No route providing a controller name with API version '2' was found to match HTTP method 'GET' and request URI 'https://app{server-number}.timelog.com/{account}/api/v2/employee-competences/available'.",
  "type": "https://docs.api-versioning.org/problems#unsupported",
  "title": "Unsupported API version",
  "status": 405,
  "detail": "The requested resource with API version '2' does not support HTTP method 'GET'."
}

{
  "Code": 100,
  "Message": "Unknown error occur in system, please contact system administrator.",
  "Details": [],
  "Parameters": "…",
  "Url": "https://app{server-number}.timelog.com/{account}/api/v2/employee-competences/available"
}

GET

/v2/employee-competences/available

GET

Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token

OAuth 2.0 bearer token, sent as Authorization: Bearer <token>. JWT and reference tokens are both accepted. The token must carry the required scope (default tlp). The token's sub claim is the acting user. A token WITHOUT sub (client-credentials) acts as the system service user. If the sub user cannot log in (inactive, locked, deleted), the request is rejected with 401 — it is no longer let through without a user.

query

userIdinteger

Required

UserID of the employee whose existing competences are excluded. Missing → 405 (captured). Not validated: an unknown ID excludes nothing. Refers to UserRead.UserID. Look up valid values with GET /v1/user.

Format: int32

query

searchTextstring

Matched with LIKE '%text%': % and _ in the text act as wildcards. Filters on EmployeeCompetenceAvailableRead.CompetenceName (contains).

Request Preview

Response

Response will appear here after sending the request

Authentication

header

Authorizationstring

Required

Bearer token. OAuth 2.0 bearer token, sent as Authorization: Bearer <token>. JWT and reference tokens are both accepted. The token must carry the required scope (default tlp).

The token's sub claim is the acting user. A token WITHOUT sub (client-credentials) acts as the system service user. If the sub user cannot log in (inactive, locked, deleted), the request is rejected with 401 — it is no longer let through without a user.