EmployeeList the competences an employee can still be given

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

Not yet documented: examples; request → query params.

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"
{
  "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"
    }
  ]
}
GET
/v2/employee-competences/available
GET
Base URLstring

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

Bearer Token
Bearer Tokenstring
Required

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. > Not yet documented: how to obtain a token. > Not yet documented: token lifetime.

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. > Not yet documented: how to obtain a token. > Not yet documented: token lifetime.
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.

Not yet documented: how to obtain a token.

Not yet documented: token lifetime.

Query Parameters

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.

searchTextstring

Matched with LIKE '%text%': % and _ in the text act as wildcards.

Filters on EmployeeCompetenceAvailableRead.CompetenceName (contains).

Responses

Entitiesarray

Omitted (not []) when the list is empty.

Linksarray