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

> ## Agent Instructions
> Phaseo Gateway base URL: https://api.phaseo.app/v1. Send `Authorization: Bearer $PHASEO_API_KEY` with every request.
> Model IDs look like `provider/model`, for example `openai/gpt-6-astra`. Do not guess IDs: list them with `GET /v1/models` or check https://phaseo.app/models. `phaseo/free` routes to an available free model and needs no wallet balance.
> For new text integrations prefer `POST /v1/responses`. `POST /v1/chat/completions` (OpenAI format) and `POST /v1/messages` (Anthropic format) suit existing code.
> The full API contract is https://phaseo.app/docs/openapi/v1/openapi.yaml. Official SDKs: `@phaseo/sdk` (TypeScript) and `phaseo` (Python), plus Go, C#, PHP, Ruby and Rust.
> Search these docs over MCP at https://phaseo.app/docs/mcp, and install Phaseo skills with `npx skills add https://phaseo.app/docs`. If a page is wrong or out of date, report it with the MCP `submit_feedback` tool.
> Manage Phaseo accounts with the `phaseo` CLI (`npm install -g @phaseo/cli`, then `phaseo login` or `phaseo login --device-code`), the `/v1` Management API or the MCP server at `https://mcp.phaseo.app/mcp?access=manage`. Do not send users to the dashboard for account tasks. A person is still needed for sign-up, approving a sign-in, paying the first top-up on the checkout link that `phaseo credits add` returns when no card is saved, confirming each saved-card top-up from the emailed link, and account security (password, MFA, passkeys). Create API keys with `phaseo keys create --name <name> --json`; never guess one. Credit top-ups need `phaseo login --scopes billing:write` first. Task map: https://phaseo.app/docs/v1/developers/manage-from-an-agent.md.

# عرض قائمة النشاط

> استرجع أحدث نشاط API لمساحة عمل مع نطاق زمني قابل للضبط وترقيم للصفحات.

> [!NOTE]
>
> تتطلب نقطة النهاية هذه مفتاح API للإدارة. ولا تُقبل مفاتيح Gateway API العادية.


## OpenAPI

````yaml ar/openapi/v1/openapi.localized.yaml GET /activity
openapi: 3.0.3
info:
  title: Phaseo Gateway API
  description: >-
    واجهة API للبوابة تتيح الوصول إلى نماذج ذكاء اصطناعي متنوعة عبر نقاط نهاية
    متوافقة مع OpenAI.
  version: 1.0.0
  contact:
    name: Phaseo
    url: https://phaseo.app
    email: danielbutler500@gmail.com
servers:
  - url: https://api.phaseo.app/v1
    description: التوجيه العالمي
security:
  - BearerAuth: []
tags:
  - name: Gateway
    description: Core Phaseo Gateway operations.
paths:
  /activity:
    get:
      tags:
        - Gateway
      summary: عرض قائمة النشاط
      description: >-
        يعرض أحدث نشاط للطلبات في مساحة العمل التي تمت المصادقة عليها. يلزم
        مفتاح API للإدارة.
      operationId: getActivity
      parameters:
        - name: workspace_id
          in: query
          description: >-
            تجاوز اختياري لمساحة العمل. يجب أن يطابق مساحة العمل التي تمت
            المصادقة عليها، إلا عند استخدام مستدعٍ داخلي للتحكم.
          schema:
            type: string
            format: uuid
        - name: days
          in: query
          description: عدد أيام النشاط المطلوب تضمينها.
          schema:
            type: integer
            default: 30
            minimum: 1
        - name: limit
          in: query
          description: الحد الأقصى لعدد صفوف النشاط التي سيتم عرضها.
          schema:
            type: integer
            default: 50
            minimum: 1
            maximum: 250
        - name: offset
          in: query
          description: عدد صفوف النشاط التي سيتم تخطيها لأغراض ترقيم الصفحات.
          schema:
            type: integer
            minimum: 0
            default: 0
      responses:
        '200':
          description: تم الاسترجاع
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceActivityResponse'
        '400':
          description: خطأ في الطلب غير الصحيح
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: خطأ عدم التصريح
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: خطأ الوصول المحظور
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: خطأ داخلي في الخادم
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    WorkspaceActivityResponse:
      type: object
      required:
        - ok
        - period_days
        - limit
        - offset
        - total
        - total_cost_cents
        - activity
      properties:
        ok:
          type: boolean
          enum:
            - true
        period_days:
          type: integer
          example: 30
        limit:
          type: integer
          example: 50
        offset:
          type: integer
          example: 0
        total:
          type: integer
          example: 1250
        total_cost_cents:
          type: number
          example: 42.75
        activity:
          type: array
          items:
            $ref: '#/components/schemas/WorkspaceActivityEntry'
      additionalProperties: false
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        ok:
          type: boolean
          example: false
        error:
          description: >-
            كائن الخطأ (`code` و`message` و`type` و`param` و`metadata`
            الاختياري) الذي تقرؤه حزم SDK المتوافقة مع OpenAI. كانت الاستجابات
            السابقة تُرجع سلسلة الرمز هنا؛ وهي تُرجع الآن أيضًا في `code` على
            المستوى الأعلى.
          oneOf:
            - type: string
            - $ref: '#/components/schemas/ErrorObject'
          example:
            code: validation_error
            message: 'Unknown parameter: foo'
            type: invalid_request_error
            param: foo
        code:
          type: string
          description: رمز الخطأ، بالقيمة نفسها الموجودة في `error.code`.
          example: validation_error
        message:
          type: string
          example: Human-readable error message
        description:
          type: string
          example: Additional error details.
        generation_id:
          type: string
          example: G-abc123
        status_code:
          type: integer
          example: 502
        error_type:
          type: string
          enum:
            - user
            - system
          example: system
        error_origin:
          type: string
          enum:
            - user
            - gateway
            - upstream
          example: upstream
        reason:
          type: string
          example: all_candidates_failed
        attempt_count:
          type: integer
          example: 2
        failed_providers:
          type: array
          items:
            type: string
          example:
            - google-ai-studio
            - openai
        failed_statuses:
          type: array
          items:
            type: integer
          example:
            - 403
            - 429
        upstream_error:
          $ref: '#/components/schemas/ErrorUpstreamError'
        failure_sample:
          type: array
          items:
            $ref: '#/components/schemas/ErrorFailureSampleItem'
        provider_failure_diagnostics:
          $ref: '#/components/schemas/ErrorProviderFailureDiagnostics'
        routing_diagnostics:
          $ref: '#/components/schemas/ErrorRoutingDiagnostics'
        provider_candidate_diagnostics:
          $ref: '#/components/schemas/ErrorProviderCandidateDiagnostics'
        provider_enablement:
          $ref: '#/components/schemas/ErrorProviderEnablementDiagnostics'
        missing_pricing_providers:
          type: array
          items:
            type: string
        provider_payment_required_provider:
          type: string
          example: openai
        provider_payment_required_support_notice:
          type: string
          example: >-
            Our upstream provider billing appears to be unavailable. If this
            persists, contact support.
        details:
          type: array
          items:
            type: object
            additionalProperties: true
      additionalProperties: true
    WorkspaceActivityEntry:
      type: object
      required:
        - request_id
        - provider
        - model
        - endpoint
        - usage
        - cost_cents
        - latency_ms
        - timestamp
      properties:
        request_id:
          type: string
          nullable: true
          example: req_abc123
        provider:
          type: string
          nullable: true
          example: openai
        model:
          type: string
          nullable: true
          example: openai/gpt-4.1
        endpoint:
          type: string
          nullable: true
          example: chat.completions
        usage:
          type: object
          nullable: true
          additionalProperties: true
        cost_cents:
          type: number
          example: 1.25
        latency_ms:
          type: integer
          nullable: true
          example: 842
        timestamp:
          type: string
          format: date-time
          nullable: true
          example: '2026-04-28T12:30:00.000Z'
      additionalProperties: false
    ErrorObject:
      type: object
      description: >-
        خطأ من البوابة بالشكل الذي تقرؤه حزم SDK من OpenAI. يُحدَّد `type` من
        حالة HTTP: invalid_request_error لمعظم رموز 4xx، وauthentication_error
        (401)، وinsufficient_quota (402)، وpermission_error (403)،
        وnot_found_error (404)، وrate_limit_error (429)، وservice_unavailable
        (503)، وoverloaded (529)، وserver_error لبقية رموز 5xx.
      required:
        - code
        - message
        - type
      properties:
        code:
          type: string
          description: رمز خطأ قابل للقراءة آليًا.
          example: validation_error
        message:
          type: string
          description: شرح مقروء لسبب الإخفاق.
          example: 'Unknown parameter: foo'
        type:
          type: string
          description: نوع الخطأ، وفق أنواع الأخطاء الموثّقة لدى OpenAI.
          enum:
            - invalid_request_error
            - authentication_error
            - permission_error
            - not_found_error
            - rate_limit_error
            - insufficient_quota
            - server_error
            - service_unavailable
            - overloaded
          example: invalid_request_error
        param:
          type: string
          nullable: true
          description: معامل الطلب الذي تسبّب في الخطأ، عند معرفته.
          example: foo
        metadata:
          type: object
          description: >-
            تفاصيل منظّمة تُرجع أيضًا على المستوى الأعلى، مثل المزوّد الذي أخفق
            و`reason` و`failed_statuses` و`retry_after_seconds`
            و`upstream_error`.
          additionalProperties: true
      additionalProperties: true
    ErrorUpstreamError:
      type: object
      properties:
        code:
          type: string
          nullable: true
          example: PERMISSION_DENIED
        message:
          type: string
          nullable: true
          example: The caller does not have permission.
        description:
          type: string
          nullable: true
        param:
          type: string
          nullable: true
    ErrorFailureSampleItem:
      type: object
      properties:
        provider:
          type: string
          nullable: true
        type:
          type: string
          nullable: true
        status:
          type: integer
          nullable: true
        upstream_error_code:
          type: string
          nullable: true
        upstream_error_message:
          type: string
          nullable: true
        upstream_error_description:
          type: string
          nullable: true
        upstream_error_param:
          type: string
          nullable: true
        upstream_payload_preview:
          type: string
          nullable: true
        retryable:
          type: boolean
          nullable: true
      additionalProperties: true
    ErrorProviderFailureDiagnostics:
      type: object
      properties:
        category:
          type: string
          enum:
            - credentials_not_configured
            - credentials_invalid_or_forbidden
            - provider_access_missing
            - region_or_project_restriction
            - model_unavailable_for_endpoint
            - rate_limited
            - server_error
        hint:
          type: string
        provider:
          type: string
          nullable: true
    ErrorRoutingDiagnostics:
      type: object
      properties:
        filterStages:
          type: array
          items:
            type: object
            properties:
              stage:
                type: string
              beforeCount:
                type: integer
              afterCount:
                type: integer
              droppedProviders:
                type: array
                items:
                  type: object
                  properties:
                    providerId:
                      type: string
                      nullable: true
                    reason:
                      type: string
                      nullable: true
                  additionalProperties: true
            additionalProperties: true
      additionalProperties: true
    ErrorProviderCandidateDiagnostics:
      type: object
      properties:
        totalProviders:
          type: integer
        supportsEndpointCount:
          type: integer
        candidateCount:
          type: integer
        droppedUnsupportedEndpoint:
          type: array
          items:
            type: string
        droppedMissingAdapter:
          type: array
          items:
            type: object
            properties:
              providerId:
                type: string
                nullable: true
              endpoint:
                type: string
                nullable: true
            additionalProperties: true
      additionalProperties: true
    ErrorProviderEnablementDiagnostics:
      type: object
      properties:
        capability:
          type: string
        providersBefore:
          type: array
          items:
            type: string
        providersAfter:
          type: array
          items:
            type: string
        dropped:
          type: array
          items:
            type: object
            properties:
              providerId:
                type: string
                nullable: true
              reason:
                type: string
                nullable: true
            additionalProperties: true
      additionalProperties: true
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: المصادقة باستخدام رمز Bearer

````

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