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

# Get the number of Agents in your personal Space

> Returns the number of Agents that belong to no Space — the ones the Control Center lists
under "Personal" — as a single total, so callers that only need a count do not have to
fetch the full Agent list and count it themselves.

Personal Agents are not reachable through the Space endpoints: "Personal" is not a Space
and has no `spaceId`, so `GET /api/v1/spaces/{spaceId}/agents/count` cannot return them.
Use this endpoint for them instead.

Archived Agents are excluded unless `includeArchived` is set. Organization administrators
also count the personal Agents of other users in their organization, matching the
visibility the other Agent endpoints already grant over those same Agents.



## OpenAPI

````yaml GET /api/v1/agent/personal/count
openapi: 3.0.4
info:
  title: Sequentum Cloud API
  description: API endpoints for Sequentum Cloud
  version: v1
servers: []
security:
  - ApiKey: []
    Bearer: []
paths:
  /api/v1/agent/personal/count:
    get:
      tags:
        - ApiAgent
      summary: Get the number of Agents in your personal Space
      description: >-
        Returns the number of Agents that belong to no Space — the ones the
        Control Center lists

        under "Personal" — as a single total, so callers that only need a count
        do not have to

        fetch the full Agent list and count it themselves.


        Personal Agents are not reachable through the Space endpoints:
        "Personal" is not a Space

        and has no `spaceId`, so `GET /api/v1/spaces/{spaceId}/agents/count`
        cannot return them.

        Use this endpoint for them instead.


        Archived Agents are excluded unless `includeArchived` is set.
        Organization administrators

        also count the personal Agents of other users in their organization,
        matching the

        visibility the other Agent endpoints already grant over those same
        Agents.
      parameters:
        - name: includeArchived
          in: query
          description: Include archived Agents in the count
          schema:
            type: boolean
            default: false
      responses:
        '200':
          description: Returns the number of personal Agents
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentCountApiModel'
        '400':
          description: If the request is invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestError'
        '401':
          description: If the API key is missing or invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
      x-codeSamples:
        - lang: curl
          label: cURL
          source: |-
            curl https://dashboard.sequentum.com/api/v1/agent/personal/count \
              -H "Authorization: ApiKey $SEQUENTUM_API_KEY"

            # => { "totalCount": 238 }
        - lang: node
          label: Node.js
          source: >-
            const res = await
            fetch("https://dashboard.sequentum.com/api/v1/agent/personal/count",
            {
              headers: {
                "Authorization": `ApiKey ${process.env.SEQUENTUM_API_KEY}`,
              },
            });


            const { totalCount } = await res.json();

            console.log(`${totalCount} agents in your personal space`);
        - lang: python
          label: Python
          source: |-
            import os
            import requests

            response = requests.get(
                "https://dashboard.sequentum.com/api/v1/agent/personal/count",
                headers={"Authorization": f"ApiKey {os.environ['SEQUENTUM_API_KEY']}"},
            )
            response.raise_for_status()
            print(response.json()["totalCount"])  # e.g. 238
components:
  schemas:
    AgentCountApiModel:
      type: object
      properties:
        totalCount:
          type: integer
          description: Number of agents matching the request
          format: int32
      additionalProperties: false
      description: Agent count for a space or for the personal space
    BadRequestError:
      type: object
      properties:
        statusCode:
          type: integer
          format: int32
        statusDescription:
          type: string
          nullable: true
        message:
          type: string
          nullable: true
          readOnly: true
        severity:
          $ref: '#/components/schemas/ErrorSeverity'
        errorCode:
          type: string
          description: >-
            Optional machine-readable error code. When present, clients should
            switch on this

            value rather than parsing
            Sequentum.Enterprise.Core.ControllerError.Message. The controller
            pipeline serialises

            with System.Text.Json, which ignores the Newtonsoft attribute below,
            so an unset code

            reaches the client as `"errorCode": null` rather than being omitted
            - clients

            must treat null and absent alike.
          nullable: true
      additionalProperties: false
    ProblemDetails:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
      additionalProperties: {}
    ErrorSeverity:
      enum:
        - 0
        - 1
        - 2
        - 3
        - 4
      type: integer
      description: >-
        `0` = `Error`; `1` = `Unexpected`; `2` = `Fatal`; `3` = `Warning`; `4` =
        `Info`
      format: int32
  securitySchemes:
    ApiKey:
      type: apiKey
      description: >-
        API Key authorization header. Example: "Authorization: ApiKey
        {your-api-key}"
      name: Authorization
      in: header
    Bearer:
      type: http
      description: 'OAuth 2.0 Bearer token. Example: "Authorization: Bearer {access-token}"'
      scheme: bearer
      bearerFormat: JWT

````

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