Shyft Customer > Skill API

The Customer > Skill API from Shyft — 4 operation(s) for customer > skill.

Operations 6

GET /api/customer/user_role/locations/2806/skills/managable load location's managable skills #
GET /api/customer/user_role/locations/2806/skills/{skill_id} load a single mangable skill #
PUT /api/customer/user_role/locations/2806/skills/{skill_id} update a skill #
DELETE /api/customer/user_role/locations/2806/skills/{skill_id} delete a skill #
POST /api/customer/user_role/locations/2806/skills create a new skill #
PUT /api/customer/user_role/locations/2806/assign_user_skills/7613 assign a location user's skills #

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/shyft-customer-skill-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.

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

OpenAPI Specification

shyft-customer-skill-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Shyft Customer Customer > Skill API
  description: Welcome to the Shyft Customer App API.
  version: 1.0.0
servers:
- url: http://{{host}}
- url: http://{{local-host}}
- url: http://{{sp3-host}}
- url: http://test-service.myshyft.com
- url: http://localhost:4001
- url: http://localhost:3000
- url: http://{{local-host}}api
- url: https://test-unfurl.myshyft.com
tags:
- name: Customer > Skill
paths:
  /api/customer/user_role/locations/2806/skills/managable:
    get:
      tags:
      - Customer > Skill
      summary: load location's managable skills
      parameters:
      - name: Session-Uukey
        in: header
        schema:
          type: string
        example: '{{session_uukey}}'
      - name: Content-Type
        in: header
        schema:
          type: string
        example: application/json
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
      operationId: getApiCustomerUserRoleLocations2806SkillsManagable
      x-operation-id-source: derived
  /api/customer/user_role/locations/2806/skills/{skill_id}:
    get:
      tags:
      - Customer > Skill
      summary: load a single mangable skill
      parameters:
      - name: skill_id
        in: path
        schema:
          type: string
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
      operationId: getApiCustomerUserRoleLocations2806SkillsBySkillId
      x-operation-id-source: derived
    put:
      tags:
      - Customer > Skill
      summary: update a skill
      requestBody:
        content:
          '*/*':
            schema:
              type: string
              example: '"{\n    \"skill\": {\n        \"name\": \"New Skill\"\n    }\n}"'
      parameters:
      - name: Session-Uukey
        in: header
        schema:
          type: string
        example: '{{session_uukey}}'
      - name: Content-Type
        in: header
        schema:
          type: string
        example: application/json
      - name: skill_id
        in: path
        schema:
          type: string
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
      operationId: putApiCustomerUserRoleLocations2806SkillsBySkillId
      x-operation-id-source: derived
    delete:
      tags:
      - Customer > Skill
      summary: delete a skill
      parameters:
      - name: Session-Uukey
        in: header
        schema:
          type: string
        example: '{{session_uukey}}'
      - name: Content-Type
        in: header
        schema:
          type: string
        example: application/json
      - name: skill_id
        in: path
        schema:
          type: string
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
      operationId: deleteApiCustomerUserRoleLocations2806SkillsBySkillId
      x-operation-id-source: derived
  /api/customer/user_role/locations/2806/skills:
    post:
      tags:
      - Customer > Skill
      summary: create a new skill
      requestBody:
        content:
          application/json:
            schema:
              type: object
              example:
                skill:
                  name: Sample Skill
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
      operationId: postApiCustomerUserRoleLocations2806Skills
      x-operation-id-source: derived
  /api/customer/user_role/locations/2806/assign_user_skills/7613:
    put:
      tags:
      - Customer > Skill
      summary: assign a location user's skills
      description: 'Description

        - - -

        - Update a location

        - `location_id` coulld be `ID` or `Swift Code`


        Params

        - - -

        Param | Values | R |Description

        --- | --- | --- | ---


        Headers

        - - -

        Header | Values | R |Description

        --- | --- | --- | ---


        Input

        - - -

        Attribute | Values | R |Description

        --- | --- | --- | ---

        shift_require_approval| true/false| | |

        require_approval| true/false| | |

        allow_tipping| true/false| | |

        admin_delete_content| true/false| | |'
      requestBody:
        content:
          '*/*':
            schema:
              type: string
              example: '"{\n    \"skill_ids\": [1, 2]\n}"'
      parameters:
      - name: Session-Uukey
        in: header
        schema:
          type: string
        example: '{{session_uukey}}'
      - name: Content-Type
        in: header
        schema:
          type: string
        example: application/json
      - name: response[put_return_resource]
        in: query
        schema:
          type: boolean
        example: 'true'
      responses:
        '200':
          description: OK
          headers:
            Server:
              schema:
                type: string
                example: nginx/1.19.3
            Date:
              schema:
                type: string
                example: Mon, 25 Apr 2022 21:49:56 GMT
            Content-Type:
              schema:
                type: string
                example: application/json; charset=utf-8
            Transfer-Encoding:
              schema:
                type: string
                example: chunked
            Connection:
              schema:
                type: string
                example: keep-alive
            X-Frame-Options:
              schema:
                type: string
                example: SAMEORIGIN
            X-XSS-Protection:
              schema:
                type: string
                example: 1; mode=block
            X-Content-Type-Options:
              schema:
                type: string
                example: nosniff
            X-Download-Options:
              schema:
                type: string
                example: noopen
            X-Permitted-Cross-Domain-Policies:
              schema:
                type: string
                example: none
            Referrer-Policy:
              schema:
                type: string
                example: strict-origin-when-cross-origin
            X-LS-License:
              schema:
                type: string
                example: All Rights Reserved © Coffee Enterprise
            X-LS-Application:
              schema:
                type: string
                example: Coffee Mobile
            X-Request-Method:
              schema:
                type: string
                example: none
            ETag:
              schema:
                type: string
                example: W/"7cb2ea80f413d2fd42a1a20b5dc33956"
            Cache-Control:
              schema:
                type: string
                example: max-age=0, private, must-revalidate
            Set-Cookie:
              schema:
                type: string
                example: _shyft_api_server_session=Q3ZEN2RLTmlmRStyTFZGLzAyTTEvSjhkSVVGbk5RNldBQnJqait6RDYvUEtxVkdIZHc3NkJFc0gvS0ZtbTNqM2UxSHFhcjh5TFVkOXF6cXRNZmFsOGc9PS0tM0pLWjlXTVBmVnF4VFQ3VWI5SVczdz09--88f57ca98d3b6ef36c9117109918a90af1e9f181; path=/; HttpOnly
            X-Rack-Dev-Mark-Env:
              schema:
                type: string
                example: BinLocalServer
            X-Request-Id:
              schema:
                type: string
                example: 290541ed-520c-446e-ab8b-b8f43989b008
            X-Runtime:
              schema:
                type: number
                example: '19.617205'
            Vary:
              schema:
                type: string
                example: Origin
          content:
            application/json:
              schema:
                type: object
              example:
                user:
                  _parent_object_id: null
                  id: 7613
                  active_org: 0
                  first_name: Kyle210
                  last_name: Lou
                  email: kyle@myshyft.com
                  gender: 0
                  user_group: 0
                  push_settings_list:
                    shift_push:
                      label: Shift Notifications
                      type: boolean
                    schedule_push:
                      label: Schedule Notifications
                      type: boolean
                    community_push:
                      label: Community Notifications
                      type: boolean
                  push_settings_list_array:
                  - label: Shift Notifications
                    type: boolean
                    key: shift_push
                  - label: Schedule Notifications
                    type: boolean
                    key: schedule_push
                  - label: Community Notifications
                    type: boolean
                    key: community_push
                  thumb_url: https://miniobackingstore.blob.core.windows.net/coffeemobile/images/thumb/18131_7613-20210721_144506_273.jpg?1626903906
                  gallery_url: https://miniobackingstore.blob.core.windows.net/coffeemobile/images/gallery/18131_7613-20210721_144506_273.jpg?1626903906
                  full_url: https://miniobackingstore.blob.core.windows.net/coffeemobile/images/full/18131_7613-20210721_144506_273.jpg?1626903906
                  current_position: Test
                  current_user_privilege_id: 21286
                  current_is_approved: true
                  current_is_admin: true
                  all_push: true
                  shift_push: true
                  schedule_push: true
                  community_push: true
                  cfg_ewa_ok: true
                  cfg_lock_profile: null
                  skill_ids:
                  - 3
                  - 2
                  - 1
                  locale: en
                  profile_image:
                    thumb_url: https://miniobackingstore.blob.core.windows.net/coffeemobile/images/thumb/18131_7613-20210721_144506_273.jpg?1626903906
                    gallery_url: https://miniobackingstore.blob.core.windows.net/coffeemobile/images/gallery/18131_7613-20210721_144506_273.jpg?1626903906
                    full_url: https://miniobackingstore.blob.core.windows.net/coffeemobile/images/full/18131_7613-20210721_144506_273.jpg?1626903906
                  recent_user_privilege:
                    id: 21286
                    wage: null
                    first_name: Kyle210
                    last_name: Lou
                    location_id: 2417
                    is_admin: true
                    position: Test
                    profile_image_thumb_url: https://miniobackingstore.blob.core.windows.net/coffeemobile/images/thumb/18131_7613-20210721_144506_273.jpg?1626903906
                    owner_id: 7613
                    chat_handle: 7e3a12108b84396ff25c0d12e9372a6b
                    phone_number: '18888888210'
                    is_approved: true
        '400':
          description: Bad Request
          headers:
            Server:
              schema:
                type: string
                example: nginx/1.19.3
            Date:
              schema:
                type: string
                example: Mon, 25 Apr 2022 22:23:37 GMT
            Content-Type:
              schema:
                type: string
                example: application/json; charset=utf-8
            Transfer-Encoding:
              schema:
                type: string
                example: chunked
            Connection:
              schema:
                type: string
                example: keep-alive
            X-Frame-Options:
              schema:
                type: string
                example: SAMEORIGIN
            X-XSS-Protection:
              schema:
                type: string
                example: 1; mode=block
            X-Content-Type-Options:
              schema:
                type: string
                example: nosniff
            X-Download-Options:
              schema:
                type: string
                example: noopen
            X-Permitted-Cross-Domain-Policies:
              schema:
                type: string
                example: none
            Referrer-Policy:
              schema:
                type: string
                example: strict-origin-when-cross-origin
            X-LS-License:
              schema:
                type: string
                example: All Rights Reserved © Coffee Enterprise
            X-LS-Application:
              schema:
                type: string
                example: Coffee Mobile
            X-Request-Method:
              schema:
                type: string
                example: none
            Cache-Control:
              schema:
                type: string
                example: no-cache
            Set-Cookie:
              schema:
                type: string
                example: _shyft_api_server_session=UHpEQmJ2bmRZNi92L1FZUHBWcS94dS9RVmNvQUJRcW1qWFhybGhZbE5FYVVrNnczS2JsV3pFaGdqUVhsTzhXTGUvdmUwd1dWTW9VUUZjOUlkd2h3WFE9PS0tUzAwSVQwNHdNRG5QWGtCNkxVL1RhZz09--c050efe0423773d28e1bb1baca1ae7aeb71c70f0; path=/; HttpOnly
            X-Rack-Dev-Mark-Env:
              schema:
                type: string
                example: BinLocalServer
            X-Request-Id:
              schema:
                type: string
                example: 4e606663-f7a0-4486-bcc4-c9d9e96a78bf
            X-Runtime:
              schema:
                type: number
                example: '24.075809'
            Vary:
              schema:
                type: string
                example: Origin
          content:
            application/json:
              schema:
                type: object
              example:
                errors:
                  skill_ids:
                  - Not allowed skills
      operationId: putApiCustomerUserRoleLocations2806AssignUserSkills7613
      x-operation-id-source: derived
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    noauthAuth:
      type: http
      scheme: noauth