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

# Get Network People Access

> Inspect current-workspace people's ``agent:execute`` admission.

Uses the existing workspace-management authorization gate. Membership and
ownership establish evaluation subjects; this never acts as those users.
At most 100 people and 100 agents are evaluated, with ``complete=False``
when either list is truncated. Results assume an authenticated participant
and do not represent the restrictions of a particular token or task.

An intentionally disabled membership directory exposes only the persisted
workspace owner, with ``directory_status=disabled``, ``total_people=None``
and ``complete=False``. An enabled directory that fails still returns 503.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/network/people-access
openapi: 3.1.0
info:
  description: >-
    Modular and extensible framework for building AI agents. This API requires
    JWT Bearer token authentication for most endpoints. Include your JWT token
    in the Authorization header. Public endpoints include /, /health, /docs,
    /redoc, and /openapi.json.
  title: AgentArea API
  version: 0.1.0
servers: []
security:
  - bearer: []
paths:
  /v1/network/people-access:
    get:
      tags:
        - v1
        - protected
        - network
      summary: Get Network People Access
      description: >-
        Inspect current-workspace people's ``agent:execute`` admission.


        Uses the existing workspace-management authorization gate. Membership
        and

        ownership establish evaluation subjects; this never acts as those users.

        At most 100 people and 100 agents are evaluated, with ``complete=False``

        when either list is truncated. Results assume an authenticated
        participant

        and do not represent the restrictions of a particular token or task.


        An intentionally disabled membership directory exposes only the
        persisted

        workspace owner, with ``directory_status=disabled``,
        ``total_people=None``

        and ``complete=False``. An enabled directory that fails still returns
        503.
      operationId: get_network_people_access_v1_network_people_access_get
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NetworkPeopleAccessResponse'
          description: Successful Response
      security:
        - HTTPBearer: []
components:
  schemas:
    NetworkPeopleAccessResponse:
      properties:
        access:
          items:
            $ref: '#/components/schemas/NetworkPersonAgentAccess'
          title: Access
          type: array
        complete:
          title: Complete
          type: boolean
        decision_source:
          const: agent_edge_admission
          default: agent_edge_admission
          title: Decision Source
          type: string
        directory_status:
          default: available
          enum:
            - available
            - disabled
          title: Directory Status
          type: string
        people:
          items:
            $ref: '#/components/schemas/NetworkPerson'
          title: People
          type: array
        total_agents:
          minimum: 0
          title: Total Agents
          type: integer
        total_people:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: Total People
        workspace_id:
          title: Workspace Id
          type: string
      required:
        - workspace_id
        - people
        - access
        - complete
        - total_people
        - total_agents
      title: NetworkPeopleAccessResponse
      type: object
    NetworkPersonAgentAccess:
      properties:
        agent_id:
          title: Agent Id
          type: string
        allowed:
          title: Allowed
          type: boolean
        reason:
          title: Reason
          type: string
        user_id:
          title: User Id
          type: string
      required:
        - user_id
        - agent_id
        - allowed
        - reason
      title: NetworkPersonAgentAccess
      type: object
    NetworkPerson:
      properties:
        display_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Display Name
        email:
          anyOf:
            - type: string
            - type: 'null'
          title: Email
        user_id:
          title: User Id
          type: string
      required:
        - user_id
      title: NetworkPerson
      type: object
  securitySchemes:
    bearer:
      bearerFormat: JWT
      description: JWT Bearer token for authentication
      scheme: bearer
      type: http
    HTTPBearer:
      scheme: bearer
      type: http

````