Humanity

Humanity Skills API

The Skills API from Humanity — 3 operation(s) for skills.

GitHub OpenAPI

Operations 6

GET /skills GET Skills #
POST /skills POST Skills #
GET /skills/{id} GET Skill #
PUT /skills/{id} PUT Skill #
DELETE /skills/{id} DELETE Skill #
POST /skills/{skill_id}/employees/{employee_id}/expiration Get skills{skill id}employees{employee id}expiration #

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/humanity/refs/heads/main/openapi/humanity-skills-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/humanity:humanity-skills-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

humanity-skills-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: default Skills API
  version: '2.0'
servers:
- url: https://www.humanity.com/api/v2
security:
- sec0: []
tags:
- name: Skills
paths:
  /skills:
    get:
      summary: GET Skills
      description: '/skills

        Permission level: 7'
      operationId: get-skills
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n  \"status\": 1,\n  \"data\": [\n    {\n      \"id\": \"33679\",\n      \"name\": \"Account Welcome Calls\"\n    },\n    {\n      \"id\": \"95009\",\n      \"name\": \"Leadership\"\n    }\n  ],\n  \"token\": \"xxx\",\n  \"error\": null\n}"
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    example: 1
                    default: 0
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          example: '33679'
                        name:
                          type: string
                          example: Account Welcome Calls
                  token:
                    type: string
                    example: xxx
                  error: {}
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                type: object
                properties: {}
      deprecated: false
      x-readme:
        code-samples:
        - language: http
          code: https://www.humanity.com/api/v2/skills?access_token=xxxxxxx
        samples-languages:
        - http
      tags:
      - Skills
    post:
      summary: POST Skills
      description: '/skills

        Permission level: 5'
      operationId: post-skills
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - name
              properties:
                name:
                  type: string
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n    \"status\":1,\n    \"data\":{\n    \"id\":\"1496\",\n    \"title\":\"JQuery\"\n    },\n    \"token\":\"xxxxxxx\",\n    \"error\": null\n    }"
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    example: 1
                    default: 0
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        example: '1496'
                      title:
                        type: string
                        example: JQuery
                  token:
                    type: string
                    example: xxxxxxx
                  error: {}
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                type: object
                properties: {}
      deprecated: false
      x-readme:
        code-samples:
        - language: http
          code: https://www.humanity.com/api/v2/skills?access_token=xxxxxxx
        samples-languages:
        - http
      tags:
      - Skills
  /skills/{id}:
    get:
      summary: GET Skill
      description: '/skills/:id

        Permission level: 5'
      operationId: get-skill
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n  \"status\": 1,\n  \"data\": {\n    \"id\": \"33679\",\n    \"name\": \"Account Welcome Calls\"\n  },\n  \"token\": \"xxxx\",\n  \"error\": null\n}"
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    example: 1
                    default: 0
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        example: '33679'
                      name:
                        type: string
                        example: Account Welcome Calls
                  token:
                    type: string
                    example: xxxx
                  error: {}
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                type: object
                properties: {}
      deprecated: false
      x-readme:
        code-samples:
        - language: http
          code: https://www.humanity.com/api/v2/skills/33679?access_token=xxxxxxx
        samples-languages:
        - http
      tags:
      - Skills
    put:
      summary: PUT Skill
      description: '/skills/:id

        Permission level: 5'
      operationId: put-skill
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: integer
          format: int32
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - name
              properties:
                name:
                  type: string
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n  \"status\": 1,\n  \"data\": {\n    \"id\": null,\n    \"name\": \"Account welcome calls\"\n  },\n  \"token\": \"xxxx\",\n  \"error\": null\n}"
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    example: 1
                    default: 0
                  data:
                    type: object
                    properties:
                      id: {}
                      name:
                        type: string
                        example: Account welcome calls
                  token:
                    type: string
                    example: xxxx
                  error: {}
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                type: object
                properties: {}
      deprecated: false
      x-readme:
        code-samples:
        - language: http
          code: https://www.humanity.com/api/v2/skills/123?access_token=xxxxxxx
        samples-languages:
        - http
      tags:
      - Skills
    delete:
      summary: DELETE Skill
      description: '/skills/:id

        Permission level: 5'
      operationId: delete-skill
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n   \"status\":1,\n   \"data\":\"\",\n   \"token\":\"xxxxxxx\",\n \t \"error\":null\n}"
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    example: 1
                    default: 0
                  data:
                    type: string
                    example: ''
                  token:
                    type: string
                    example: xxxxxxx
                  error: {}
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                type: object
                properties: {}
      deprecated: false
      x-readme:
        code-samples:
        - language: http
          code: https://www.humanity.com/api/v2/skills/123?access_token=xxxxxxx
        samples-languages:
        - http
      tags:
      - Skills
  /skills/{skill_id}/employees/{employee_id}/expiration:
    post:
      description: ''
      operationId: get_skills{skill_id}employees{employee_id}expiration
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                  data:
                    type: string
                    default: Skill settings successfully applied.
                  token:
                    type: string
                  error:
                    type: array
                    items:
                      type: string
              examples:
                New Example:
                  summary: New Example
                  value: "{\n    \"status\": 1,\n    \"data\": \"Skill settings successfully applied.\",\n    \"metadata\": [],\n    \"token\": \"xxxxxx\",\n    \"error\": null\n}{}"
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  property1:
                    type: string
      parameters:
      - in: path
        name: skill_id
        schema:
          type: integer
        required: true
      - in: path
        name: employee_id
        schema:
          type: integer
        required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                expiration_date:
                  type: string
                  description: YYYY-MM-DD
                notify_before:
                  type: string
                  enum:
                  - '15'
                  - '30'
                  - '60'
                  - '90'
      tags:
      - Skills
      summary: Get skills{skill id}employees{employee id}expiration
      x-summary-source: derived
components:
  securitySchemes:
    sec0:
      x-default: ''
      type: apiKey
      name: access_token
      in: query
x-readme-fauxas: true
x-provenance:
  method: searched
  source: https://platform.humanity.com/reference
  harvested: '2026-10-14'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://platform.humanity.com/reference/approve-availability.md
  - https://platform.humanity.com/reference/approve-series.md
  - https://platform.humanity.com/reference/create-availability-series.md
  - https://platform.humanity.com/reference/create-datapoints.md
  - https://platform.humanity.com/reference/create-driver.md
  - https://platform.humanity.com/reference/create-master-tasks.md
  - https://platform.humanity.com/reference/create-single-availability.md
  - https://platform.humanity.com/reference/create-skill-expiration-data.md
  - https://platform.humanity.com/reference/delete-availability.md
  - https://platform.humanity.com/reference/delete-custom-field.md
  - https://platform.humanity.com/reference/delete-datapoint.md
  - https://platform.humanity.com/reference/delete-driver.md
  - https://platform.humanity.com/reference/delete-employee-position.md
  - https://platform.humanity.com/reference/delete-employee.md
  - https://platform.humanity.com/reference/delete-forecastdatatype-by-unique_id.md
  - https://platform.humanity.com/reference/delete-forecastdatatypes.md
  - https://platform.humanity.com/reference/delete-future-availability.md
  - https://platform.humanity.com/reference/delete-leave-type.md
  - https://platform.humanity.com/reference/delete-leave.md
  - https://platform.humanity.com/reference/delete-location.md
  - https://platform.humanity.com/reference/delete-master-tasks.md
  - https://platform.humanity.com/reference/delete-message.md
  - https://platform.humanity.com/reference/delete-note.md
  - https://platform.humanity.com/reference/delete-nottice.md
  - https://platform.humanity.com/reference/delete-position-break-rules.md
  - https://platform.humanity.com/reference/delete-position.md
  - https://platform.humanity.com/reference/delete-ratecards.md
  - https://platform.humanity.com/reference/delete-shift-breaks.md
  - https://platform.humanity.com/reference/delete-shift.md
  - https://platform.humanity.com/reference/delete-shifts-approve.md
  - https://platform.humanity.com/reference/delete-skill.md
  - https://platform.humanity.com/reference/delete-timeclock-event.md
  - https://platform.humanity.com/reference/delete-timeclock-location.md
  - https://platform.humanity.com/reference/delete-timeclock-terminal.md
  - https://platform.humanity.com/reference/delete-timeclock.md
  - https://platform.humanity.com/reference/delete-training-module.md
  - https://platform.humanity.com/reference/delete-training-section.md
  - https://platform.humanity.com/reference/delete-wall-message.md
  - https://platform.humanity.com/reference/delete-weekly-availability.md
  - https://platform.humanity.com/reference/get-availability-approve.md
  - https://platform.humanity.com/reference/get-availability-by-series.md
  - https://platform.humanity.com/reference/get-availability-in-date-period.md
  - https://platform.humanity.com/reference/get-billing-packages.md
  - https://platform.humanity.com/reference/get-budget.md
  - https://platform.humanity.com/reference/get-business.md
  - https://platform.humanity.com/reference/get-clear.md
  - https://platform.humanity.com/reference/get-companies.md
  - https://platform.humanity.com/reference/get-company-settings.md
  - https://platform.humanity.com/reference/get-company.md
  - https://platform.humanity.com/reference/get-custom-field.md
  - https://platform.humanity.com/reference/get-custom-fields.md
  - https://platform.humanity.com/reference/get-custom-report.md
  - https://platform.humanity.com/reference/get-daily-peak-hours-report.md
  - https://platform.humanity.com/reference/get-data-points.md
  - https://platform.humanity.com/reference/get-datapoint-by-datapoints-unique-id.md
  - https://platform.humanity.com/reference/get-datapoint.md
  - https://platform.humanity.com/reference/get-datapoints.md
  - https://platform.humanity.com/reference/get-driver.md
  - https://platform.humanity.com/reference/get-drivers-from-company.md
  - https://platform.humanity.com/reference/get-employee-by-eid.md
  - https://platform.humanity.com/reference/get-employee-by-employee-id-copy.md
  - https://platform.humanity.com/reference/get-employee-manage-positions.md
  - https://platform.humanity.com/reference/get-employee-position.md
  - https://platform.humanity.com/reference/get-employee-report.md
  - https://platform.humanity.com/reference/get-employee-tasks.md
  - https://platform.humanity.com/reference/get-employee.md
  - https://platform.humanity.com/reference/get-employees-positions.md
  - https://platform.humanity.com/reference/get-employees-preclockin.md
  - https://platform.humanity.com/reference/get-employees.md
  - https://platform.humanity.com/reference/get-forecast-datatypes.md
  - https://platform.humanity.com/reference/get-forecastdatatype-by-unique_id.md
  - https://platform.humanity.com/reference/get-forecastdatatype.md
  - https://platform.humanity.com/reference/get-future-availability.md
  - https://platform.humanity.com/reference/get-group-permisions.md
  - https://platform.humanity.com/reference/get-group-reports.md
  - https://platform.humanity.com/reference/get-leave-types-1.md
  - https://platform.humanity.com/reference/get-leave-types-for-a-specific-employee.md
  - https://platform.humanity.com/reference/get-leave.md
  - https://platform.humanity.com/reference/get-leaves.md
  - https://platform.humanity.com/reference/get-location.md
  - https://platform.humanity.com/reference/get-locations.md
  - https://platform.humanity.com/reference/get-master-tasks.md
  - https://platform.humanity.com/reference/get-me.md
  - https://platform.humanity.com/reference/get-message.md
  - https://platform.humanity.com/reference/get-messages.md
  - https://platform.humanity.com/reference/get-multiple.md
  - https://platform.humanity.com/reference/get-note.md
  - https://platform.humanity.com/reference/get-notes.md
  - https://platform.humanity.com/reference/get-notices.md
  - https://platform.humanity.com/reference/get-nottice.md
  - https://platform.humanity.com/reference/get-number-of-requests.md
  - https://platform.humanity.com/reference/get-onnow.md
  - https://platform.humanity.com/reference/get-payroll-report.md
  - https://platform.humanity.com/reference/get-position-breakrules.md
  - https://platform.humanity.com/reference/get-position.md
  - https://platform.humanity.com/reference/get-positions.md
  - https://platform.humanity.com/reference/get-preclockins.md
  - https://platform.humanity.com/reference/get-publish.md
  - https://platform.humanity.com/reference/get-ratecard.md
  - https://platform.humanity.com/reference/get-ratecards.md
  - https://platform.humanity.com/reference/get-schedule-report.md
  - https://platform.humanity.com/reference/get-shift-breaks.md
  - https://platform.humanity.com/reference/get-shift-tasks.md
  - https://platform.humanity.com/reference/get-shift.md
  - https://platform.humanity.com/reference/get-shifts-approve.md
  - https://platform.humanity.com/reference/get-shifts.md
  - https://platform.humanity.com/reference/get-single-availability-slot.md
  - https://platform.humanity.com/reference/get-skill.md
  - https://platform.humanity.com/reference/get-skills.md
  - https://platform.humanity.com/reference/get-swap.md
  - https://platform.humanity.com/reference/get-timeclock-event.md
  - https://platform.humanity.com/reference/get-timeclock-location.md
  - https://platform.humanity.com/reference/get-timeclock-status.md
  - https://platform.humanity.com/reference/get-timeclock-terminal.md
  - https://platform.humanity.com/reference/get-timeclock.md
  - https://platform.humanity.com/reference/get-timeclocks-terminal.md
  - https://platform.humanity.com/reference/get-timeclocks.md
  - https://platform.humanity.com/reference/get-timesheets-report.md
  - https://platform.humanity.com/reference/get-trade.md
  - https://platform.humanity.com/reference/get-trades.md
  - https://platform.humanity.com/reference/get-training-module-comments.md
  - https://platform.humanity.com/reference/get-training-module-signature.md
  - https://platform.humanity.com/reference/get-training-module.md
  - https://platform.humanity.com/reference/get-training-modules.md
  - https://platform.humanity.com/reference/get-training-progress.md
  - https://platform.humanity.com/reference/get-training-section.md
  - https://platform.humanity.com/reference/get-training-sections.md
  - https://platform.humanity.com/reference/get-wall-messages.md
  - https://platform.humanity.com/reference/get-weekly-availability.md
  - https://platform.humanity.com/reference/get-workunits-daily-report.md
  - https://platform.humanity.com/reference/post-add-clock-time.md
  - https://platform.humanity.com/reference/post-availability-approve.md
  - https://platform.humanity.com/reference/post-budget.md
  - https://platform.humanity.com/reference/post-copy-datapoints-by-datatype-unique-id.md
  - https://platform.humanity.com/reference/post-copy-datapoints.md
  - https://platform.humanity.com/reference/post-custom-fields.md
  - https://platform.humanity.com/reference/post-datapoint.md
  - https://platform.humanity.com/reference/post-employee-clockin.md
  - https://platform.humanity.com/reference/post-employee-manage-positions.md
  - https://platform.humanity.com/reference/post-employee-position.md
  - https://platform.humanity.com/reference/post-employee.md
  - https://platform.humanity.com/reference/post-employees-preclockin.md
  - https://platform.humanity.com/reference/post-forecastdatatypes.md
  - https://platform.humanity.com/reference/post-future-availability.md
  - https://platform.humanity.com/reference/post-leave-request-all-day.md
  - https://platform.humanity.com/reference/post-leave-request-hourly.md
  - https://platform.humanity.com/reference/post-leave-types.md
  - https://platform.humanity.com/reference/post-location.md
  - https://platform.humanity.com/reference/post-message.md
  - https://platform.humanity.com/reference/post-note.md
  - https://platform.humanity.com/reference/post-nottice.md
  - https://platform.humanity.com/reference/post-position-break-rules.md
  - https://platform.humanity.com/reference/post-position.md
  - https://platform.humanity.com/reference/post-save-note.md
  - https://platform.humanity.com/reference/post-shift-breaks.md
  - https://platform.humanity.com/reference/post-shift.md
  - https://platform.humanity.com/reference/post-shifts-approve.md
  - https://platform.humanity.com/reference/post-skills.md
  - https://platform.humanity.com/reference/post-timeclock-event.md
  - https://platform.humanity.com/reference/post-timeclock-location.md
  - https://platform.humanity.com/reference/post-timeclock-terminal-clockout.md
  - https://platform.humanity.com/reference/post-timeclock-terminal-login.md
  - https://platform.humanity.com/reference/post-timeclock-terminal.md
  - https://platform.humanity.com/reference/post-timeclocks.md
  - https://platform.humanity.com/reference/post-trade.md
  - https://platform.humanity.com/reference/post-training-modules.md
  - https://platform.humanity.com/reference/post-training-section.md
  - https://platform.humanity.com/reference/post-wall-message.md
  - https://platform.humanity.com/reference/put-approving-leave-request.md
  - https://platform.humanity.com/reference/put-availability-approve.md
  - https://platform.humanity.com/reference/put-company-settings.md
  - https://platform.humanity.com/reference/put-custom-fields.md
  - https://platform.humanity.com/reference/put-datapoint-by-the-datatype-unique-id.md
  - https://platform.humanity.com/reference/put-datapoint.md
  - https://platform.humanity.com/reference/put-employee-clockout.md
  - https://platform.humanity.com/reference/put-employee-position.md
  - https://platform.humanity.com/reference/put-employee.md
  - https://platform.humanity.com/reference/put-enablingdisabling-leave-types-for-employees.md
  - https://platform.humanity.com/reference/put-forecastdatatypes-by-unique-id-copy.md
  - https://platform.humanity.com/reference/put-forecastdatatypes-by-unique-id.md
  - https://platform.humanity.com/reference/put-forecastdatatypes.md
  - https://platform.humanity.com/reference/put-future-availability.md
  - https://platform.humanity.com/reference/put-leave-type.md
  - https://platform.humanity.com/reference/put-leaves.md
  - https://platform.humanity.com/reference/put-location.md
  - https://platform.humanity.com/reference/put-manage-time-clock-1.md
  - https://platform.humanity.com/reference/put-manage-time-clock.md
  - https://platform.humanity.com/reference/put-note.md
  - https://platform.humanity.com/reference/put-nottice.md
  - https://platform.humanity.com/reference/put-position.md
  - https://platform.humanity.com/reference/put-ratecards.md
  - https://platform.humanity.com/reference/put-rejecting-leave-request.md
  - https://platform.humanity.com/reference/put-shift-breaks.md
  - https://platform.humanity.com/reference/put-shift.md
  - https://platform.humanity.com/reference/put-shifts-approve.md
  - https://platform.humanity.com/reference/put-skill.md
  - https://platform.humanity.com/reference/put-swap.md
  - https://platform.humanity.com/reference/put-timeclock-event.md
  - https://platform.humanity.com/reference/put-timeclock-terminal.md
  - https://platform.humanity.com/reference/put-timeclocks.md
  - https://platform.humanity.com/reference/put-trade.md
  - https://platform.humanity.com/reference/put-training-module-comments.md
  - https://platform.humanity.com/reference/put-training-module-complete.md
  - https://platform.humanity.com/reference/put-training-module.md
  - https://platform.humanity.com/reference/put-training-section-sync.md
  - https://platform.humanity.com/reference/put-training-section.md
  - https://platform.humanity.com/reference/put-wall-message.md
  - https://platform.humanity.com/reference/put-weekly-availability.md
  - https://platform.humanity.com/reference/reject-availability.md
  - https://platform.humanity.com/reference/timeclock-terminal-clockin.md
  - https://platform.humanity.com/reference/update-data-points.md
  - https://platform.humanity.com/reference/update-employee-task.md
  - https://platform.humanity.com/reference/update-employee-tasks.md
  - https://platform.humanity.com/reference/update-master-tasks.md
  merge:
    pages: 214
    deduped: 217
    conflicts_kept_first: 0