> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gomarketbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Remove a skill from a supplier

> Revokes a skill, narrowing which offerings this supplier can be matched to. Expect the supplier to drop out of availability for every offering that required it, which is often more than the one you had in mind — list the supplier first if you want to see what they currently hold. The mapping is hard-deleted, and removing one that is not there still returns 204, so the status code says nothing about whether anything changed. Bookings already placed are unaffected.



## OpenAPI

````yaml /api-reference/openapi.json delete /v1/projects/{projectId}/suppliers/{supplierId}/skills/{skillId}
openapi: 3.0.0
info:
  title: MarketBox 2.0 Open API
  version: 1.0.0
  description: >-
    The MarketBox public API for building booking experiences. Core model:
    create an order, then draw its order items down into bookings. Single
    bookings reference an order item per service line; package bookings draw one
    PACKAGE item down across N sessions. To schedule a package, build a slate
    (POST /availability/package-slate) and book it by slateId (POST
    /orders/{orderId}/package-bookings). See the guides for end-to-end
    walkthroughs.
  contact:
    name: MarketBox support
servers:
  - url: https://apiv2.gomarketbox.com
    description: MarketBox Open API
security:
  - ApiKeyAuth: []
paths:
  /v1/projects/{projectId}/suppliers/{supplierId}/skills/{skillId}:
    delete:
      tags:
        - Suppliers
      summary: Remove a skill from a supplier
      description: >-
        Revokes a skill, narrowing which offerings this supplier can be matched
        to. Expect the supplier to drop out of availability for every offering
        that required it, which is often more than the one you had in mind —
        list the supplier first if you want to see what they currently hold. The
        mapping is hard-deleted, and removing one that is not there still
        returns 204, so the status code says nothing about whether anything
        changed. Bookings already placed are unaffected.
      parameters:
        - schema:
            type: string
            minLength: 1
            description: >-
              The project (tenant) that owns the resource. Every resource in
              this API is scoped to a project, and your API key is restricted to
              the projects it was issued for — a project outside that scope
              returns 403.
            example: prj_01kv60qgnef2kt3pvqgwmkbzfr
          required: true
          description: >-
            The project (tenant) that owns the resource. Every resource in this
            API is scoped to a project, and your API key is restricted to the
            projects it was issued for — a project outside that scope returns
            403.
          name: projectId
          in: path
        - schema:
            type: string
            minLength: 1
            description: The supplier — the person or resource delivering the service.
            example: sup_01kv60qh1k5xylm7r0c1qj8zpa
          required: true
          description: The supplier — the person or resource delivering the service.
          name: supplierId
          in: path
        - schema:
            type: string
            minLength: 1
            description: A skill a supplier can hold, used to match suppliers to services.
            example: skl_01kv60qgw8n3vlm5q9c0hj7ypx
          required: true
          description: A skill a supplier can hold, used to match suppliers to services.
          name: skillId
          in: path
      responses:
        '204':
          description: Removed
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
        '403':
          description: API key cannot access this project
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
        '404':
          description: Supplier not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
components:
  schemas:
    ErrorMessage:
      type: object
      properties:
        code:
          type: string
          description: Stable machine-readable error code, e.g. NOT_FOUND.
        message:
          type: string
          description: Human-readable description of what went wrong.
        statusCode:
          type: integer
          description: The HTTP status code of this response.
        requestId:
          type: string
          description: >-
            The id of this request, also returned as the X-Request-Id header.
            Quote it in a support ticket.
      required:
        - code
        - message
        - statusCode
        - requestId
      example:
        code: NOT_FOUND
        message: Booking not found
        statusCode: 404
        requestId: a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key minted in the MarketBox dashboard. Scope is restricted to the
        projects you select at creation time. Every route needs the key's
        standard API access (`*`) except `POST /v1/projects/{projectId}/events`,
        which needs `events:write`; a key without `*` is refused with 403
        `CAPABILITY_NOT_GRANTED`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.