> ## Documentation Index > Fetch the complete documentation index at: https://docs.ubik-agent.com/llms.txt > Use this file to discover all available pages before exploring further. # Lister les sessions d'agent > Récupère une liste paginée de sessions d'agent. Utilisez l'en-tête 'X-End-User-ID' pour filtrer par vos utilisateurs finaux. ## OpenAPI ````yaml /api-reference/openapi.fr.json get /agent-sessions openapi: 3.1.0 info: title: UBIK Public API description: Publicly accessible API endpoints for UBIK. version: '1.0' servers: - url: https://app.ubik-agent.com/api/v1 description: Production Server security: [] paths: /agent-sessions: get: tags: - Public API - Public API - Agent Sessions summary: Lister les sessions d'agent description: >- Récupère une liste paginée de sessions d'agent. Utilisez l'en-tête 'X-End-User-ID' pour filtrer par vos utilisateurs finaux. operationId: list_agent_sessions_agent_sessions_get parameters: - name: page in: query required: false schema: type: integer minimum: 1 default: 1 title: Page - name: limit in: query required: false schema: type: integer maximum: 100 minimum: 1 default: 20 title: Limit - name: X-End-User-ID in: header required: false schema: anyOf: - type: string - type: 'null' title: X-End-User-Id responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PublicPaginatedAgentSessionsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: PublicPaginatedAgentSessionsResponse: properties: items: items: $ref: '#/components/schemas/PublicAgentSession' type: array title: Items total: type: integer title: Total page: type: integer title: Page limit: type: integer title: Limit has_more: type: boolean title: Has More type: object required: - items - total - page - limit - has_more title: PublicPaginatedAgentSessionsResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError PublicAgentSession: properties: id: type: string format: uuid title: Id description: Unique identifier for the session. title: anyOf: - type: string - type: 'null' title: Title description: Title of the session. status: type: string title: Status description: Current status (e.g., 'active', 'completed'). model_name: anyOf: - type: string - type: 'null' title: Model Name description: Model being used. external_user_id: anyOf: - type: string - type: 'null' title: External User Id description: The external user ID associated with this session, if any. created_at: type: string format: date-time title: Created At description: Creation timestamp. updated_at: type: string format: date-time title: Updated At description: Last update timestamp. active_tools: items: $ref: '#/components/schemas/PublicToolListItem' type: array title: Active Tools description: List of tools enabled for this session. active_skills: items: $ref: '#/components/schemas/PublicSkillListItem' type: array title: Active Skills description: List of skills enabled for this session. documents: items: $ref: '#/components/schemas/PublicSessionDocumentListItem' type: array title: Documents description: List of documents linked to this session. workspaces: items: $ref: '#/components/schemas/PublicWorkspace' type: array title: Workspaces description: List of workspaces linked to this session. mcp_config: anyOf: - additionalProperties: true type: object - type: 'null' title: Mcp Config description: La configuration MCP actuellement active pour cette session. type: object required: - id - status - created_at - updated_at title: PublicAgentSession ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError PublicToolListItem: properties: id: type: string format: uuid title: Id description: L'identifiant unique de l'outil. name: type: string title: Name description: Le nom de l'outil. description: anyOf: - type: string - type: 'null' title: Description description: Une brève description de ce que fait l'outil. type: object required: - id - name title: PublicToolListItem PublicSkillListItem: properties: id: type: string format: uuid title: Id description: L'identifiant unique de la compétence. name: type: string title: Name description: Le nom de la compétence. description: anyOf: - type: string - type: 'null' title: Description description: Une brève description de ce que fait la compétence. type: object required: - id - name title: PublicSkillListItem PublicSessionDocumentListItem: properties: id: type: string format: uuid title: Id description: L'identifiant unique du document. name: type: string title: Name description: Le nom d'affichage du document. file_type: anyOf: - type: string - type: 'null' title: File Type description: Le type MIME du fichier du document. status: type: string title: Status description: Le statut de traitement actuel du document. created_at: type: string format: date-time title: Created At description: L'horodatage de la création du document. updated_at: type: string format: date-time title: Updated At description: L'horodatage de la dernière mise à jour du document. processing_pipeline: anyOf: - type: string - type: 'null' title: Processing Pipeline description: Le nom du pipeline de traitement utilisé pour ce document. error_message: anyOf: - type: string - type: 'null' title: Error Message description: Si le traitement a échoué, ce champ contiendra le message d'erreur. api_metadata: anyOf: - additionalProperties: true type: object - type: 'null' title: Api Metadata description: >- Métadonnées API personnalisées résolues pour l'utilisateur actuel. Utile pour récupérer des références externes stockées (par exemple {'internal_app_ref': 'REF-123'}). Note : Cette valeur est résolue en fonction de l'external_user_id de la requête. Un document partagé globalement mais aussi limité à un utilisateur spécifique peut renvoyer des métadonnées différentes selon qui demande. is_starred: type: boolean title: Is Starred description: >- Indique si le document est favori dans le contexte de la session actuelle. default: false type: object required: - id - name - status - created_at - updated_at title: PublicSessionDocumentListItem PublicWorkspace: properties: id: type: string format: uuid title: Id description: L'identifiant unique de l'espace de travail. name: type: string title: Name description: Le nom de l'espace de travail. description: anyOf: - type: string - type: 'null' title: Description description: Une brève description de l'objectif de l'espace de travail. is_default: anyOf: - type: boolean - type: 'null' title: Is Default description: >- Indique s'il s'agit de l'espace de travail par défaut pour l'utilisateur. default: false workspace_metadata: anyOf: - additionalProperties: true type: object - type: 'null' title: Workspace Metadata description: Métadonnées pour l'espace de travail. created_at: type: string format: date-time title: Created At description: L'horodatage de la création de l'espace de travail. updated_at: type: string format: date-time title: Updated At description: L'horodatage de la dernière mise à jour de l'espace de travail. document_count: type: integer title: Document Count description: Le nombre de documents contenus dans l'espace de travail. type: object required: - id - name - created_at - updated_at - document_count title: PublicWorkspace securitySchemes: APIKeyHeader: type: apiKey in: header name: X-API-KEY ````