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

# The agent kinds the wizard offers

> The 18 agent kinds this API can create, grouped by `category`: `signal` (13 market monitors watching job changes, LinkedIn posts, job postings, headcount, funding or the open web), `watcher` (3 kinds that watch the people or companies of one of your EXISTING lists) and `scrape` (2 one-shot LinkedIn engagement scrapes). `type` is the slug to POST to `/business/agents/{type}`; that operation's request body is the kind's own config. Static catalogue — it reads no account data and never changes between calls. Counts against the agents rate-limit bucket (30/min, 2,000/day).

Errors:
- `429` `RATE_LIMITED` — The agents bucket is exhausted: 30 requests per minute or 2,000 per day per token owner, shared by every /business/agents operation (a 429 raised by the agents service is relayed with this code too). Retry after the `Retry-After` header.
- `500` `UNEXPECTED_ERROR` — The agents service failed (5xx, refused service credential, or a timeout after 60s) or the rate limiter was unavailable. Retry later; quote `request_id` to support.

Requires one of the following token scopes: agents.



## OpenAPI

````yaml /openapi.json get /business/agents/signal-types
openapi: 3.1.0
info:
  title: Fuse Business API
  version: 1.0.0
  description: >-
    External API for lists, campaigns, prospect search and contacts.
    Authenticate with your API token as HTTP Basic. All paths are under /api/v1.
servers:
  - url: https://api.tryfuse.ai/api/v1
    description: Production
security:
  - basicAuth: []
tags:
  - name: Lists
  - name: Custom columns
  - name: Smart columns
  - name: Exports
  - name: Campaigns
  - name: Knowledge hubs
  - name: Analytics
  - name: Website intent
  - name: Account
  - name: Prospect search
  - name: Campaign steps
  - name: Scheduled sends
  - name: Campaign templates
  - name: Agents
  - name: Research
  - name: Company search
  - name: Saved searches
  - name: Folders
  - name: Contacts
paths:
  /business/agents/signal-types:
    get:
      tags:
        - Agents
      summary: The agent kinds the wizard offers
      description: >-
        The 18 agent kinds this API can create, grouped by `category`: `signal`
        (13 market monitors watching job changes, LinkedIn posts, job postings,
        headcount, funding or the open web), `watcher` (3 kinds that watch the
        people or companies of one of your EXISTING lists) and `scrape` (2
        one-shot LinkedIn engagement scrapes). `type` is the slug to POST to
        `/business/agents/{type}`; that operation's request body is the kind's
        own config. Static catalogue — it reads no account data and never
        changes between calls. Counts against the agents rate-limit bucket
        (30/min, 2,000/day).


        Errors:

        - `429` `RATE_LIMITED` — The agents bucket is exhausted: 30 requests per
        minute or 2,000 per day per token owner, shared by every
        /business/agents operation (a 429 raised by the agents service is
        relayed with this code too). Retry after the `Retry-After` header.

        - `500` `UNEXPECTED_ERROR` — The agents service failed (5xx, refused
        service credential, or a timeout after 60s) or the rate limiter was
        unavailable. Retry later; quote `request_id` to support.


        Requires one of the following token scopes: agents.
      operationId: listAgentTypes
      responses:
        '200':
          description: Success
          headers:
            RateLimit-Limit:
              schema:
                type: integer
              description: Requests permitted in the current window.
            RateLimit-Remaining:
              schema:
                type: integer
              description: Requests remaining in the current window.
            RateLimit-Reset:
              schema:
                type: integer
              description: Seconds until the current window resets.
          content:
            application/json:
              schema:
                type: object
                required:
                  - signalTypes
                properties:
                  signalTypes:
                    type: array
                    minItems: 18
                    maxItems: 18
                    items:
                      type: object
                      required:
                        - type
                        - title
                        - category
                      properties:
                        type:
                          type: string
                          enum:
                            - web-monitor
                            - person-starting-new-job
                            - linkedin-posts
                            - person-discovery-via-filters
                            - job-postings
                            - job-posting-in-location
                            - first-person-hired-in-company-department
                            - first-person-hired-internationally
                            - company-headcount-growth
                            - company-headcount-growth-over-baseline
                            - company-department-headcount
                            - company-employee-job-location-in-two-countries
                            - funding-announcements
                            - people-watcher
                            - companies-watcher
                            - job-changes-watcher
                            - linkedin-profile
                            - linkedin-post
                          description: The slug to POST to at /business/agents/{type}.
                        title:
                          type: string
                          description: Human-readable name of the agent kind.
                        category:
                          type: string
                          enum:
                            - signal
                            - watcher
                            - scrape
                          description: >-
                            signal = watches the market; watcher = watches one
                            of your existing lists; scrape = one-shot LinkedIn
                            engagement scrape.
              example:
                signalTypes:
                  - type: web-monitor
                    title: Website monitor
                    category: signal
                  - type: person-starting-new-job
                    title: Person starting a new job
                    category: signal
                  - type: linkedin-posts
                    title: LinkedIn posts by topic
                    category: signal
                  - type: person-discovery-via-filters
                    title: Person discovery via filters
                    category: signal
                  - type: job-postings
                    title: Job postings by company
                    category: signal
                  - type: job-posting-in-location
                    title: Job postings in a location
                    category: signal
                  - type: first-person-hired-in-company-department
                    title: First hire in a department
                    category: signal
                  - type: first-person-hired-internationally
                    title: First international hire
                    category: signal
                  - type: company-headcount-growth
                    title: Company headcount growth
                    category: signal
                  - type: company-headcount-growth-over-baseline
                    title: Headcount growth over baseline
                    category: signal
                  - type: company-department-headcount
                    title: Department headcount
                    category: signal
                  - type: company-employee-job-location-in-two-countries
                    title: Employees across two countries
                    category: signal
                  - type: funding-announcements
                    title: Funding announcements
                    category: signal
                  - type: people-watcher
                    title: People watcher (from a list)
                    category: watcher
                  - type: companies-watcher
                    title: Companies watcher (from a list)
                    category: watcher
                  - type: job-changes-watcher
                    title: Job-changes watcher (from a list)
                    category: watcher
                  - type: linkedin-profile
                    title: LinkedIn profile scrape
                    category: scrape
                  - type: linkedin-post
                    title: LinkedIn post scrape
                    category: scrape
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - basicAuth: []
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            param:
              type:
                - string
                - 'null'
            doc_url:
              type:
                - string
                - 'null'
            request_id:
              type:
                - string
                - 'null'
          required:
            - code
            - message
      required:
        - error
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: >-
        Your API token (`af_…`) as the Basic-auth username, with an empty
        password.

````