v1

latestOpenAPI 3.1.02026-08-04164270844.7 KB

Skills

List all the powers

🔑

Required OAuth scope: skillsPowers:read.

📖

This endpoint is paginated with a page size of 500 powers. For more information, see the Pagination guide.

Lists all the powers.

get/api/v2/skills/powers

Query parameters

eqstring

Filter on values equal to the given one

instring[]

Filter on values including the given ones

Filter on skillId property with LHS bracket notation.

Expected value format is a string.

{
  "eq": "loremIpsum",
  "in": [
    "loremIpsum"
  ]
}

eq'toAssess' | 'pendingValidation' | 'validated'

Filter on values equal to the given one

ne'toAssess' | 'pendingValidation' | 'validated'

Filter on values not equal to the given one

Filter on status property with LHS bracket notation.

Expected value format is a string (toAssess, pendingValidation, validated).

{
  "eq": "toAssess",
  "ne": "toAssess"
}

eqstring ObjectId

Filter on values equal to the given one

instring[]

Filter on values including the given ones

Filter on userId property with LHS bracket notation.

Expected value format is a valid ID (24 digits or letters).

{
  "eq": "507f1f77bcf86cd799439011",
  "in": [
    "507f1f77bcf86cd799439011"
  ]
}

Headers

360-api-version'v2.0' required

The version of the API.

Response

Returns one page of 500 powers.

_idstring required

The unique ID of the power.

externalIdstring

The unique external ID of the power.

skillIdstring required

The unique ID of the skill.

skillExternalIdstring

The unique external ID of the skill.

userIdstring ObjectId required

The unique ID of the user.

createdAtstring date-time

The date and time when the power was created, in the YYYY-MM-DDThh:mm:ss.sssZ format (ISO 8601 in Coordinated Universal Time (UTC)).

updatedAtstring date-time

The date and time when the power was last updated, in the YYYY-MM-DDThh:mm:ss.sssZ format (ISO 8601 in Coordinated Universal Time (UTC)).

status'toAssess' | 'pendingValidation' | 'validated' required

The status of the power.

Example response

[
  {
    "_id": "POW1710749206766wgc0",
    "externalId": "SKI17085916596770pzz",
    "skillId": "SKI17080760942940q3d",
    "skillExternalId": "SKI17080760942940q3d",
    "userId": "642edc18862a6c95d80d0ea1",
    "createdAt": "2024-04-17T16:32:39.347Z",
    "updatedAt": "2024-09-30T16:56:39.911Z",
    "qualifiers": [
      {
        "_id": "SKQ1701914859202x53r",
        "currentValue": "Intermediate",
        "currentValueId": "clgz9uqmm0001357bbgggvr1m"
      }
    ]
  }
]