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

# Delete a Definition

> Remove one of your team's own definitions and free its slot. Signals it already produced stay readable under its slug; its company monitor, if any, is switched off. This cannot be undone — to stop sweeping temporarily, pause it with Update Definition (`active: false`) instead. Free (0 credits).



## OpenAPI

````yaml DELETE /signals/custom/definitions/{slug}
openapi: 3.1.0
info:
  title: Custom Signals API
  description: >-
    Signals produced by custom signal definitions — signal types defined as data
    (out of stealth, new office or market entry, first or founding hire, …)
    rather than the four built-in families. One endpoint serves every
    definition; `type` selects which. A free companion endpoint lists the
    definitions, and a team can create, start, pause and remove definitions of
    its own.
  license:
    name: MIT
  version: 2.1.0
servers:
  - url: https://www.trysignalbase.com/api/v2
security:
  - bearerAuth: []
paths:
  /signals/custom/definitions/{slug}:
    delete:
      summary: Delete a Custom Signal Definition
      description: >-
        Remove one of your team's own definitions and free its slot. Signals it
        already produced stay readable under its slug; its company monitor, if
        any, is switched off. This cannot be undone — to stop sweeping
        temporarily, pause it with Update Definition (`active: false`) instead.
        Free (0 credits).
      operationId: deleteCustomSignalDefinition
      parameters:
        - $ref: '#/components/parameters/DefinitionSlug'
      responses:
        '200':
          description: The definition was removed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DefinitionDeleteResponse'
              example:
                success: true
                data:
                  slug: first_sales_leader_x7k2
                  deleted: true
                meta:
                  endpoint: customSignals.delete
                  creditsUsed: 0
        '400':
          description: >-
            Bad request — a malformed body, slug or value; the message names the
            field
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                success: false
                error: description must be 20 to 1500 characters
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                success: false
                error: Invalid API key
        '403':
          description: >-
            Forbidden — custom signals need a Pro plan, or the team has no
            active subscription
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                success: false
                error: Custom signals are part of the Pro plan.
        '404':
          description: >-
            Not found — no definition with this slug belongs to your team
            (global definitions are not managed here), or custom signals are not
            enabled for your account yet
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                success: false
                error: Custom signal not found
        '429':
          description: Rate limited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                success: false
                error: Rate limit exceeded
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                success: false
                error: Internal server error
components:
  parameters:
    DefinitionSlug:
      name: slug
      in: path
      required: true
      schema:
        type: string
        pattern: ^[a-z][a-z0-9_]{2,39}$
      description: >-
        The definition's slug, as returned when it was created or by the
        catalogue.
  schemas:
    DefinitionDeleteResponse:
      type: object
      properties:
        success:
          type: boolean
        data:
          type: object
          properties:
            slug:
              type: string
            deleted:
              type: boolean
        meta:
          $ref: '#/components/schemas/Meta'
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        error:
          type: string
    Meta:
      type: object
      properties:
        endpoint:
          type: string
        creditsUsed:
          type: integer
        creditsRemaining:
          type: integer
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key
      description: API key authentication. Include as Bearer token in Authorization header.

````

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