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

# Delete a specific cached lookup result ahead of its natural expiry

> Free — does not spend credits, but IS rate-limited (unlike GET /v1/usage) since repeated deletes force real vendor spend on the next lookup. `params` is exactly the same request body the original lookup used. `endpoint` must be one of: "person.enrich", "person.email", "person.search", "email.verify", "company.enrich", "company.people", "company.search". The cache is shared across all customers, so this evicts the one shared entry for those exact params, not a per-customer copy.



## OpenAPI

````yaml /horizon/openapi.json delete /v1/cache
openapi: 3.1.0
info:
  title: Horizon API
  version: '1.0'
  description: >-
    Horizon is a prepaid-credits REST API for LinkedIn/company enrichment, email
    finding and verification, job search, and web search. Every request
    authenticates with an `Authorization: Bearer <key>` header and, on a billed
    endpoint, debits a fixed number of credits from your prepaid balance (see
    each endpoint's description for its exact cost). Check your balance any time
    with GET /v1/usage.
servers:
  - url: https://horizon.gravitygtm.com/api
security:
  - bearerAuth: []
paths:
  /v1/cache:
    delete:
      tags:
        - cache
      summary: Delete a specific cached lookup result ahead of its natural expiry
      description: >-
        Free — does not spend credits, but IS rate-limited (unlike GET
        /v1/usage) since repeated deletes force real vendor spend on the next
        lookup. `params` is exactly the same request body the original lookup
        used. `endpoint` must be one of: "person.enrich", "person.email",
        "person.search", "email.verify", "company.enrich", "company.people",
        "company.search". The cache is shared across all customers, so this
        evicts the one shared entry for those exact params, not a per-customer
        copy.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                endpoint:
                  type: string
                  enum:
                    - person.enrich
                    - person.email
                    - person.search
                    - email.verify
                    - company.enrich
                    - company.people
                    - company.search
                params:
                  type: object
                  description: >-
                    The exact same request body the original lookup used for
                    this endpoint.
              required:
                - endpoint
                - params
      responses:
        '200':
          description: >-
            200 — deletion attempted (deleted:false just means nothing was
            cached for these exact params).
          content:
            application/json:
              schema:
                type: object
                properties:
                  deleted:
                    type: boolean
                  request_id:
                    type: string
                required:
                  - deleted
                  - request_id
        '400':
          description: >-
            400 — unknown `endpoint`, params fail that endpoint's own schema, or
            these params are never cached at this layer ("not_cacheable").
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    enum:
                      - invalid_request
                      - not_cacheable
                  message:
                    type: string
                  request_id:
                    type: string
                required:
                  - error
                  - message
                  - request_id
        '401':
          description: >-
            401 unauthorized — missing or invalid `Authorization: Bearer <key>`
            header.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    enum:
                      - unauthorized
                  message:
                    type: string
                required:
                  - error
                  - message
        '429':
          description: 429 rate_limited — see Errors & Rate Limits.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    enum:
                      - rate_limited
                  message:
                    type: string
                  request_id:
                    type: string
                required:
                  - error
                  - message
                  - request_id
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````