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

> ## Agent Instructions
> SeedOps CLI browser login is the default for agents. Use --limit 1–50 to retrieve only needed signals. Read /agent-setup/prompt.md for setup. Never request credentials in a prompt.

# Save a company list of up to 5000 names or slugs

> The body is JSON with name and companies. Saving under an existing name replaces that list. Returns id, matched, unmatched and unmatchedExamples. Use the id as the list filter. Free.



## OpenAPI

````yaml /openapi.json post /lists
openapi: 3.1.0
info:
  title: SeedOps API
  version: 1.1.0
  description: >-
    Read-only published signals. Signed-in accounts are provisioned
    automatically. Accounts receive unlimited app browsing with 10 monthly
    searches and one-time free allowances of 500 CLI records and 100 API
    records. Each allowance is separate and never resets. After the free API
    records, keys use a prepaid balance at $0.005 per returned data record, with
    a custom dollar top-up starting at $10. No subscription is required for API
    keys. Account suspensions are preserved. A valid API key is required for
    every /v1 request; browser sessions are not accepted. App-wide access
    restrictions still apply. 600 requests/minute and 300 searches/minute per
    account, enforced in fixed UTC minute windows; approximate edge limits also
    protect requests. Successful data requests are counted for analytics; usage
    checks are free. UI searches and counts use separate session-based endpoints
    and never consume API usage. Usage is summarized by UTC calendar month; Paid
    Web access is unlimited; CLI records use the subscription’s billing-period
    allowance. Default first-page Web views are not counted. Insufficient API
    balance or CLI allowance returns 402. Browser-login CLI sessions have
    separate authentication and analytics at /api/cli/v1. Data consumption
    separately counts actual activity and company records returned: 50
    activities count as 50 records. Empty results, count-only totals, catalogues
    and failed requests add no consumed records. Idempotent replays do not count
    records again. Send an Idempotency-Key (8–128 letters, digits, underscores
    or hyphens) to replay the same successful request with the same credential
    without another counted request for 24 hours.
servers:
  - url: https://app.seedops.co/api/v1
security:
  - bearerAuth: []
paths:
  /lists:
    post:
      summary: Save a company list of up to 5000 names or slugs
      description: >-
        The body is JSON with name and companies. Saving under an existing name
        replaces that list. Returns id, matched, unmatched and
        unmatchedExamples. Use the id as the list filter. Free.
      operationId: createCompanyList
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - name
                - companies
              properties:
                name:
                  type: string
                companies:
                  type: array
                  items:
                    type: string
      responses:
        '200':
          description: Success. The result is wrapped in a data property.
        '400':
          description: Invalid input
        '401':
          description: Missing, expired or revoked credentials
        '402':
          description: Insufficient prepaid API records
        '403':
          description: Account disabled or insufficient scope
        '409':
          description: Idempotency conflict or request still in progress
        '429':
          description: Security rate limit exceeded
        '503':
          description: Temporary failure; retry with the same Idempotency-Key
        '504':
          description: >-
            query_timeout: the search took too long; narrow the filters and
            retry
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: SeedOps API key, created in the API dashboard.

````

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