Добавить сервер
  1. Каталог MCP
  2. s-b-e-n-s-o-n
  3. s-b-e-n-s-o-n/portkey-admin-mcp
s-b-e-n-s-o-n/portkey-admin-mcp

s-b-e-n-s-o-n/portkey-admin-mcp

от s-b-e-n-s-o-n
MCP-сервер, открывающий 150 инструментов Portkey Admin API: управляйте промптами, конфигами, аналитикой, ключами и пользователями прямо из MCP-клиента. Идеален для разработчиков, автоматизирующих A...

Portkey Admin MCP Server

Typing SVG

MCP server for the Portkey Admin API. Manage prompts, configs, analytics, API keys, and more from any MCP client.

npm version npm downloads CI Node.js License: MIT Mentioned in Awesome MCP Servers MCP Badge

portkey-admin-mcp MCP server

[!IMPORTANT] Maintenance mode. Portkey was acquired by Palo Alto Networks (completed 2026‑05‑29) and is being folded into the Prisma AIRS platform. The Portkey Admin API this server targets is live and unchanged as of June 2026, and this project still works end‑to‑end — but it is now in maintenance mode: security and dependency patches only, no new features, pending Palo Alto's post‑acquisition API roadmap. If the hosted Admin API is ever deprecated, point PORTKEY_BASE_URL at a self‑hosted Portkey gateway. See docs/audit-2026-06.md for the full assessment.

Quick Start

You need a Portkey API key with appropriate scopes. Get one from your Portkey dashboard under API Keys.

Claude Code

claude mcp add -e PORTKEY_API_KEY=your_key portkey-admin -- npx -y portkey-admin-mcp

Cursor / Windsurf / VS Code

Add to your MCP config (.cursor/mcp.json, .windsurf/mcp.json, or .vscode/mcp.json):

add_workspace_memberвнешний мир

Добавьте существующего пользователя организации в рабочее пространство с ролью. Требуется UUID user_id; используйте list_all_users, чтобы его найти, и сначала вызовите invite_user, если пользователь ещё не в организации.

Добавьте существующего пользователя организации в рабочее пространство с ролью. Требуется UUID user_id; используйте list_all_users, чтобы его найти, и сначала вызовите invite_user, если пользователь ещё не в организации.

Параметры

  • workspace_idstringобязательный

    The workspace ID to add the member to

  • user_idstringобязательный

    The user ID to add (must be a valid UUID from list_all_users, not an email address)

  • roleenumобязательный

    Role in the workspace

    adminmembermanager
cancel_log_exportвнешний мир

Отменяет ожидающее или выполняющееся задание экспорта логов, в отличие от start_log_export, которое ставит задачу в очередь, или delete_integration, которое удаляет источник. Эта операция навсегда останавливает экспорт, вступает в силу немедленно и не откатывает уже обработанные строки; чтобы повторить попытку, вызовите create_log_export и start_log_export снова.

Отменяет ожидающее или выполняющееся задание экспорта логов, в отличие от start_log_export, которое ставит задачу в очередь, или delete_integration, которое удаляет источник. Эта операция навсегда останавливает экспорт, вступает в силу немедленно и не откатывает уже обработанные строки; чтобы повторить попытку, вызовите create_log_export и start_log_export снова.

Параметры

  • export_idstringобязательный

    The unique ID of the log export to cancel

create_api_keyвнешний мир

Создайте API-ключ Portkey для аутентификации. Орговые ключи дают более широкий доступ; ключи рабочего пространства (workspace) действуют в его пределах. ПРЕДУПРЕЖДЕНИЕ: секрет ключа возвращается ОДИН РАЗ в результате работы инструмента и будет виден в транскриптах MCP и контексте LLM — сразу сохраните его в безопасном месте. После использования ключ немедленно предоставляет доступ в соответствии с его областями, настройками по умолчанию и лимитами. Для ключей рабочего пространства требуется workspace_id, для пользовательских ключей — user_id.

Создайте API-ключ Portkey для аутентификации. Орговые ключи дают более широкий доступ; ключи рабочего пространства (workspace) действуют в его пределах. ПРЕДУПРЕЖДЕНИЕ: секрет ключа возвращается ОДИН РАЗ в результате работы инструмента и будет виден в транскриптах MCP и контексте LLM — сразу сохраните его в безопасном месте. После использования ключ немедленно предоставляет доступ в соответствии с его областями, настройками по умолчанию и лимитами. Для ключей рабочего пространства требуется workspace_id, для пользовательских ключей — user_id.

Параметры

  • typeenumобязательный

    Key type: 'organisation' for org-wide access or 'workspace' for workspace-scoped

    organisationworkspace
  • sub_typeenumобязательный

    Sub-type: 'user' for user-associated keys or 'service' for service accounts

    userservice
  • namestringобязательный

    Display name for the API key

  • descriptionstring

    Optional description for the key

  • workspace_idstring

    Workspace ID (required for workspace-type keys)

  • user_idstring

    User ID (required for user sub-type keys)

  • scopesstring[]обязательный

    Permission scopes for the key (e.g., ['logs.read', 'analytics.read'])

  • credit_limitnumber

    Credit limit for usage

  • alert_thresholdnumber

    Alert threshold percentage (0-100)

  • rate_limit_rpmnumber

    Rate limit in requests per minute

  • default_config_idstring

    Default configuration ID to use with this key

  • default_metadataobject

    Default metadata key-value pairs

  • alert_emailsstring[]

    Email addresses for alerts

  • expires_atstring

    Expiration date in ISO 8601 format

create_collectionвнешний мир

Создайте новую коллекцию запросов для организации запросов по приложениям. Используйте её, когда нужно новое пространство имён перед create_prompt; возвращает идентификатор и slug коллекции, и не перемещает никакие запросы.

Создайте новую коллекцию запросов для организации запросов по приложениям. Используйте её, когда нужно новое пространство имён перед create_prompt; возвращает идентификатор и slug коллекции, и не перемещает никакие запросы.

Параметры

  • namestringобязательный

    Collection name (e.g., 'hourlink', 'apizone', 'research-pilot')

  • workspace_idstring

    Workspace ID to create collection in

create_configвнешний мир

Создайте конфиг, который определяет маршрутизацию, кэш, повторы и цели для запросов; используйте update_config, чтобы изменить существующий, и list_config_versions для истории. Требуется хотя бы один параметр, новые конфиги вступают в силу сразу после того, как на них ссылаются через key или prompt, вызов возвращает новый id и version_id.

Создайте конфиг, который определяет маршрутизацию, кэш, повторы и цели для запросов; используйте update_config, чтобы изменить существующий, и list_config_versions для истории. Требуется хотя бы один параметр, новые конфиги вступают в силу сразу после того, как на них ссылаются через key или prompt, вызов возвращает новый id и version_id.

Параметры

  • namestringобязательный

    Name for the new configuration

  • workspace_idstring

    Workspace ID to create config in

  • cache_modeenum

    Cache mode: 'simple' or 'semantic'

    simplesemantic
  • cache_max_agenumber

    Cache max age in seconds

  • retry_attemptsnumber

    Number of retry attempts (1-5)

  • retry_on_status_codesnumber[]

    HTTP status codes to retry on (e.g., [429, 500, 502, 503])

  • strategy_modeenum

    Routing strategy: 'loadbalance' or 'fallback'

    loadbalancefallback
  • targetsobject[]

    Array of target providers with virtual keys

create_feedbackвнешний мир

Создаёт отзыв для трассы или запроса. Записывает новый отзыв, привязанный по trace_id, возвращает ID созданных отзывов и статус, вступает в силу немедленно; используйте update_feedback для исправления существующей записи.

Создаёт отзыв для трассы или запроса. Записывает новый отзыв, привязанный по trace_id, возвращает ID созданных отзывов и статус, вступает в силу немедленно; используйте update_feedback для исправления существующей записи.

Параметры

  • trace_idstringобязательный

    The trace ID to associate the feedback with. This links feedback to a specific request/generation.

  • valuenumberобязательный

    Feedback value/rating. Common patterns: 1 for positive (thumbs up), 0 for negative (thumbs down), or use a scale like 1-5.

  • weightnumber

    Optional weighting factor for the feedback. Use to give more importance to certain feedback.

  • metadataobject

    Optional custom metadata for categorization and analysis (e.g., feedback_source, category, user_segment).

create_guardrailвнешний мир

Создайте guardrail с проверками и действиями для фильтрации запросов. Сначала создайте его, затем ссылайтесь на него из конфигов; новая версия становится policy anchor для downstream-использования.

Создайте guardrail с проверками и действиями для фильтрации запросов. Сначала создайте его, затем ссылайтесь на него из конфигов; новая версия становится policy anchor для downstream-использования.

Параметры

  • namestringобязательный

    Name of the guardrail

  • checksobject[]обязательный

    Array of checks to apply (at least one required)

  • actionsobjectобязательный

    Actions to take when guardrail checks pass or fail

  • workspace_idstring

    Workspace ID to create the guardrail in

  • organisation_idstring

    Organisation ID (required if workspace_id not provided)

create_integration

Создаёт интеграцию провайдера на уровне организации: она хранит API-ключ AI-провайдера и становится источником, на основе которого строятся провайдеры рабочих пространств (create_provider). Параметр ai_provider_id принимает идентификатор провайдера, например 'openai' или 'anthropic'; некоторым бекендам (azure-openai, aws-bedrock, vertex-ai) нужны поля, специфичные для провайдера, а ключ после записи становится доступен только для записи (get_integration показывает его замаскированным). Затем предоставьте модели и доступ к рабочим пространствам с помощью update_integration_models и update_integration_workspaces. Возвращает id и slug новой интеграции.

Создаёт интеграцию провайдера на уровне организации: она хранит API-ключ AI-провайдера и становится источником, на основе которого строятся провайдеры рабочих пространств (create_provider). Параметр ai_provider_id принимает идентификатор провайдера, например 'openai' или 'anthropic'; некоторым бекендам (azure-openai, aws-bedrock, vertex-ai) нужны поля, специфичные для провайдера, а ключ после записи становится доступен только для записи (get_integration показывает его замаскированным). Затем предоставьте модели и доступ к рабочим пространствам с помощью update_integration_models и update_integration_workspaces. Возвращает id и slug новой интеграции.

Параметры

  • namestringобязательный

    Human-readable name for the integration

  • ai_provider_idstringобязательный

    ID of the AI provider (e.g., 'openai', 'anthropic', 'azure-openai', 'aws-bedrock', 'vertex-ai')

  • slugstring

    URL-friendly identifier (auto-generated from name if not provided)

  • keystring

    API key for the provider (if required)

  • descriptionstring

    Optional description of the integration

  • workspace_idstring

    Workspace ID for workspace-scoped integrations

  • api_versionstring

    API version (for Azure OpenAI)

  • resource_namestring

    Resource name (for Azure OpenAI)

  • deployment_namestring

    Deployment name (for Azure OpenAI)

  • aws_regionstring

    AWS region (for AWS Bedrock)

  • aws_access_key_idstring

    AWS access key ID (for AWS Bedrock)

  • aws_secret_access_keystring

    AWS secret access key (for AWS Bedrock)

  • vertex_project_idstring

    GCP project ID (for Vertex AI)

  • vertex_regionstring

    GCP region (for Vertex AI)

  • custom_hoststring

    Custom base URL for the provider

create_log_exportвнешний мир

Создайте определение экспорта логов с фильтрами и запрошенными полями. Это только настраивает экспорт и не запускает обработку; далее вызовите start_log_export, затем используйте get_log_export или download_log_export, чтобы просмотреть или получить готовый результат.

Создайте определение экспорта логов с фильтрами и запрошенными полями. Это только настраивает экспорт и не запускает обработку; далее вызовите start_log_export, затем используйте get_log_export или download_log_export, чтобы просмотреть или получить готовый результат.

Параметры

  • workspace_idstring

    Workspace ID for the export

  • descriptionstring

    Human-readable description for the export job

  • time_minstringобязательный

    Minimum time filter in date format (e.g., '2024-01-01' or ISO 8601)

  • time_maxstringобязательный

    Maximum time filter in date format (e.g., '2024-01-31' or ISO 8601)

  • cost_minnumber

    Minimum cost filter

  • cost_maxnumber

    Maximum cost filter

  • total_units_minnumber

    Minimum total units (tokens) filter

  • total_units_maxnumber

    Maximum total units (tokens) filter

  • ai_modelstring[]

    Filter by specific AI model names

  • requested_fieldsstring[]обязательный

    Fields to include in export: id, trace_id, created_at, request, response, is_success, ai_org, ai_model, req_units, res_units, total_units, request_url, cost, cost_currency, response_time, response_status_code, mode, config, prompt_slug, metadata

create_mcp_integrationвнешний мир

Создаёт интеграцию MCP из URL внешнего сервера. Регистрирует подключение на стороне Portkey и возвращает новый id и slug; если auth_type: headers, обязательны custom_headers, и вы обычно затем вызываете create_mcp_server и обновляете capability.

Создаёт интеграцию MCP из URL внешнего сервера. Регистрирует подключение на стороне Portkey и возвращает новый id и slug; если auth_type: headers, обязательны custom_headers, и вы обычно затем вызываете create_mcp_server и обновляете capability.

Параметры

  • namestringобязательный

    Display name for the MCP integration

  • urlstringобязательный

    URL endpoint of the MCP server to integrate

  • auth_typeenumобязательный

    Authentication type: 'none', 'headers' (custom headers), or 'oauth_auto' (OAuth)

    oauth_autoheadersnone
  • transportenumобязательный

    MCP transport protocol: 'http' (streamable HTTP) or 'sse' (server-sent events)

    httpsse
  • slugstring

    Custom slug. Auto-generated if omitted

  • descriptionstring

    Description of the MCP integration

  • custom_headersobject

    Custom headers for authentication (e.g. { "Authorization": "Bearer xxx" }). Sent via configurations.custom_headers

  • workspace_idstring

    Workspace ID — required when using organization admin API keys

create_mcp_serverвнешний мир

Создайте MCP сервер в рамках существующей интеграции. Сервер регистрируется и возвращает новый id и slug; сначала используйте list_mcp_integrations, чтобы найти родительскую интеграцию, затем capabilities или access tools для его настройки.

Создайте MCP сервер в рамках существующей интеграции. Сервер регистрируется и возвращает новый id и slug; сначала используйте list_mcp_integrations, чтобы найти родительскую интеграцию, затем capabilities или access tools для его настройки.

Параметры

  • namestringобязательный

    Display name for the MCP server

  • mcp_integration_idstringобязательный

    ID or slug of the MCP integration this server belongs to

  • slugstring

    Custom slug. Auto-generated if omitted

  • descriptionstring

    Description of the MCP server

create_promptвнешний мир

Создайте новый шаблон промпта и начальную версию. Используйте это для первоначальной настройки; для идемпотентных CI/CD-потоков используйте migrate_prompt. Принимает обычный текст или структурированные чат-сообщения, создает новую версию сразу и возвращает id промпта, slug и id версии. Для многосообщенийных чат-промптов передавайте messages (предпочтительно) или JSON-закодированный массив в виде строки.

Создайте новый шаблон промпта и начальную версию. Используйте это для первоначальной настройки; для идемпотентных CI/CD-потоков используйте migrate_prompt. Принимает обычный текст или структурированные чат-сообщения, создает новую версию сразу и возвращает id промпта, slug и id версии. Для многосообщенийных чат-промптов передавайте messages (предпочтительно) или JSON-закодированный массив в виде строки.

Параметры

  • namestringобязательный

    Display name for the prompt

  • collection_idstringобязательный

    Collection ID to organize the prompt in (use list_collections to find)

  • stringstring

    Legacy prompt template string. Use plain text for single-message prompts, or a JSON-encoded messages array string for multi-message chat prompts.

  • messagesobject[]

    Structured chat template alias. Serialized to the legacy string format before creation.

  • parametersobjectобязательный

    Default values for template variables

  • virtual_keystringобязательный

    Virtual key slug for model access

  • modelstring

    Model identifier (e.g., 'gpt-4', 'claude-3-opus'). Required unless ai_model_id or finetune_id is provided

  • ai_model_idstring

    AI model ID (alternative to model). Required unless model or finetune_id is provided

  • finetune_idstring

    Fine-tune ID (alternative to model). Required unless model or ai_model_id is provided

  • version_descriptionstring

    Description for this prompt version

  • template_metadataobject

    Custom metadata (app, env, source_file, etc.)

  • functionsobject[]

    Function definitions for function calling

  • toolsobject[]

    Tool definitions for tool use

  • tool_choiceobject

    Tool choice strategy

  • dry_runboolean

    When true, validate without creating

create_prompt_labelвнешний мир

Создаёт метку для версий промпта, например production, staging или experiment. Требуется organisation_id или workspace_id, чтобы задать область видимости. Возвращает id новой метки и пока не присваивает её ни одной версии.

Создаёт метку для версий промпта, например production, staging или experiment. Требуется organisation_id или workspace_id, чтобы задать область видимости. Возвращает id новой метки и пока не присваивает её ни одной версии.

Параметры

  • namestringобязательный

    Name of the label

  • organisation_idstring

    Organisation ID to create the label in

  • workspace_idstring

    Workspace ID to create the label in

  • descriptionstring

    Description of the label

  • color_codestring

    Hex format, e.g. '#FF5733'. Optional — omit for default color.

create_prompt_partialвнешний мир

Создайте повторно используемый партиал промпта для включения с {{> partial_name}}. Используйте это для общих фрагментов или макросов; возвращает идентификатор партиала, slug и идентификатор версии, и новая версия остаётся неактивной до публикации.

Создайте повторно используемый партиал промпта для включения с {{> partial_name}}. Используйте это для общих фрагментов или макросов; возвращает идентификатор партиала, slug и идентификатор версии, и новая версия остаётся неактивной до публикации.

Параметры

  • namestringобязательный

    Display name for the partial

  • stringstringобязательный

    The partial content/template string

  • workspace_idstring

    Workspace ID to create partial in (required for org-level API keys)

  • version_descriptionstring

    Description for this version

create_providerвнешний мир

Создайте провайдера рабочего пространства на основе интеграции организации. Провайдер наследует ключ интеграции, но его лимиты и срок действия применяются независимо для этого рабочего пространства. Возвращает идентификатор и слаг нового провайдера.

Создайте провайдера рабочего пространства на основе интеграции организации. Провайдер наследует ключ интеграции, но его лимиты и срок действия применяются независимо для этого рабочего пространства. Возвращает идентификатор и слаг нового провайдера.

Параметры

  • namestringобязательный

    Display name for the provider

  • integration_idstringобязательный

    Integration slug for the provider (e.g., 'openai', 'anthropic', 'azure-openai')

  • workspace_idstring

    Workspace ID - required when using organization admin API keys

  • slugstring

    Custom slug for the provider. Auto-generated with random suffix if omitted

  • notestring

    Optional note or description for the provider

  • credit_limitnumber

    Credit limit for usage

  • alert_thresholdnumber

    Alert threshold percentage (0-100)

  • usage_limit_typeenum

    Type of usage limit: 'cost' (monetary) or 'tokens' (token count). Defaults to 'cost'.

    costtokens
  • periodic_resetenum

    Period for resetting usage limits: 'monthly' or 'weekly'. Defaults to 'monthly'.

    monthlyweekly
  • rate_limit_valuenumber

    Must be provided together with rate_limit_unit.

  • rate_limit_unitenum

    Must be provided together with rate_limit_value. Values: 'rpm' (requests/min), 'rph' (requests/hour), or 'rpd' (requests/day).

    rpmrphrpd
  • expires_atstring

    Expiration date in ISO 8601 format

create_rate_limitвнешний мир

Создайте троттлинг запросов или токенов с параметрами conditions, group_by, type, unit и value. Параметры conditions и group_by обязательны; используйте лимиты использования, если вам нужен накопительный бюджет вместо этого.

Создайте троттлинг запросов или токенов с параметрами conditions, group_by, type, unit и value. Параметры conditions и group_by обязательны; используйте лимиты использования, если вам нужен накопительный бюджет вместо этого.

Параметры

  • conditionsobject[]обязательный

    Array of conditions that determine which requests this rate limit applies to

  • group_bystring[]обязательный

    Array of fields to group the rate limit by (e.g., ['virtual_key'], ['api_key', 'user_id'])

  • typeenumобязательный

    What to rate limit: 'requests' or 'tokens'

    requeststokens
  • unitenumобязательный

    Time unit: 'rpm' (per minute), 'rph' (per hour), or 'rpd' (per day)

    rpmrphrpd
  • valuenumberобязательный

    The maximum allowed value per unit (e.g., 100 rpm)

  • namestring

    Optional name for the rate limit

  • workspace_idstring

    Workspace ID to scope the limit to

  • organisation_idstring

    Organisation ID to scope the limit to

create_secret_referenceвнешний мир

Создаёт ссылку на секрет, хранящийся в AWS Secrets Manager, Azure Key Vault или HashiCorp Vault. Учётные данные для аутентификации передаются в Portkey и попадают в этот MCP-транскрипт; по возможности используйте кратковременные токены или режим workload identity. Возвращает новый UUID и slug, но никогда не раскрывает сам внешний секрет.

Создаёт ссылку на секрет, хранящийся в AWS Secrets Manager, Azure Key Vault или HashiCorp Vault. Учётные данные для аутентификации передаются в Portkey и попадают в этот MCP-транскрипт; по возможности используйте кратковременные токены или режим workload identity. Возвращает новый UUID и slug, но никогда не раскрывает сам внешний секрет.

Параметры

  • namestringобязательный

    Human-readable name

  • manager_typeenumобязательный

    External secret manager: aws_sm for AWS Secrets Manager, azure_kv for Azure Key Vault, or hashicorp_vault for HashiCorp Vault; must match the auth_config field family

    aws_smazure_kvhashicorp_vault
  • auth_configanyобязательный

    Choose exactly one documented authentication shape matching manager_type. Credentials are sent to Portkey and visible in the MCP transcript; prefer workload identity or short-lived credentials when available.

  • secret_pathstringобязательный

    Path of the secret in the external secret manager

  • organisation_idstring

    Organisation UUID; required when the MCP server is not authenticated with a Portkey API key

  • slugstring

    Optional stable slug containing only letters, numbers, underscores, or hyphens; Portkey generates one when omitted

  • descriptionany

    Optional description; use null to leave it empty

  • secret_keyany

    Optional key within a structured external secret; null uses the whole secret value

  • allow_all_workspacesboolean

    Whether every workspace may use this reference; defaults to true and cannot be true with allowed_workspaces

  • allowed_workspacesstring[]

    Workspace UUIDs or slugs allowed to use this reference; omit when allow_all_workspaces is true

  • tagsany

    Optional string key-value tags for filtering and organization

create_usage_limitвнешний мир

Создайте накопительный бюджет для затрат или токенов с опциональными оповещениями и еженедельным или ежемесячным сбросом. Параметры conditions и group_by обязательны; используйте rate limits, когда требуется троттлинг запросов.

Создайте накопительный бюджет для затрат или токенов с опциональными оповещениями и еженедельным или ежемесячным сбросом. Параметры conditions и group_by обязательны; используйте rate limits, когда требуется троттлинг запросов.

Параметры

  • conditionsobject[]обязательный

    Array of conditions that determine which requests this usage limit applies to

  • group_bystring[]обязательный

    Array of fields to group the usage limit by (e.g., ['virtual_key'], ['api_key', 'user_id'])

  • typeenumобязательный

    What to limit: 'cost' (in dollars) or 'tokens'

    costtokens
  • credit_limitnumberобязательный

    The maximum allowed usage (cost in dollars or token count)

  • namestring

    Optional name for the usage limit

  • alert_thresholdnumber

    Percentage threshold (0-100) at which to send an alert

  • periodic_resetenum

    Automatically reset usage counters on this schedule

    monthlyweekly
  • workspace_idstring

    Workspace ID to scope the limit to

  • organisation_idstring

    Organisation ID to scope the limit to

create_virtual_keyвнешний мир

Сохраните API-ключ провайдера как виртуальный ключ. Исходный ключ шифруется и возвращается только при создании, поэтому сохраните возвращённый slug и используйте его в промптах/конфигах. Опциональные лимиты использования и скорости применяются немедленно, а инструмент возвращает новый slug.

Сохраните API-ключ провайдера как виртуальный ключ. Исходный ключ шифруется и возвращается только при создании, поэтому сохраните возвращённый slug и используйте его в промптах/конфигах. Опциональные лимиты использования и скорости применяются немедленно, а инструмент возвращает новый slug.

Параметры

  • namestringобязательный

    Display name for the virtual key

  • providerstringобязательный

    Provider slug (e.g., 'openai', 'anthropic', 'azure-openai', 'google')

  • keystringобязательный

    The actual provider API key to store

  • notestring

    Optional note or description for this key

  • workspace_idstring

    Workspace ID to create the key in

  • api_versionstring

    API version (for Azure OpenAI)

  • resource_namestring

    Resource name (for Azure OpenAI)

  • deployment_namestring

    Deployment name (for Azure OpenAI)

  • credit_limitnumber

    Maximum usage cost threshold

  • alert_thresholdnumber

    Percentage of credit_limit at which to send alert emails (0-100)

  • rate_limit_rpmnumber

    Requests per minute limit

create_workspaceвнешний мир

Создаёт рабочее пространство для изоляции ресурсов, API-ключей и участников команды. Если slug не указан, он генерируется автоматически из имени; возвращает id, имя и slug нового рабочего пространства.

Создаёт рабочее пространство для изоляции ресурсов, API-ключей и участников команды. Если slug не указан, он генерируется автоматически из имени; возвращает id, имя и slug нового рабочего пространства.

Параметры

  • namestringобязательный

    Name of the workspace

  • slugstring

    URL-friendly slug (auto-generated if not provided)

  • descriptionstring

    Description of the workspace

  • is_defaultnumber

    Set as default workspace (1 = yes, 0 = no)

  • metadataobject

    Custom metadata key-value pairs

delete_api_keyвнешний мир

Удаление ключа API по UUID. Это действие нельзя отменить, оно немедленно отзывает доступ и может нарушить работу активных сессий, использующих этот ключ. Возвращает успех после отзыва.

Удаление ключа API по UUID. Это действие нельзя отменить, оно немедленно отзывает доступ и может нарушить работу активных сессий, использующих этот ключ. Возвращает успех после отзыва.

Параметры

  • idstringобязательный

    The UUID of the API key to delete

delete_collectionвнешний мир

Удалить коллекцию промптов по ID. Это действие нельзя отменить; промпты остаются в рабочем пространстве, но теряют группировку по коллекциям, поэтому сначала переназначьте их, если порядок важен.

Удалить коллекцию промптов по ID. Это действие нельзя отменить; промпты остаются в рабочем пространстве, но теряют группировку по коллекциям, поэтому сначала переназначьте их, если порядок важен.

Параметры

  • collection_idstringобязательный

    Collection ID to delete

delete_configвнешний мир

Удалить конфиг по slug. Это действие необратимо, удаляет все версии и ломает всё, что ссылается на этот slug; сначала выполните list_config_versions.

Удалить конфиг по slug. Это действие необратимо, удаляет все версии и ломает всё, что ссылается на этот slug; сначала выполните list_config_versions.

Параметры

  • slugstringобязательный

    Configuration slug to delete

delete_guardrailвнешний мир

Удалить guardrail по id или slug. Это необратимо и удаляет проверку из всех конфигов, которые на него ссылаются, поэтому сначала проверьте зависимые конфиги.

Удалить guardrail по id или slug. Это необратимо и удаляет проверку из всех конфигов, которые на него ссылаются, поэтому сначала проверьте зависимые конфиги.

Параметры

  • guardrail_idstringобязательный

    The guardrail UUID or slug to delete

delete_integrationвнешний мир

Удалить интеграцию по slug. Это необратимо и останавливает соединение на уровне организации, что сломает зависимые виртуальные ключи, провайдеров и доступ к рабочему пространству.

Удалить интеграцию по slug. Это необратимо и останавливает соединение на уровне организации, что сломает зависимые виртуальные ключи, провайдеров и доступ к рабочему пространству.

Параметры

  • slugstringобязательный

    The slug of the integration to delete

delete_integration_modelвнешний мир

Удаляет пользовательскую модель из интеграции. Встроенные модели нужно отключать, а не удалять — удаление применимо только к пользовательским записям. Возвращает успех после удаления пользовательской модели.

Удаляет пользовательскую модель из интеграции. Встроенные модели нужно отключать, а не удалять — удаление применимо только к пользовательским записям. Возвращает успех после удаления пользовательской модели.

Параметры

  • slugstringобязательный

    The slug of the integration

  • model_slugstringобязательный

    The slug of the model to delete

delete_mcp_integrationвнешний мир

Удаляет интеграцию MCP и все серверы, которые к ней относятся. Это действие необратимо, немедленно отключает доступ и должно использоваться только после подтверждения, что от интеграции ничего не зависит.

Удаляет интеграцию MCP и все серверы, которые к ней относятся. Это действие необратимо, немедленно отключает доступ и должно использоваться только после подтверждения, что от интеграции ничего не зависит.

Параметры

  • idstringобязательный

    The MCP integration ID or slug to delete

delete_mcp_serverвнешний мир

Удалите экземпляр MCP сервера. Это необратимо, немедленно отключает доступ подключенных пользователей и должно использоваться только после подтверждения, что ни один workflow не зависит от сервера.

Удалите экземпляр MCP сервера. Это необратимо, немедленно отключает доступ подключенных пользователей и должно использоваться только после подтверждения, что ни один workflow не зависит от сервера.

Параметры

  • idstringобязательный

    The MCP server ID or slug to delete

delete_promptвнешний мир

Удаляет промпт и все его версии по идентификатору. Это действие нельзя отменить, оно немедленно нарушает работу вызывающих компонентов, использующих slug, и должно использоваться только после проверки list_prompt_versions или подтверждения, что вам не нужна история изменений (audit trail).

Удаляет промпт и все его версии по идентификатору. Это действие нельзя отменить, оно немедленно нарушает работу вызывающих компонентов, использующих slug, и должно использоваться только после проверки list_prompt_versions или подтверждения, что вам не нужна история изменений (audit trail).

Параметры

  • prompt_idstringобязательный

    Prompt ID or slug to delete

delete_prompt_labelвнешний мир

Удаляет метку промпта по ID. Это действие нельзя отменить; версии, содержащие эту метку, теряют её, и любой рабочий процесс, ссылающийся на эту метку, потребует замены.

Удаляет метку промпта по ID. Это действие нельзя отменить; версии, содержащие эту метку, теряют её, и любой рабочий процесс, ссылающийся на эту метку, потребует замены.

Параметры

  • label_idstringобязательный

    Label ID to delete

delete_prompt_partialвнешний мир

Удалите частичный промпт по ID. Это действие нельзя отменить, и промпты, которые ссылаются на него с помощью {{> name}}, не будут отображаться, пока вы не замените ссылку.

Удалите частичный промпт по ID. Это действие нельзя отменить, и промпты, которые ссылаются на него с помощью {{> name}}, не будут отображаться, пока вы не замените ссылку.

Параметры

  • prompt_partial_idstringобязательный

    Prompt partial ID or slug to delete

delete_providerвнешний мир

Удаляет провайдера рабочего пространства по slug. Это необратимо и сломает промпты, конфиги и виртуальные ключи, которые на него ссылаются; вместо этого используйте delete_integration для источника организации. Возвращает успех после удаления провайдера.

Удаляет провайдера рабочего пространства по slug. Это необратимо и сломает промпты, конфиги и виртуальные ключи, которые на него ссылаются; вместо этого используйте delete_integration для источника организации. Возвращает успех после удаления провайдера.

Параметры

  • slugstringобязательный

    The slug of the provider to delete

  • workspace_idstring

    Workspace ID - required when using organization admin keys

delete_rate_limitвнешний мир

Удалить ограничение скорости по идентификатору. Это действие необратимо и снимает троттлинг немедленно; перед удалением проверьте зависимые конфигурации и виртуальные ключи.

Удалить ограничение скорости по идентификатору. Это действие необратимо и снимает троттлинг немедленно; перед удалением проверьте зависимые конфигурации и виртуальные ключи.

Параметры

  • idstringобязательный

    The unique identifier of the rate limit

delete_secret_referenceидемпотентныйвнешний мир

Навсегда удалить Secret Reference. Это действие необратимо - интеграции или виртуальные ключи, использующие его, могут сразу перестать получать учётные данные; перед удалением проверьте зависимости.

Навсегда удалить Secret Reference. Это действие необратимо - интеграции или виртуальные ключи, использующие его, могут сразу перестать получать учётные данные; перед удалением проверьте зависимости.

Параметры

  • idstringобязательный

    Secret Reference UUID or slug

delete_usage_limitвнешний мир

Удалить лимит использования по id. Это необратимо: бюджет снимается немедленно, а отслеживаемое состояние использования очищается. Если нужно оценить последствия, сначала проверьте list_usage_limit_entities.

Удалить лимит использования по id. Это необратимо: бюджет снимается немедленно, а отслеживаемое состояние использования очищается. Если нужно оценить последствия, сначала проверьте list_usage_limit_entities.

Параметры

  • idstringобязательный

    The unique identifier of the usage limit

delete_userвнешний мир

Удаляет пользователя из организации по ID. Это необратимо: удаляет членство в организации и рабочих пространствах, отзывает API-ключи и завершает активные сеансы. Для ожидающих приглашений используйте delete_user_invite.

Удаляет пользователя из организации по ID. Это необратимо: удаляет членство в организации и рабочих пространствах, отзывает API-ключи и завершает активные сеансы. Для ожидающих приглашений используйте delete_user_invite.

Параметры

  • user_idstringобязательный

    The user ID to delete

delete_user_inviteвнешний мир

Удалить ожидающее приглашение и отозвать его пригласительную ссылку. Это не затрагивает существующих пользователей; используйте delete_user для полного удаления пользователя.

Удалить ожидающее приглашение и отозвать его пригласительную ссылку. Это не затрагивает существующих пользователей; используйте delete_user для полного удаления пользователя.

Параметры

  • invite_idstringобязательный

    The invite ID to delete

delete_virtual_keyвнешний мир

Удалить виртуальный ключ по slug. Это необратимо и сломает промпты и конфиги, которые ссылаются на этот slug, поэтому сначала убедитесь, что нет активных зависимостей. После удаления возвращает успех.

Удалить виртуальный ключ по slug. Это необратимо и сломает промпты и конфиги, которые ссылаются на этот slug, поэтому сначала убедитесь, что нет активных зависимостей. После удаления возвращает успех.

Параметры

  • slugstringобязательный

    The slug of the virtual key to delete

delete_workspaceвнешний мир

Удалить workspace по id. Это действие необратимо: оно удаляет workspace, его участников, конфиги, API-ключи и ресурсы.

Удалить workspace по id. Это действие необратимо: оно удаляет workspace, его участников, конфиги, API-ключи и ресурсы.

Параметры

  • workspace_idstringобязательный

    The workspace ID to delete

download_log_exportтолько чтениеидемпотентныйвнешний мир

Получите подписанный URL для загрузки завершенного экспорта логов. Экспорт должен быть уже завершен; используйте get_log_export, чтобы подтвердить готовность, и start_log_export, если он еще не был запущен.

Получите подписанный URL для загрузки завершенного экспорта логов. Экспорт должен быть уже завершен; используйте get_log_export, чтобы подтвердить готовность, и start_log_export, если он еще не был запущен.

Параметры

  • export_idstringобязательный

    The unique ID of the log export to download

get_analytics_group_metadataтолько чтениеидемпотентныйвнешний мир

Получает постраничную разбивку метаданных с total_groups, group_count и массивом metadata_groups, сгруппированных по указанному metadata_key. Используется для кастомных разрезов — например, по окружениям или фичам. Вместе с временным окном нужно передать metadata_key. Только для Enterprise-тарифов. Возвращает 403 на не-Enterprise планах Portkey.

Получает постраничную разбивку метаданных с total_groups, group_count и массивом metadata_groups, сгруппированных по указанному metadata_key. Используется для кастомных разрезов — например, по окружениям или фичам. Вместе с временным окном нужно передать metadata_key. Только для Enterprise-тарифов. Возвращает 403 на не-Enterprise планах Portkey.

Параметры

  • time_of_generation_minstringобязательный

    Start time for the analytics period (ISO8601 format, e.g., '2024-01-01T00:00:00Z')

  • time_of_generation_maxstringобязательный

    End time for the analytics period (ISO8601 format, e.g., '2024-02-01T00:00:00Z')

  • total_units_minnumber

    Minimum number of total tokens to filter by

  • total_units_maxnumber

    Maximum number of total tokens to filter by

  • cost_minnumber

    Minimum cost in cents to filter by

  • cost_maxnumber

    Maximum cost in cents to filter by

  • prompt_token_minnumber

    Minimum number of prompt tokens

  • prompt_token_maxnumber

    Maximum number of prompt tokens

  • completion_token_minnumber

    Minimum number of completion tokens

  • completion_token_maxnumber

    Maximum number of completion tokens

  • status_codestring

    Legacy Portkey query param for HTTP status codes. Comma-separated string; prefer status_codes for structured inputs.

  • weighted_feedback_minnumber

    Minimum weighted feedback score (-10 to 10)

  • weighted_feedback_maxnumber

    Maximum weighted feedback score (-10 to 10)

  • virtual_keysstring

    Legacy Portkey query param for virtual key slugs. Comma-separated string; prefer virtual_key_slugs for structured inputs.

  • configsstring

    Legacy Portkey query param for config slugs. Comma-separated string; prefer config_slugs for structured inputs.

  • status_codesstring[]

    Structured alias for status_code. Use an array of HTTP status codes; normalized to the legacy comma-separated Portkey query param.

  • virtual_key_slugsstring[]

    Structured alias for virtual_keys. Use an array of virtual key slugs; normalized to the legacy comma-separated Portkey query param.

  • config_slugsstring[]

    Structured alias for configs. Use an array of config slugs; normalized to the legacy comma-separated Portkey query param.

  • workspace_slugstring

    Filter by specific workspace

  • api_key_idsstring

    Legacy Portkey query param for API key UUIDs. Comma-separated string; request_analytics also accepts an array and normalizes it to this form.

  • metadatastring

    Legacy Portkey query param for metadata filtering. Stringified JSON object, e.g. '{"env":"prod","app":"myapp"}'; prefer metadata_filter for structured inputs.

  • ai_org_modelstring

    Legacy Portkey query param for provider/model pairs. Format: 'provider__model' with double underscore, e.g. 'openai__gpt-4' or 'anthropic__claude-3-opus'. Comma-separated string; prefer provider_models for structured inputs.

  • provider_modelsstring[]

    Structured alias for ai_org_model. Use provider__model strings in an array; normalized to the legacy comma-separated Portkey query param.

  • trace_idstring

    Legacy Portkey query param for trace IDs. Comma-separated string; prefer trace_ids for structured inputs.

  • trace_idsstring[]

    Structured alias for trace_id. Use an array of trace IDs; normalized to the legacy comma-separated Portkey query param.

  • span_idstring

    Legacy Portkey query param for span IDs. Comma-separated string; prefer span_ids for structured inputs.

  • span_idsstring[]

    Structured alias for span_id. Use an array of span IDs; normalized to the legacy comma-separated Portkey query param.

  • metadata_filterobject

    Structured alias for metadata. Use an object such as { env: 'prod' }; normalized to a JSON string before the request is sent.

  • prompt_slugstring

    Filter by prompt slug

  • current_pageinteger

    Page number for pagination

  • page_sizeinteger

    Results per page (max 100)

  • metadata_keystringобязательный

    The metadata key to group by (e.g., 'env', 'app', 'client_id')

get_analytics_group_modelsтолько чтениеидемпотентныйвнешний мир

Получает постраничную разбивку по моделям с total_groups, group_count и массивом models, содержащим количество запросов, стоимость и использование токенов. Используйте это для сравнения стоимости, популярности и эффективности моделей; для временных рядов применяйте get_token_analytics или get_cost_analytics. Только для Enterprise. Возвращает 403 на не-Enterprise планах Portkey.

Получает постраничную разбивку по моделям с total_groups, group_count и массивом models, содержащим количество запросов, стоимость и использование токенов. Используйте это для сравнения стоимости, популярности и эффективности моделей; для временных рядов применяйте get_token_analytics или get_cost_analytics. Только для Enterprise. Возвращает 403 на не-Enterprise планах Portkey.

Параметры

  • time_of_generation_minstringобязательный

    Start time for the analytics period (ISO8601 format, e.g., '2024-01-01T00:00:00Z')

  • time_of_generation_maxstringобязательный

    End time for the analytics period (ISO8601 format, e.g., '2024-02-01T00:00:00Z')

  • total_units_minnumber

    Minimum number of total tokens to filter by

  • total_units_maxnumber

    Maximum number of total tokens to filter by

  • cost_minnumber

    Minimum cost in cents to filter by

  • cost_maxnumber

    Maximum cost in cents to filter by

  • prompt_token_minnumber

    Minimum number of prompt tokens

  • prompt_token_maxnumber

    Maximum number of prompt tokens

  • completion_token_minnumber

    Minimum number of completion tokens

  • completion_token_maxnumber

    Maximum number of completion tokens

  • status_codestring

    Legacy Portkey query param for HTTP status codes. Comma-separated string; prefer status_codes for structured inputs.

  • weighted_feedback_minnumber

    Minimum weighted feedback score (-10 to 10)

  • weighted_feedback_maxnumber

    Maximum weighted feedback score (-10 to 10)

  • virtual_keysstring

    Legacy Portkey query param for virtual key slugs. Comma-separated string; prefer virtual_key_slugs for structured inputs.

  • configsstring

    Legacy Portkey query param for config slugs. Comma-separated string; prefer config_slugs for structured inputs.

  • status_codesstring[]

    Structured alias for status_code. Use an array of HTTP status codes; normalized to the legacy comma-separated Portkey query param.

  • virtual_key_slugsstring[]

    Structured alias for virtual_keys. Use an array of virtual key slugs; normalized to the legacy comma-separated Portkey query param.

  • config_slugsstring[]

    Structured alias for configs. Use an array of config slugs; normalized to the legacy comma-separated Portkey query param.

  • workspace_slugstring

    Filter by specific workspace

  • api_key_idsstring

    Legacy Portkey query param for API key UUIDs. Comma-separated string; request_analytics also accepts an array and normalizes it to this form.

  • metadatastring

    Legacy Portkey query param for metadata filtering. Stringified JSON object, e.g. '{"env":"prod","app":"myapp"}'; prefer metadata_filter for structured inputs.

  • ai_org_modelstring

    Legacy Portkey query param for provider/model pairs. Format: 'provider__model' with double underscore, e.g. 'openai__gpt-4' or 'anthropic__claude-3-opus'. Comma-separated string; prefer provider_models for structured inputs.

  • provider_modelsstring[]

    Structured alias for ai_org_model. Use provider__model strings in an array; normalized to the legacy comma-separated Portkey query param.

  • trace_idstring

    Legacy Portkey query param for trace IDs. Comma-separated string; prefer trace_ids for structured inputs.

  • trace_idsstring[]

    Structured alias for trace_id. Use an array of trace IDs; normalized to the legacy comma-separated Portkey query param.

  • span_idstring

    Legacy Portkey query param for span IDs. Comma-separated string; prefer span_ids for structured inputs.

  • span_idsstring[]

    Structured alias for span_id. Use an array of span IDs; normalized to the legacy comma-separated Portkey query param.

  • metadata_filterobject

    Structured alias for metadata. Use an object such as { env: 'prod' }; normalized to a JSON string before the request is sent.

  • prompt_slugstring

    Filter by prompt slug

  • current_pageinteger

    Page number for pagination

  • page_sizeinteger

    Results per page (max 100)

get_analytics_group_usersтолько чтениеидемпотентныйвнешний мир

Получает постраничную разбивку по пользователям с total_groups, group_count и массивом users, содержащим количество запросов, стоимость и использование токенов. Используйте это для выставления счетов, аудита или анализа самых активных потребителей. Для сводных трендов по активным и новым пользователям используйте get_users_analytics. Функция доступна только в Enterprise. На тарифах Portkey, отличных от Enterprise, возвращает 403.

Получает постраничную разбивку по пользователям с total_groups, group_count и массивом users, содержащим количество запросов, стоимость и использование токенов. Используйте это для выставления счетов, аудита или анализа самых активных потребителей. Для сводных трендов по активным и новым пользователям используйте get_users_analytics. Функция доступна только в Enterprise. На тарифах Portkey, отличных от Enterprise, возвращает 403.

Параметры

  • time_of_generation_minstringобязательный

    Start time for the analytics period (ISO8601 format, e.g., '2024-01-01T00:00:00Z')

  • time_of_generation_maxstringобязательный

    End time for the analytics period (ISO8601 format, e.g., '2024-02-01T00:00:00Z')

  • total_units_minnumber

    Minimum number of total tokens to filter by

  • total_units_maxnumber

    Maximum number of total tokens to filter by

  • cost_minnumber

    Minimum cost in cents to filter by

  • cost_maxnumber

    Maximum cost in cents to filter by

  • prompt_token_minnumber

    Minimum number of prompt tokens

  • prompt_token_maxnumber

    Maximum number of prompt tokens

  • completion_token_minnumber

    Minimum number of completion tokens

  • completion_token_maxnumber

    Maximum number of completion tokens

  • status_codestring

    Legacy Portkey query param for HTTP status codes. Comma-separated string; prefer status_codes for structured inputs.

  • weighted_feedback_minnumber

    Minimum weighted feedback score (-10 to 10)

  • weighted_feedback_maxnumber

    Maximum weighted feedback score (-10 to 10)

  • virtual_keysstring

    Legacy Portkey query param for virtual key slugs. Comma-separated string; prefer virtual_key_slugs for structured inputs.

  • configsstring

    Legacy Portkey query param for config slugs. Comma-separated string; prefer config_slugs for structured inputs.

  • status_codesstring[]

    Structured alias for status_code. Use an array of HTTP status codes; normalized to the legacy comma-separated Portkey query param.

  • virtual_key_slugsstring[]

    Structured alias for virtual_keys. Use an array of virtual key slugs; normalized to the legacy comma-separated Portkey query param.

  • config_slugsstring[]

    Structured alias for configs. Use an array of config slugs; normalized to the legacy comma-separated Portkey query param.

  • workspace_slugstring

    Filter by specific workspace

  • api_key_idsstring

    Legacy Portkey query param for API key UUIDs. Comma-separated string; request_analytics also accepts an array and normalizes it to this form.

  • metadatastring

    Legacy Portkey query param for metadata filtering. Stringified JSON object, e.g. '{"env":"prod","app":"myapp"}'; prefer metadata_filter for structured inputs.

  • ai_org_modelstring

    Legacy Portkey query param for provider/model pairs. Format: 'provider__model' with double underscore, e.g. 'openai__gpt-4' or 'anthropic__claude-3-opus'. Comma-separated string; prefer provider_models for structured inputs.

  • provider_modelsstring[]

    Structured alias for ai_org_model. Use provider__model strings in an array; normalized to the legacy comma-separated Portkey query param.

  • trace_idstring

    Legacy Portkey query param for trace IDs. Comma-separated string; prefer trace_ids for structured inputs.

  • trace_idsstring[]

    Structured alias for trace_id. Use an array of trace IDs; normalized to the legacy comma-separated Portkey query param.

  • span_idstring

    Legacy Portkey query param for span IDs. Comma-separated string; prefer span_ids for structured inputs.

  • span_idsstring[]

    Structured alias for span_id. Use an array of span IDs; normalized to the legacy comma-separated Portkey query param.

  • metadata_filterobject

    Structured alias for metadata. Use an object such as { env: 'prod' }; normalized to a JSON string before the request is sent.

  • prompt_slugstring

    Filter by prompt slug

  • current_pageinteger

    Page number for pagination

  • page_sizeinteger

    Results per page (max 100)

get_api_keyтолько чтениеидемпотентныйвнешний мир

Получает один API-ключ по UUID, не раскрывая секрет. Используйте, чтобы проверить scopes, defaults, limits, expiration и состояние сброса, прежде чем менять доступ.

Получает один API-ключ по UUID, не раскрывая секрет. Используйте, чтобы проверить scopes, defaults, limits, expiration и состояние сброса, прежде чем менять доступ.

Параметры

  • idstringобязательный

    The UUID of the API key to retrieve

get_cache_hit_latencyтолько чтениеидемпотентныйвнешний мир

Получите данные временного ряда задержки только для попаданий в кэш с summary.total_latency, summary.avg_latency и per-bucket общей/средней задержкой. Используйте это для оценки скорости кэшированных ответов; для всех запросов используйте get_latency_analytics. Ограничено для Enterprise. Возвращает 403 на планах Portkey, не относящихся к Enterprise.

Получите данные временного ряда задержки только для попаданий в кэш с summary.total_latency, summary.avg_latency и per-bucket общей/средней задержкой. Используйте это для оценки скорости кэшированных ответов; для всех запросов используйте get_latency_analytics. Ограничено для Enterprise. Возвращает 403 на планах Portkey, не относящихся к Enterprise.

Параметры

  • time_of_generation_minstringобязательный

    Start time for the analytics period (ISO8601 format, e.g., '2024-01-01T00:00:00Z')

  • time_of_generation_maxstringобязательный

    End time for the analytics period (ISO8601 format, e.g., '2024-02-01T00:00:00Z')

  • total_units_minnumber

    Minimum number of total tokens to filter by

  • total_units_maxnumber

    Maximum number of total tokens to filter by

  • cost_minnumber

    Minimum cost in cents to filter by

  • cost_maxnumber

    Maximum cost in cents to filter by

  • prompt_token_minnumber

    Minimum number of prompt tokens

  • prompt_token_maxnumber

    Maximum number of prompt tokens

  • completion_token_minnumber

    Minimum number of completion tokens

  • completion_token_maxnumber

    Maximum number of completion tokens

  • status_codestring

    Legacy Portkey query param for HTTP status codes. Comma-separated string; prefer status_codes for structured inputs.

  • weighted_feedback_minnumber

    Minimum weighted feedback score (-10 to 10)

  • weighted_feedback_maxnumber

    Maximum weighted feedback score (-10 to 10)

  • virtual_keysstring

    Legacy Portkey query param for virtual key slugs. Comma-separated string; prefer virtual_key_slugs for structured inputs.

  • configsstring

    Legacy Portkey query param for config slugs. Comma-separated string; prefer config_slugs for structured inputs.

  • status_codesstring[]

    Structured alias for status_code. Use an array of HTTP status codes; normalized to the legacy comma-separated Portkey query param.

  • virtual_key_slugsstring[]

    Structured alias for virtual_keys. Use an array of virtual key slugs; normalized to the legacy comma-separated Portkey query param.

  • config_slugsstring[]

    Structured alias for configs. Use an array of config slugs; normalized to the legacy comma-separated Portkey query param.

  • workspace_slugstring

    Filter by specific workspace

  • api_key_idsstring

    Legacy Portkey query param for API key UUIDs. Comma-separated string; request_analytics also accepts an array and normalizes it to this form.

  • metadatastring

    Legacy Portkey query param for metadata filtering. Stringified JSON object, e.g. '{"env":"prod","app":"myapp"}'; prefer metadata_filter for structured inputs.

  • ai_org_modelstring

    Legacy Portkey query param for provider/model pairs. Format: 'provider__model' with double underscore, e.g. 'openai__gpt-4' or 'anthropic__claude-3-opus'. Comma-separated string; prefer provider_models for structured inputs.

  • provider_modelsstring[]

    Structured alias for ai_org_model. Use provider__model strings in an array; normalized to the legacy comma-separated Portkey query param.

  • trace_idstring

    Legacy Portkey query param for trace IDs. Comma-separated string; prefer trace_ids for structured inputs.

  • trace_idsstring[]

    Structured alias for trace_id. Use an array of trace IDs; normalized to the legacy comma-separated Portkey query param.

  • span_idstring

    Legacy Portkey query param for span IDs. Comma-separated string; prefer span_ids for structured inputs.

  • span_idsstring[]

    Structured alias for span_id. Use an array of span IDs; normalized to the legacy comma-separated Portkey query param.

  • metadata_filterobject

    Structured alias for metadata. Use an object such as { env: 'prod' }; normalized to a JSON string before the request is sent.

  • prompt_slugstring

    Filter by prompt slug

get_cache_hit_rateтолько чтениеидемпотентныйвнешний мир

Получить данные временных рядов эффективности кэша с hit_rate, total_hits, total_misses в сводке, а также hit, miss и rate по каждому bucket. Используйте это для измерения эффективности кэша; для скорости, а не соотношения hit/miss, используйте get_cache_hit_latency. Доступно только в Enterprise. Возвращает 403 на не-Enterprise тарифах Portkey.

Получить данные временных рядов эффективности кэша с hit_rate, total_hits, total_misses в сводке, а также hit, miss и rate по каждому bucket. Используйте это для измерения эффективности кэша; для скорости, а не соотношения hit/miss, используйте get_cache_hit_latency. Доступно только в Enterprise. Возвращает 403 на не-Enterprise тарифах Portkey.

Параметры

  • time_of_generation_minstringобязательный

    Start time for the analytics period (ISO8601 format, e.g., '2024-01-01T00:00:00Z')

  • time_of_generation_maxstringобязательный

    End time for the analytics period (ISO8601 format, e.g., '2024-02-01T00:00:00Z')

  • total_units_minnumber

    Minimum number of total tokens to filter by

  • total_units_maxnumber

    Maximum number of total tokens to filter by

  • cost_minnumber

    Minimum cost in cents to filter by

  • cost_maxnumber

    Maximum cost in cents to filter by

  • prompt_token_minnumber

    Minimum number of prompt tokens

  • prompt_token_maxnumber

    Maximum number of prompt tokens

  • completion_token_minnumber

    Minimum number of completion tokens

  • completion_token_maxnumber

    Maximum number of completion tokens

  • status_codestring

    Legacy Portkey query param for HTTP status codes. Comma-separated string; prefer status_codes for structured inputs.

  • weighted_feedback_minnumber

    Minimum weighted feedback score (-10 to 10)

  • weighted_feedback_maxnumber

    Maximum weighted feedback score (-10 to 10)

  • virtual_keysstring

    Legacy Portkey query param for virtual key slugs. Comma-separated string; prefer virtual_key_slugs for structured inputs.

  • configsstring

    Legacy Portkey query param for config slugs. Comma-separated string; prefer config_slugs for structured inputs.

  • status_codesstring[]

    Structured alias for status_code. Use an array of HTTP status codes; normalized to the legacy comma-separated Portkey query param.

  • virtual_key_slugsstring[]

    Structured alias for virtual_keys. Use an array of virtual key slugs; normalized to the legacy comma-separated Portkey query param.

  • config_slugsstring[]

    Structured alias for configs. Use an array of config slugs; normalized to the legacy comma-separated Portkey query param.

  • workspace_slugstring

    Filter by specific workspace

  • api_key_idsstring

    Legacy Portkey query param for API key UUIDs. Comma-separated string; request_analytics also accepts an array and normalizes it to this form.

  • metadatastring

    Legacy Portkey query param for metadata filtering. Stringified JSON object, e.g. '{"env":"prod","app":"myapp"}'; prefer metadata_filter for structured inputs.

  • ai_org_modelstring

    Legacy Portkey query param for provider/model pairs. Format: 'provider__model' with double underscore, e.g. 'openai__gpt-4' or 'anthropic__claude-3-opus'. Comma-separated string; prefer provider_models for structured inputs.

  • provider_modelsstring[]

    Structured alias for ai_org_model. Use provider__model strings in an array; normalized to the legacy comma-separated Portkey query param.

  • trace_idstring

    Legacy Portkey query param for trace IDs. Comma-separated string; prefer trace_ids for structured inputs.

  • trace_idsstring[]

    Structured alias for trace_id. Use an array of trace IDs; normalized to the legacy comma-separated Portkey query param.

  • span_idstring

    Legacy Portkey query param for span IDs. Comma-separated string; prefer span_ids for structured inputs.

  • span_idsstring[]

    Structured alias for span_id. Use an array of span IDs; normalized to the legacy comma-separated Portkey query param.

  • metadata_filterobject

    Structured alias for metadata. Use an object such as { env: 'prod' }; normalized to a JSON string before the request is sent.

  • prompt_slugstring

    Filter by prompt slug

get_collectionтолько чтениеидемпотентныйвнешний мир

Получает одну коллекцию по ID или слагу и возвращает её название, слаг, рабочее пространство и временные метки. Используйте list_collections для просмотра и get_collection, если вы уже знаете, что ищете.

Получает одну коллекцию по ID или слагу и возвращает её название, слаг, рабочее пространство и временные метки. Используйте list_collections для просмотра и get_collection, если вы уже знаете, что ищете.

Параметры

  • collection_idstringобязательный

    Collection ID or slug to retrieve

get_configтолько чтениеидемпотентныйвнешний мир

Получает одну конфигурацию по slug и возвращает её настройки маршрутизации, кэширования, повторных попыток и целевого назначения. Требуется известный slug; используйте list_configs, чтобы найти его перед редактированием.

Получает одну конфигурацию по slug и возвращает её настройки маршрутизации, кэширования, повторных попыток и целевого назначения. Требуется известный slug; используйте list_configs, чтобы найти его перед редактированием.

Параметры

  • slugstringобязательный

    The unique identifier (slug) of the configuration to retrieve. This can be found in the configuration's URL or from the list_configs tool response

get_cost_analyticsтолько чтениеидемпотентныйвнешний мир

Получает данные временных рядов затрат с summary.total_cost, summary.average_cost_per_request и общими/средними затратами на сегмент. Используйте для анализа расходов и обнаружения всплесков; используйте get_token_analytics, когда нужен объём токенов, а не денежная стоимость. Доступно только для Enterprise. Возвращает 403 для тарифов Portkey, отличных от Enterprise.

Получает данные временных рядов затрат с summary.total_cost, summary.average_cost_per_request и общими/средними затратами на сегмент. Используйте для анализа расходов и обнаружения всплесков; используйте get_token_analytics, когда нужен объём токенов, а не денежная стоимость. Доступно только для Enterprise. Возвращает 403 для тарифов Portkey, отличных от Enterprise.

Параметры

  • time_of_generation_minstringобязательный

    Start time for the analytics period (ISO8601 format, e.g., '2024-01-01T00:00:00Z')

  • time_of_generation_maxstringобязательный

    End time for the analytics period (ISO8601 format, e.g., '2024-02-01T00:00:00Z')

  • total_units_minnumber

    Minimum number of total tokens to filter by

  • total_units_maxnumber

    Maximum number of total tokens to filter by

  • cost_minnumber

    Minimum cost in cents to filter by

  • cost_maxnumber

    Maximum cost in cents to filter by

  • prompt_token_minnumber

    Minimum number of prompt tokens

  • prompt_token_maxnumber

    Maximum number of prompt tokens

  • completion_token_minnumber

    Minimum number of completion tokens

  • completion_token_maxnumber

    Maximum number of completion tokens

  • status_codestring

    Legacy Portkey query param for HTTP status codes. Comma-separated string; prefer status_codes for structured inputs.

  • weighted_feedback_minnumber

    Minimum weighted feedback score (-10 to 10)

  • weighted_feedback_maxnumber

    Maximum weighted feedback score (-10 to 10)

  • virtual_keysstring

    Legacy Portkey query param for virtual key slugs. Comma-separated string; prefer virtual_key_slugs for structured inputs.

  • configsstring

    Legacy Portkey query param for config slugs. Comma-separated string; prefer config_slugs for structured inputs.

  • status_codesstring[]

    Structured alias for status_code. Use an array of HTTP status codes; normalized to the legacy comma-separated Portkey query param.

  • virtual_key_slugsstring[]

    Structured alias for virtual_keys. Use an array of virtual key slugs; normalized to the legacy comma-separated Portkey query param.

  • config_slugsstring[]

    Structured alias for configs. Use an array of config slugs; normalized to the legacy comma-separated Portkey query param.

  • workspace_slugstring

    Filter by specific workspace

  • api_key_idsstring

    Legacy Portkey query param for API key UUIDs. Comma-separated string; request_analytics also accepts an array and normalizes it to this form.

  • metadatastring

    Legacy Portkey query param for metadata filtering. Stringified JSON object, e.g. '{"env":"prod","app":"myapp"}'; prefer metadata_filter for structured inputs.

  • ai_org_modelstring

    Legacy Portkey query param for provider/model pairs. Format: 'provider__model' with double underscore, e.g. 'openai__gpt-4' or 'anthropic__claude-3-opus'. Comma-separated string; prefer provider_models for structured inputs.

  • provider_modelsstring[]

    Structured alias for ai_org_model. Use provider__model strings in an array; normalized to the legacy comma-separated Portkey query param.

  • trace_idstring

    Legacy Portkey query param for trace IDs. Comma-separated string; prefer trace_ids for structured inputs.

  • trace_idsstring[]

    Structured alias for trace_id. Use an array of trace IDs; normalized to the legacy comma-separated Portkey query param.

  • span_idstring

    Legacy Portkey query param for span IDs. Comma-separated string; prefer span_ids for structured inputs.

  • span_idsstring[]

    Structured alias for span_id. Use an array of span IDs; normalized to the legacy comma-separated Portkey query param.

  • metadata_filterobject

    Structured alias for metadata. Use an object such as { env: 'prod' }; normalized to a JSON string before the request is sent.

  • prompt_slugstring

    Filter by prompt slug

get_error_analyticsтолько чтениеидемпотентныйвнешний мир

Получает данные временных рядов с количеством ошибок, включая summary.total_errors и количество по сегментам. Используйте это для общих трендов ошибок; для процентов — get_error_rate_analytics, а для детализации — get_error_status_codes_analytics и get_error_stacks_analytics. Доступен только в Enterprise. Возвращает 403 на не-Enterprise планах Portkey.

Получает данные временных рядов с количеством ошибок, включая summary.total_errors и количество по сегментам. Используйте это для общих трендов ошибок; для процентов — get_error_rate_analytics, а для детализации — get_error_status_codes_analytics и get_error_stacks_analytics. Доступен только в Enterprise. Возвращает 403 на не-Enterprise планах Portkey.

Параметры

  • time_of_generation_minstringобязательный

    Start time for the analytics period (ISO8601 format, e.g., '2024-01-01T00:00:00Z')

  • time_of_generation_maxstringобязательный

    End time for the analytics period (ISO8601 format, e.g., '2024-02-01T00:00:00Z')

  • total_units_minnumber

    Minimum number of total tokens to filter by

  • total_units_maxnumber

    Maximum number of total tokens to filter by

  • cost_minnumber

    Minimum cost in cents to filter by

  • cost_maxnumber

    Maximum cost in cents to filter by

  • prompt_token_minnumber

    Minimum number of prompt tokens

  • prompt_token_maxnumber

    Maximum number of prompt tokens

  • completion_token_minnumber

    Minimum number of completion tokens

  • completion_token_maxnumber

    Maximum number of completion tokens

  • status_codestring

    Legacy Portkey query param for HTTP status codes. Comma-separated string; prefer status_codes for structured inputs.

  • weighted_feedback_minnumber

    Minimum weighted feedback score (-10 to 10)

  • weighted_feedback_maxnumber

    Maximum weighted feedback score (-10 to 10)

  • virtual_keysstring

    Legacy Portkey query param for virtual key slugs. Comma-separated string; prefer virtual_key_slugs for structured inputs.

  • configsstring

    Legacy Portkey query param for config slugs. Comma-separated string; prefer config_slugs for structured inputs.

  • status_codesstring[]

    Structured alias for status_code. Use an array of HTTP status codes; normalized to the legacy comma-separated Portkey query param.

  • virtual_key_slugsstring[]

    Structured alias for virtual_keys. Use an array of virtual key slugs; normalized to the legacy comma-separated Portkey query param.

  • config_slugsstring[]

    Structured alias for configs. Use an array of config slugs; normalized to the legacy comma-separated Portkey query param.

  • workspace_slugstring

    Filter by specific workspace

  • api_key_idsstring

    Legacy Portkey query param for API key UUIDs. Comma-separated string; request_analytics also accepts an array and normalizes it to this form.

  • metadatastring

    Legacy Portkey query param for metadata filtering. Stringified JSON object, e.g. '{"env":"prod","app":"myapp"}'; prefer metadata_filter for structured inputs.

  • ai_org_modelstring

    Legacy Portkey query param for provider/model pairs. Format: 'provider__model' with double underscore, e.g. 'openai__gpt-4' or 'anthropic__claude-3-opus'. Comma-separated string; prefer provider_models for structured inputs.

  • provider_modelsstring[]

    Structured alias for ai_org_model. Use provider__model strings in an array; normalized to the legacy comma-separated Portkey query param.

  • trace_idstring

    Legacy Portkey query param for trace IDs. Comma-separated string; prefer trace_ids for structured inputs.

  • trace_idsstring[]

    Structured alias for trace_id. Use an array of trace IDs; normalized to the legacy comma-separated Portkey query param.

  • span_idstring

    Legacy Portkey query param for span IDs. Comma-separated string; prefer span_ids for structured inputs.

  • span_idsstring[]

    Structured alias for span_id. Use an array of span IDs; normalized to the legacy comma-separated Portkey query param.

  • metadata_filterobject

    Structured alias for metadata. Use an object such as { env: 'prod' }; normalized to a JSON string before the request is sent.

  • prompt_slugstring

    Filter by prompt slug

get_error_rate_analyticsтолько чтениеидемпотентныйвнешний мир

Получайте данные временных рядов по частоте ошибок с summary.error_rate_percent и процентным распределением по сегментам от общего числа запросов. Используйте это для отслеживания трендов надежности и SLA; для абсолютного количества ошибок используйте get_error_analytics. Только для Enterprise. Возвращает 403 на тарифах Portkey, не относящихся к Enterprise.

Получайте данные временных рядов по частоте ошибок с summary.error_rate_percent и процентным распределением по сегментам от общего числа запросов. Используйте это для отслеживания трендов надежности и SLA; для абсолютного количества ошибок используйте get_error_analytics. Только для Enterprise. Возвращает 403 на тарифах Portkey, не относящихся к Enterprise.

Параметры

  • time_of_generation_minstringобязательный

    Start time for the analytics period (ISO8601 format, e.g., '2024-01-01T00:00:00Z')

  • time_of_generation_maxstringобязательный

    End time for the analytics period (ISO8601 format, e.g., '2024-02-01T00:00:00Z')

  • total_units_minnumber

    Minimum number of total tokens to filter by

  • total_units_maxnumber

    Maximum number of total tokens to filter by

  • cost_minnumber

    Minimum cost in cents to filter by

  • cost_maxnumber

    Maximum cost in cents to filter by

  • prompt_token_minnumber

    Minimum number of prompt tokens

  • prompt_token_maxnumber

    Maximum number of prompt tokens

  • completion_token_minnumber

    Minimum number of completion tokens

  • completion_token_maxnumber

    Maximum number of completion tokens

  • status_codestring

    Legacy Portkey query param for HTTP status codes. Comma-separated string; prefer status_codes for structured inputs.

  • weighted_feedback_minnumber

    Minimum weighted feedback score (-10 to 10)

  • weighted_feedback_maxnumber

    Maximum weighted feedback score (-10 to 10)

  • virtual_keysstring

    Legacy Portkey query param for virtual key slugs. Comma-separated string; prefer virtual_key_slugs for structured inputs.

  • configsstring

    Legacy Portkey query param for config slugs. Comma-separated string; prefer config_slugs for structured inputs.

  • status_codesstring[]

    Structured alias for status_code. Use an array of HTTP status codes; normalized to the legacy comma-separated Portkey query param.

  • virtual_key_slugsstring[]

    Structured alias for virtual_keys. Use an array of virtual key slugs; normalized to the legacy comma-separated Portkey query param.

  • config_slugsstring[]

    Structured alias for configs. Use an array of config slugs; normalized to the legacy comma-separated Portkey query param.

  • workspace_slugstring

    Filter by specific workspace

  • api_key_idsstring

    Legacy Portkey query param for API key UUIDs. Comma-separated string; request_analytics also accepts an array and normalizes it to this form.

  • metadatastring

    Legacy Portkey query param for metadata filtering. Stringified JSON object, e.g. '{"env":"prod","app":"myapp"}'; prefer metadata_filter for structured inputs.

  • ai_org_modelstring

    Legacy Portkey query param for provider/model pairs. Format: 'provider__model' with double underscore, e.g. 'openai__gpt-4' or 'anthropic__claude-3-opus'. Comma-separated string; prefer provider_models for structured inputs.

  • provider_modelsstring[]

    Structured alias for ai_org_model. Use provider__model strings in an array; normalized to the legacy comma-separated Portkey query param.

  • trace_idstring

    Legacy Portkey query param for trace IDs. Comma-separated string; prefer trace_ids for structured inputs.

  • trace_idsstring[]

    Structured alias for trace_id. Use an array of trace IDs; normalized to the legacy comma-separated Portkey query param.

  • span_idstring

    Legacy Portkey query param for span IDs. Comma-separated string; prefer span_ids for structured inputs.

  • span_idsstring[]

    Structured alias for span_id. Use an array of span IDs; normalized to the legacy comma-separated Portkey query param.

  • metadata_filterobject

    Structured alias for metadata. Use an object such as { env: 'prod' }; normalized to a JSON string before the request is sent.

  • prompt_slugstring

    Filter by prompt slug

get_error_stacks_analyticsтолько чтениеидемпотентныйвнешний мир

Получает данные сгруппированных по времени серий ошибок со статистикой по кодам HTTP, включая общую сводку и отдельные серии для каждого кода. Используйте этот инструмент, чтобы понять, какие классы ошибок преобладают; для распределения по уникальным кодам используйте get_error_status_codes_analytics. Функция только для Enterprise-планов. Возвращает 403 на не-Enterprise тарифах Portkey.

Получает данные сгруппированных по времени серий ошибок со статистикой по кодам HTTP, включая общую сводку и отдельные серии для каждого кода. Используйте этот инструмент, чтобы понять, какие классы ошибок преобладают; для распределения по уникальным кодам используйте get_error_status_codes_analytics. Функция только для Enterprise-планов. Возвращает 403 на не-Enterprise тарифах Portkey.

Параметры

  • time_of_generation_minstringобязательный

    Start time for the analytics period (ISO8601 format, e.g., '2024-01-01T00:00:00Z')

  • time_of_generation_maxstringобязательный

    End time for the analytics period (ISO8601 format, e.g., '2024-02-01T00:00:00Z')

  • total_units_minnumber

    Minimum number of total tokens to filter by

  • total_units_maxnumber

    Maximum number of total tokens to filter by

  • cost_minnumber

    Minimum cost in cents to filter by

  • cost_maxnumber

    Maximum cost in cents to filter by

  • prompt_token_minnumber

    Minimum number of prompt tokens

  • prompt_token_maxnumber

    Maximum number of prompt tokens

  • completion_token_minnumber

    Minimum number of completion tokens

  • completion_token_maxnumber

    Maximum number of completion tokens

  • status_codestring

    Legacy Portkey query param for HTTP status codes. Comma-separated string; prefer status_codes for structured inputs.

  • weighted_feedback_minnumber

    Minimum weighted feedback score (-10 to 10)

  • weighted_feedback_maxnumber

    Maximum weighted feedback score (-10 to 10)

  • virtual_keysstring

    Legacy Portkey query param for virtual key slugs. Comma-separated string; prefer virtual_key_slugs for structured inputs.

  • configsstring

    Legacy Portkey query param for config slugs. Comma-separated string; prefer config_slugs for structured inputs.

  • status_codesstring[]

    Structured alias for status_code. Use an array of HTTP status codes; normalized to the legacy comma-separated Portkey query param.

  • virtual_key_slugsstring[]

    Structured alias for virtual_keys. Use an array of virtual key slugs; normalized to the legacy comma-separated Portkey query param.

  • config_slugsstring[]

    Structured alias for configs. Use an array of config slugs; normalized to the legacy comma-separated Portkey query param.

  • workspace_slugstring

    Filter by specific workspace

  • api_key_idsstring

    Legacy Portkey query param for API key UUIDs. Comma-separated string; request_analytics also accepts an array and normalizes it to this form.

  • metadatastring

    Legacy Portkey query param for metadata filtering. Stringified JSON object, e.g. '{"env":"prod","app":"myapp"}'; prefer metadata_filter for structured inputs.

  • ai_org_modelstring

    Legacy Portkey query param for provider/model pairs. Format: 'provider__model' with double underscore, e.g. 'openai__gpt-4' or 'anthropic__claude-3-opus'. Comma-separated string; prefer provider_models for structured inputs.

  • provider_modelsstring[]

    Structured alias for ai_org_model. Use provider__model strings in an array; normalized to the legacy comma-separated Portkey query param.

  • trace_idstring

    Legacy Portkey query param for trace IDs. Comma-separated string; prefer trace_ids for structured inputs.

  • trace_idsstring[]

    Structured alias for trace_id. Use an array of trace IDs; normalized to the legacy comma-separated Portkey query param.

  • span_idstring

    Legacy Portkey query param for span IDs. Comma-separated string; prefer span_ids for structured inputs.

  • span_idsstring[]

    Structured alias for span_id. Use an array of span IDs; normalized to the legacy comma-separated Portkey query param.

  • metadata_filterobject

    Structured alias for metadata. Use an object such as { env: 'prod' }; normalized to a JSON string before the request is sent.

  • prompt_slugstring

    Filter by prompt slug

get_error_status_codes_analyticsтолько чтениеидемпотентныйвнешний мир

Получает данные временного ряда распределения HTTP-кодов ошибок с общей сводкой и отдельными рядами для каждого кода. Используйте это, чтобы узнать, какие коды возникают чаще всего; для стековых или накопительных разбивок используйте get_error_stacks_analytics. Ограничено планом Enterprise. Возвращает 403 при использовании не-Enterprise планов Portkey.

Получает данные временного ряда распределения HTTP-кодов ошибок с общей сводкой и отдельными рядами для каждого кода. Используйте это, чтобы узнать, какие коды возникают чаще всего; для стековых или накопительных разбивок используйте get_error_stacks_analytics. Ограничено планом Enterprise. Возвращает 403 при использовании не-Enterprise планов Portkey.

Параметры

  • time_of_generation_minstringобязательный

    Start time for the analytics period (ISO8601 format, e.g., '2024-01-01T00:00:00Z')

  • time_of_generation_maxstringобязательный

    End time for the analytics period (ISO8601 format, e.g., '2024-02-01T00:00:00Z')

  • total_units_minnumber

    Minimum number of total tokens to filter by

  • total_units_maxnumber

    Maximum number of total tokens to filter by

  • cost_minnumber

    Minimum cost in cents to filter by

  • cost_maxnumber

    Maximum cost in cents to filter by

  • prompt_token_minnumber

    Minimum number of prompt tokens

  • prompt_token_maxnumber

    Maximum number of prompt tokens

  • completion_token_minnumber

    Minimum number of completion tokens

  • completion_token_maxnumber

    Maximum number of completion tokens

  • status_codestring

    Legacy Portkey query param for HTTP status codes. Comma-separated string; prefer status_codes for structured inputs.

  • weighted_feedback_minnumber

    Minimum weighted feedback score (-10 to 10)

  • weighted_feedback_maxnumber

    Maximum weighted feedback score (-10 to 10)

  • virtual_keysstring

    Legacy Portkey query param for virtual key slugs. Comma-separated string; prefer virtual_key_slugs for structured inputs.

  • configsstring

    Legacy Portkey query param for config slugs. Comma-separated string; prefer config_slugs for structured inputs.

  • status_codesstring[]

    Structured alias for status_code. Use an array of HTTP status codes; normalized to the legacy comma-separated Portkey query param.

  • virtual_key_slugsstring[]

    Structured alias for virtual_keys. Use an array of virtual key slugs; normalized to the legacy comma-separated Portkey query param.

  • config_slugsstring[]

    Structured alias for configs. Use an array of config slugs; normalized to the legacy comma-separated Portkey query param.

  • workspace_slugstring

    Filter by specific workspace

  • api_key_idsstring

    Legacy Portkey query param for API key UUIDs. Comma-separated string; request_analytics also accepts an array and normalizes it to this form.

  • metadatastring

    Legacy Portkey query param for metadata filtering. Stringified JSON object, e.g. '{"env":"prod","app":"myapp"}'; prefer metadata_filter for structured inputs.

  • ai_org_modelstring

    Legacy Portkey query param for provider/model pairs. Format: 'provider__model' with double underscore, e.g. 'openai__gpt-4' or 'anthropic__claude-3-opus'. Comma-separated string; prefer provider_models for structured inputs.

  • provider_modelsstring[]

    Structured alias for ai_org_model. Use provider__model strings in an array; normalized to the legacy comma-separated Portkey query param.

  • trace_idstring

    Legacy Portkey query param for trace IDs. Comma-separated string; prefer trace_ids for structured inputs.

  • trace_idsstring[]

    Structured alias for trace_id. Use an array of trace IDs; normalized to the legacy comma-separated Portkey query param.

  • span_idstring

    Legacy Portkey query param for span IDs. Comma-separated string; prefer span_ids for structured inputs.

  • span_idsstring[]

    Structured alias for span_id. Use an array of span IDs; normalized to the legacy comma-separated Portkey query param.

  • metadata_filterobject

    Structured alias for metadata. Use an object such as { env: 'prod' }; normalized to a JSON string before the request is sent.

  • prompt_slugstring

    Filter by prompt slug

get_feedback_analyticsтолько чтениеидемпотентныйвнешний мир

Получает временные ряды данных по отправке обратной связи с итоговыми суммами и количеством по категориям. Используйте это как представление тренда обратной связи верхнего уровня; для детализации используйте get_feedback_models_analytics, get_feedback_scores_analytics или get_feedback_weighted_analytics. Доступно только для Enterprise. Возвращает 403 для планов Portkey, не являющихся корпоративными.

Получает временные ряды данных по отправке обратной связи с итоговыми суммами и количеством по категориям. Используйте это как представление тренда обратной связи верхнего уровня; для детализации используйте get_feedback_models_analytics, get_feedback_scores_analytics или get_feedback_weighted_analytics. Доступно только для Enterprise. Возвращает 403 для планов Portkey, не являющихся корпоративными.

Параметры

  • time_of_generation_minstringобязательный

    Start time for the analytics period (ISO8601 format, e.g., '2024-01-01T00:00:00Z')

  • time_of_generation_maxstringобязательный

    End time for the analytics period (ISO8601 format, e.g., '2024-02-01T00:00:00Z')

  • total_units_minnumber

    Minimum number of total tokens to filter by

  • total_units_maxnumber

    Maximum number of total tokens to filter by

  • cost_minnumber

    Minimum cost in cents to filter by

  • cost_maxnumber

    Maximum cost in cents to filter by

  • prompt_token_minnumber

    Minimum number of prompt tokens

  • prompt_token_maxnumber

    Maximum number of prompt tokens

  • completion_token_minnumber

    Minimum number of completion tokens

  • completion_token_maxnumber

    Maximum number of completion tokens

  • status_codestring

    Legacy Portkey query param for HTTP status codes. Comma-separated string; prefer status_codes for structured inputs.

  • weighted_feedback_minnumber

    Minimum weighted feedback score (-10 to 10)

  • weighted_feedback_maxnumber

    Maximum weighted feedback score (-10 to 10)

  • virtual_keysstring

    Legacy Portkey query param for virtual key slugs. Comma-separated string; prefer virtual_key_slugs for structured inputs.

  • configsstring

    Legacy Portkey query param for config slugs. Comma-separated string; prefer config_slugs for structured inputs.

  • status_codesstring[]

    Structured alias for status_code. Use an array of HTTP status codes; normalized to the legacy comma-separated Portkey query param.

  • virtual_key_slugsstring[]

    Structured alias for virtual_keys. Use an array of virtual key slugs; normalized to the legacy comma-separated Portkey query param.

  • config_slugsstring[]

    Structured alias for configs. Use an array of config slugs; normalized to the legacy comma-separated Portkey query param.

  • workspace_slugstring

    Filter by specific workspace

  • api_key_idsstring

    Legacy Portkey query param for API key UUIDs. Comma-separated string; request_analytics also accepts an array and normalizes it to this form.

  • metadatastring

    Legacy Portkey query param for metadata filtering. Stringified JSON object, e.g. '{"env":"prod","app":"myapp"}'; prefer metadata_filter for structured inputs.

  • ai_org_modelstring

    Legacy Portkey query param for provider/model pairs. Format: 'provider__model' with double underscore, e.g. 'openai__gpt-4' or 'anthropic__claude-3-opus'. Comma-separated string; prefer provider_models for structured inputs.

  • provider_modelsstring[]

    Structured alias for ai_org_model. Use provider__model strings in an array; normalized to the legacy comma-separated Portkey query param.

  • trace_idstring

    Legacy Portkey query param for trace IDs. Comma-separated string; prefer trace_ids for structured inputs.

  • trace_idsstring[]

    Structured alias for trace_id. Use an array of trace IDs; normalized to the legacy comma-separated Portkey query param.

  • span_idstring

    Legacy Portkey query param for span IDs. Comma-separated string; prefer span_ids for structured inputs.

  • span_idsstring[]

    Structured alias for span_id. Use an array of span IDs; normalized to the legacy comma-separated Portkey query param.

  • metadata_filterobject

    Structured alias for metadata. Use an object such as { env: 'prod' }; normalized to a JSON string before the request is sent.

  • prompt_slugstring

    Filter by prompt slug

get_feedback_models_analyticsтолько чтениеидемпотентныйвнешний мир

Получает данные временных рядов отзывов, сгруппированные по моделям, с количеством по каждой модели за период. Используйте это, чтобы сравнить объём отзывов и удовлетворённость по моделям; для общего итога используйте get_feedback_analytics. Доступно только для Enterprise. Возвращает 403 на тарифах Portkey, отличных от Enterprise.

Получает данные временных рядов отзывов, сгруппированные по моделям, с количеством по каждой модели за период. Используйте это, чтобы сравнить объём отзывов и удовлетворённость по моделям; для общего итога используйте get_feedback_analytics. Доступно только для Enterprise. Возвращает 403 на тарифах Portkey, отличных от Enterprise.

Параметры

  • time_of_generation_minstringобязательный

    Start time for the analytics period (ISO8601 format, e.g., '2024-01-01T00:00:00Z')

  • time_of_generation_maxstringобязательный

    End time for the analytics period (ISO8601 format, e.g., '2024-02-01T00:00:00Z')

  • total_units_minnumber

    Minimum number of total tokens to filter by

  • total_units_maxnumber

    Maximum number of total tokens to filter by

  • cost_minnumber

    Minimum cost in cents to filter by

  • cost_maxnumber

    Maximum cost in cents to filter by

  • prompt_token_minnumber

    Minimum number of prompt tokens

  • prompt_token_maxnumber

    Maximum number of prompt tokens

  • completion_token_minnumber

    Minimum number of completion tokens

  • completion_token_maxnumber

    Maximum number of completion tokens

  • status_codestring

    Legacy Portkey query param for HTTP status codes. Comma-separated string; prefer status_codes for structured inputs.

  • weighted_feedback_minnumber

    Minimum weighted feedback score (-10 to 10)

  • weighted_feedback_maxnumber

    Maximum weighted feedback score (-10 to 10)

  • virtual_keysstring

    Legacy Portkey query param for virtual key slugs. Comma-separated string; prefer virtual_key_slugs for structured inputs.

  • configsstring

    Legacy Portkey query param for config slugs. Comma-separated string; prefer config_slugs for structured inputs.

  • status_codesstring[]

    Structured alias for status_code. Use an array of HTTP status codes; normalized to the legacy comma-separated Portkey query param.

  • virtual_key_slugsstring[]

    Structured alias for virtual_keys. Use an array of virtual key slugs; normalized to the legacy comma-separated Portkey query param.

  • config_slugsstring[]

    Structured alias for configs. Use an array of config slugs; normalized to the legacy comma-separated Portkey query param.

  • workspace_slugstring

    Filter by specific workspace

  • api_key_idsstring

    Legacy Portkey query param for API key UUIDs. Comma-separated string; request_analytics also accepts an array and normalizes it to this form.

  • metadatastring

    Legacy Portkey query param for metadata filtering. Stringified JSON object, e.g. '{"env":"prod","app":"myapp"}'; prefer metadata_filter for structured inputs.

  • ai_org_modelstring

    Legacy Portkey query param for provider/model pairs. Format: 'provider__model' with double underscore, e.g. 'openai__gpt-4' or 'anthropic__claude-3-opus'. Comma-separated string; prefer provider_models for structured inputs.

  • provider_modelsstring[]

    Structured alias for ai_org_model. Use provider__model strings in an array; normalized to the legacy comma-separated Portkey query param.

  • trace_idstring

    Legacy Portkey query param for trace IDs. Comma-separated string; prefer trace_ids for structured inputs.

  • trace_idsstring[]

    Structured alias for trace_id. Use an array of trace IDs; normalized to the legacy comma-separated Portkey query param.

  • span_idstring

    Legacy Portkey query param for span IDs. Comma-separated string; prefer span_ids for structured inputs.

  • span_idsstring[]

    Structured alias for span_id. Use an array of span IDs; normalized to the legacy comma-separated Portkey query param.

  • metadata_filterobject

    Structured alias for metadata. Use an object such as { env: 'prod' }; normalized to a JSON string before the request is sent.

  • prompt_slugstring

    Filter by prompt slug

get_feedback_scores_analyticsтолько чтениеидемпотентныйвнешний мир

Получает сырые данные временного ряда распределения оценок обратной связи с разбивкой по баллам. Используйте это, чтобы понять тональность отзывов; используйте get_feedback_weighted_analytics для калиброванных оценок с весами. Только для Enterprise. Возвращает 403 на тарифах Portkey без Enterprise.

Получает сырые данные временного ряда распределения оценок обратной связи с разбивкой по баллам. Используйте это, чтобы понять тональность отзывов; используйте get_feedback_weighted_analytics для калиброванных оценок с весами. Только для Enterprise. Возвращает 403 на тарифах Portkey без Enterprise.

Параметры

  • time_of_generation_minstringобязательный

    Start time for the analytics period (ISO8601 format, e.g., '2024-01-01T00:00:00Z')

  • time_of_generation_maxstringобязательный

    End time for the analytics period (ISO8601 format, e.g., '2024-02-01T00:00:00Z')

  • total_units_minnumber

    Minimum number of total tokens to filter by

  • total_units_maxnumber

    Maximum number of total tokens to filter by

  • cost_minnumber

    Minimum cost in cents to filter by

  • cost_maxnumber

    Maximum cost in cents to filter by

  • prompt_token_minnumber

    Minimum number of prompt tokens

  • prompt_token_maxnumber

    Maximum number of prompt tokens

  • completion_token_minnumber

    Minimum number of completion tokens

  • completion_token_maxnumber

    Maximum number of completion tokens

  • status_codestring

    Legacy Portkey query param for HTTP status codes. Comma-separated string; prefer status_codes for structured inputs.

  • weighted_feedback_minnumber

    Minimum weighted feedback score (-10 to 10)

  • weighted_feedback_maxnumber

    Maximum weighted feedback score (-10 to 10)

  • virtual_keysstring

    Legacy Portkey query param for virtual key slugs. Comma-separated string; prefer virtual_key_slugs for structured inputs.

  • configsstring

    Legacy Portkey query param for config slugs. Comma-separated string; prefer config_slugs for structured inputs.

  • status_codesstring[]

    Structured alias for status_code. Use an array of HTTP status codes; normalized to the legacy comma-separated Portkey query param.

  • virtual_key_slugsstring[]

    Structured alias for virtual_keys. Use an array of virtual key slugs; normalized to the legacy comma-separated Portkey query param.

  • config_slugsstring[]

    Structured alias for configs. Use an array of config slugs; normalized to the legacy comma-separated Portkey query param.

  • workspace_slugstring

    Filter by specific workspace

  • api_key_idsstring

    Legacy Portkey query param for API key UUIDs. Comma-separated string; request_analytics also accepts an array and normalizes it to this form.

  • metadatastring

    Legacy Portkey query param for metadata filtering. Stringified JSON object, e.g. '{"env":"prod","app":"myapp"}'; prefer metadata_filter for structured inputs.

  • ai_org_modelstring

    Legacy Portkey query param for provider/model pairs. Format: 'provider__model' with double underscore, e.g. 'openai__gpt-4' or 'anthropic__claude-3-opus'. Comma-separated string; prefer provider_models for structured inputs.

  • provider_modelsstring[]

    Structured alias for ai_org_model. Use provider__model strings in an array; normalized to the legacy comma-separated Portkey query param.

  • trace_idstring

    Legacy Portkey query param for trace IDs. Comma-separated string; prefer trace_ids for structured inputs.

  • trace_idsstring[]

    Structured alias for trace_id. Use an array of trace IDs; normalized to the legacy comma-separated Portkey query param.

  • span_idstring

    Legacy Portkey query param for span IDs. Comma-separated string; prefer span_ids for structured inputs.

  • span_idsstring[]

    Structured alias for span_id. Use an array of span IDs; normalized to the legacy comma-separated Portkey query param.

  • metadata_filterobject

    Structured alias for metadata. Use an object such as { env: 'prod' }; normalized to a JSON string before the request is sent.

  • prompt_slugstring

    Filter by prompt slug

get_feedback_weighted_analyticsтолько чтениеидемпотентныйвнешний мир

Получите взвешенные данные временных рядов оценки отзывов, используя вес, зафиксированный при создании отзыва. Используйте это для калиброванных метрик качества; для сырого невзвешенного распределения используйте get_feedback_scores_analytics. Только для Enterprise. Возвращает 403 на не-Enterprise тарифах Portkey.

Получите взвешенные данные временных рядов оценки отзывов, используя вес, зафиксированный при создании отзыва. Используйте это для калиброванных метрик качества; для сырого невзвешенного распределения используйте get_feedback_scores_analytics. Только для Enterprise. Возвращает 403 на не-Enterprise тарифах Portkey.

Параметры

  • time_of_generation_minstringобязательный

    Start time for the analytics period (ISO8601 format, e.g., '2024-01-01T00:00:00Z')

  • time_of_generation_maxstringобязательный

    End time for the analytics period (ISO8601 format, e.g., '2024-02-01T00:00:00Z')

  • total_units_minnumber

    Minimum number of total tokens to filter by

  • total_units_maxnumber

    Maximum number of total tokens to filter by

  • cost_minnumber

    Minimum cost in cents to filter by

  • cost_maxnumber

    Maximum cost in cents to filter by

  • prompt_token_minnumber

    Minimum number of prompt tokens

  • prompt_token_maxnumber

    Maximum number of prompt tokens

  • completion_token_minnumber

    Minimum number of completion tokens

  • completion_token_maxnumber

    Maximum number of completion tokens

  • status_codestring

    Legacy Portkey query param for HTTP status codes. Comma-separated string; prefer status_codes for structured inputs.

  • weighted_feedback_minnumber

    Minimum weighted feedback score (-10 to 10)

  • weighted_feedback_maxnumber

    Maximum weighted feedback score (-10 to 10)

  • virtual_keysstring

    Legacy Portkey query param for virtual key slugs. Comma-separated string; prefer virtual_key_slugs for structured inputs.

  • configsstring

    Legacy Portkey query param for config slugs. Comma-separated string; prefer config_slugs for structured inputs.

  • status_codesstring[]

    Structured alias for status_code. Use an array of HTTP status codes; normalized to the legacy comma-separated Portkey query param.

  • virtual_key_slugsstring[]

    Structured alias for virtual_keys. Use an array of virtual key slugs; normalized to the legacy comma-separated Portkey query param.

  • config_slugsstring[]

    Structured alias for configs. Use an array of config slugs; normalized to the legacy comma-separated Portkey query param.

  • workspace_slugstring

    Filter by specific workspace

  • api_key_idsstring

    Legacy Portkey query param for API key UUIDs. Comma-separated string; request_analytics also accepts an array and normalizes it to this form.

  • metadatastring

    Legacy Portkey query param for metadata filtering. Stringified JSON object, e.g. '{"env":"prod","app":"myapp"}'; prefer metadata_filter for structured inputs.

  • ai_org_modelstring

    Legacy Portkey query param for provider/model pairs. Format: 'provider__model' with double underscore, e.g. 'openai__gpt-4' or 'anthropic__claude-3-opus'. Comma-separated string; prefer provider_models for structured inputs.

  • provider_modelsstring[]

    Structured alias for ai_org_model. Use provider__model strings in an array; normalized to the legacy comma-separated Portkey query param.

  • trace_idstring

    Legacy Portkey query param for trace IDs. Comma-separated string; prefer trace_ids for structured inputs.

  • trace_idsstring[]

    Structured alias for trace_id. Use an array of trace IDs; normalized to the legacy comma-separated Portkey query param.

  • span_idstring

    Legacy Portkey query param for span IDs. Comma-separated string; prefer span_ids for structured inputs.

  • span_idsstring[]

    Structured alias for span_id. Use an array of span IDs; normalized to the legacy comma-separated Portkey query param.

  • metadata_filterobject

    Structured alias for metadata. Use an object such as { env: 'prod' }; normalized to a JSON string before the request is sent.

  • prompt_slugstring

    Filter by prompt slug

get_guardrailтолько чтениеидемпотентныйвнешний мир

Получает один guardrail по id или slug с полным набором проверок и действий; сначала используйте list_guardrails для поиска id. Используйте перед update_guardrail или delete_guardrail, когда нужна точная политика принуждения, и возвращает полную конфигурацию проверок и действий вместе со статусом и владельцем.

Получает один guardrail по id или slug с полным набором проверок и действий; сначала используйте list_guardrails для поиска id. Используйте перед update_guardrail или delete_guardrail, когда нужна точная политика принуждения, и возвращает полную конфигурацию проверок и действий вместе со статусом и владельцем.

Параметры

  • guardrail_idstringобязательный

    The guardrail UUID or slug (with guard_ prefix) to retrieve

get_integrationтолько чтениеидемпотентныйвнешний мир

Получает одну интеграцию по slug, включая маскированный ключ, доступ к рабочему пространству, разрешённые модели и метаданные конфигурации. Используйте это перед редактированием настроек конкретного провайдера или аудитом доступа. Только для Enterprise. Возвращает 403 для не-Enterprise планов Portkey.

Получает одну интеграцию по slug, включая маскированный ключ, доступ к рабочему пространству, разрешённые модели и метаданные конфигурации. Используйте это перед редактированием настроек конкретного провайдера или аудитом доступа. Только для Enterprise. Возвращает 403 для не-Enterprise планов Portkey.

Параметры

  • slugstringобязательный

    The unique slug identifier of the integration to retrieve

get_latency_analyticsтолько чтениеидемпотентныйвнешний мир

Получает данные временных рядов задержки с summary.avg_latency_ms, summary.p50_latency_ms, summary.p90_latency_ms, summary.p99_latency_ms и процентилями задержки по корзинам в миллисекундах. Используйте это для обнаружения замедлений и регрессий; используйте get_cache_hit_latency, если вам нужна только задержка попаданий в кэш. Ограничено Enterprise. Возвращает 403 на не-Enterprise планах Portkey.

Получает данные временных рядов задержки с summary.avg_latency_ms, summary.p50_latency_ms, summary.p90_latency_ms, summary.p99_latency_ms и процентилями задержки по корзинам в миллисекундах. Используйте это для обнаружения замедлений и регрессий; используйте get_cache_hit_latency, если вам нужна только задержка попаданий в кэш. Ограничено Enterprise. Возвращает 403 на не-Enterprise планах Portkey.

Параметры

  • time_of_generation_minstringобязательный

    Start time for the analytics period (ISO8601 format, e.g., '2024-01-01T00:00:00Z')

  • time_of_generation_maxstringобязательный

    End time for the analytics period (ISO8601 format, e.g., '2024-02-01T00:00:00Z')

  • total_units_minnumber

    Minimum number of total tokens to filter by

  • total_units_maxnumber

    Maximum number of total tokens to filter by

  • cost_minnumber

    Minimum cost in cents to filter by

  • cost_maxnumber

    Maximum cost in cents to filter by

  • prompt_token_minnumber

    Minimum number of prompt tokens

  • prompt_token_maxnumber

    Maximum number of prompt tokens

  • completion_token_minnumber

    Minimum number of completion tokens

  • completion_token_maxnumber

    Maximum number of completion tokens

  • status_codestring

    Legacy Portkey query param for HTTP status codes. Comma-separated string; prefer status_codes for structured inputs.

  • weighted_feedback_minnumber

    Minimum weighted feedback score (-10 to 10)

  • weighted_feedback_maxnumber

    Maximum weighted feedback score (-10 to 10)

  • virtual_keysstring

    Legacy Portkey query param for virtual key slugs. Comma-separated string; prefer virtual_key_slugs for structured inputs.

  • configsstring

    Legacy Portkey query param for config slugs. Comma-separated string; prefer config_slugs for structured inputs.

  • status_codesstring[]

    Structured alias for status_code. Use an array of HTTP status codes; normalized to the legacy comma-separated Portkey query param.

  • virtual_key_slugsstring[]

    Structured alias for virtual_keys. Use an array of virtual key slugs; normalized to the legacy comma-separated Portkey query param.

  • config_slugsstring[]

    Structured alias for configs. Use an array of config slugs; normalized to the legacy comma-separated Portkey query param.

  • workspace_slugstring

    Filter by specific workspace

  • api_key_idsstring

    Legacy Portkey query param for API key UUIDs. Comma-separated string; request_analytics also accepts an array and normalizes it to this form.

  • metadatastring

    Legacy Portkey query param for metadata filtering. Stringified JSON object, e.g. '{"env":"prod","app":"myapp"}'; prefer metadata_filter for structured inputs.

  • ai_org_modelstring

    Legacy Portkey query param for provider/model pairs. Format: 'provider__model' with double underscore, e.g. 'openai__gpt-4' or 'anthropic__claude-3-opus'. Comma-separated string; prefer provider_models for structured inputs.

  • provider_modelsstring[]

    Structured alias for ai_org_model. Use provider__model strings in an array; normalized to the legacy comma-separated Portkey query param.

  • trace_idstring

    Legacy Portkey query param for trace IDs. Comma-separated string; prefer trace_ids for structured inputs.

  • trace_idsstring[]

    Structured alias for trace_id. Use an array of trace IDs; normalized to the legacy comma-separated Portkey query param.

  • span_idstring

    Legacy Portkey query param for span IDs. Comma-separated string; prefer span_ids for structured inputs.

  • span_idsstring[]

    Structured alias for span_id. Use an array of span IDs; normalized to the legacy comma-separated Portkey query param.

  • metadata_filterobject

    Structured alias for metadata. Use an object such as { env: 'prod' }; normalized to a JSON string before the request is sent.

  • prompt_slugstring

    Filter by prompt slug

get_log_exportтолько чтениеидемпотентныйвнешний мир

Получить одну задачу экспорта логов по export_id и вернуть её статус, фильтры, запрошенные поля и метаданные файла. Используйте это, когда вы уже знаете цель; используйте list_log_exports для обзора рабочего пространства.

Получить одну задачу экспорта логов по export_id и вернуть её статус, фильтры, запрошенные поля и метаданные файла. Используйте это, когда вы уже знаете цель; используйте list_log_exports для обзора рабочего пространства.

Параметры

  • export_idstringобязательный

    The unique ID of the log export

get_mcp_integrationтолько чтениеидемпотентныйвнешний мир

Извлекает одну интеграцию MCP по идентификатору или слагу. Возвращает полную конфигурацию со стороны Portkey, включая тип аутентификации, транспорт и маскированные ключи конфигурации; используйте get_mcp_integration_metadata для метаданных, сообщённых самим сервером.

Извлекает одну интеграцию MCP по идентификатору или слагу. Возвращает полную конфигурацию со стороны Portkey, включая тип аутентификации, транспорт и маскированные ключи конфигурации; используйте get_mcp_integration_metadata для метаданных, сообщённых самим сервером.

Параметры

  • idstringобязательный

    The MCP integration ID or slug to retrieve

get_mcp_integration_metadataтолько чтениеидемпотентныйвнешний мир

Получает самостоятельно сообщаемые метаданные внешнего MCP-сервера для интеграции. Возвращает имя, версию, протокол, флаги возможностей и статус синхронизации; используйте get_mcp_integration для конфигурации подключения на стороне Portkey.

Получает самостоятельно сообщаемые метаданные внешнего MCP-сервера для интеграции. Возвращает имя, версию, протокол, флаги возможностей и статус синхронизации; используйте get_mcp_integration для конфигурации подключения на стороне Portkey.

Параметры

  • idstringобязательный

    The MCP integration ID or slug

get_mcp_serverтолько чтениеидемпотентныйвнешний мир

Получить MCP сервер по id или slug. Возвращает детали сервера, включая родительскую интеграцию, статус и время создания; используйте get_mcp_server, когда вам нужна запись сервера, а не конфигурация интеграции.

Получить MCP сервер по id или slug. Возвращает детали сервера, включая родительскую интеграцию, статус и время создания; используйте get_mcp_server, когда вам нужна запись сервера, а не конфигурация интеграции.

Параметры

  • idstringобязательный

    The MCP server ID or slug to retrieve

get_promptтолько чтениеидемпотентныйвнешний мир

Получает полное определение, активную версию и историю версий промпта. Используйте это перед обновлением, публикацией, рендерингом или копированием промпта, когда нужен сохранённый шаблон и метаданные. Для чат-промптов с несколькими сообщениями передавайте сообщения (предпочтительно) или JSON-кодированный массив в виде строки.

Получает полное определение, активную версию и историю версий промпта. Используйте это перед обновлением, публикацией, рендерингом или копированием промпта, когда нужен сохранённый шаблон и метаданные. Для чат-промптов с несколькими сообщениями передавайте сообщения (предпочтительно) или JSON-кодированный массив в виде строки.

Параметры

  • prompt_idstringобязательный

    Prompt ID or slug to retrieve

get_prompt_labelтолько чтениеидемпотентныйвнешний мир

Получает полное определение одной метки, включая область видимости, цвет и статус. Используйте это, когда вы уже знаете label_id; list_prompt_labels лучше подходит для просмотра кандидатов.

Получает полное определение одной метки, включая область видимости, цвет и статус. Используйте это, когда вы уже знаете label_id; list_prompt_labels лучше подходит для просмотра кандидатов.

Параметры

  • label_idstringобязательный

    Label ID to retrieve

  • organisation_idstring

    Organisation ID for filtering

  • workspace_idstring

    Workspace ID for filtering

get_prompt_partialтолько чтениеидемпотентныйвнешний мир

Получает содержимое partial и информацию о текущей версии. Используйте перед встраиванием, обновлением или проверкой того, на что разрешается {{> partial_name}}; возвращает сохранённую строку и метаданные версии.

Получает содержимое partial и информацию о текущей версии. Используйте перед встраиванием, обновлением или проверкой того, на что разрешается {{> partial_name}}; возвращает сохранённую строку и метаданные версии.

Параметры

  • prompt_partial_idstringобязательный

    Prompt partial ID or slug to retrieve

get_prompt_versionтолько чтениеидемпотентныйвнешний мир

Получите конкретную версию промпта по её UUID версии. Сначала используйте list_prompt_versions, чтобы найти id; возвращает шаблон, параметры и конфигурацию модели для этой версии.

Получите конкретную версию промпта по её UUID версии. Сначала используйте list_prompt_versions, чтобы найти id; возвращает шаблон, параметры и конфигурацию модели для этой версии.

Параметры

  • prompt_idstringобязательный

    Prompt ID or slug

  • version_idstringобязательный

    Version UUID to retrieve

get_providerтолько чтениеидемпотентныйвнешний мир

Получите одного провайдера по слагу, включая лимиты, настройки тарифов, срок действия и статус сброса. Используйте это для проверки потребления или аудита конфигурации перед обновлением.

Получите одного провайдера по слагу, включая лимиты, настройки тарифов, срок действия и статус сброса. Используйте это для проверки потребления или аудита конфигурации перед обновлением.

Параметры

  • slugstringобязательный

    The unique slug identifier of the provider to retrieve

  • workspace_idstring

    Workspace ID - required when using organization admin keys

get_rate_limitтолько чтениеидемпотентныйвнешний мир

Получите одно ограничение скорости по идентификатору и верните его полные условия и определение группировки. Сначала используйте list_rate_limits, чтобы узнать идентификаторы или сравнить политики.

Получите одно ограничение скорости по идентификатору и верните его полные условия и определение группировки. Сначала используйте list_rate_limits, чтобы узнать идентификаторы или сравнить политики.

Параметры

  • idstringобязательный

    The unique identifier of the rate limit

get_request_analyticsтолько чтениеидемпотентныйвнешний мир

Получает временные ряды данных об объёме запросов с summary.total_requests, summary.successful_requests, summary.failed_requests и счётчиками total/success/failed для каждого bucket. Используйте это для трендов трафика и надёжности; используйте get_error_analytics, когда нужны только количества ошибок. Enterprise-gated. Возвращает 403 на не-Enterprise тарифах Portkey.

Получает временные ряды данных об объёме запросов с summary.total_requests, summary.successful_requests, summary.failed_requests и счётчиками total/success/failed для каждого bucket. Используйте это для трендов трафика и надёжности; используйте get_error_analytics, когда нужны только количества ошибок. Enterprise-gated. Возвращает 403 на не-Enterprise тарифах Portkey.

Параметры

  • time_of_generation_minstringобязательный

    Start time for the analytics period (ISO8601 format, e.g., '2024-01-01T00:00:00Z')

  • time_of_generation_maxstringобязательный

    End time for the analytics period (ISO8601 format, e.g., '2024-02-01T00:00:00Z')

  • total_units_minnumber

    Minimum number of total tokens to filter by

  • total_units_maxnumber

    Maximum number of total tokens to filter by

  • cost_minnumber

    Minimum cost in cents to filter by

  • cost_maxnumber

    Maximum cost in cents to filter by

  • prompt_token_minnumber

    Minimum number of prompt tokens

  • prompt_token_maxnumber

    Maximum number of prompt tokens

  • completion_token_minnumber

    Minimum number of completion tokens

  • completion_token_maxnumber

    Maximum number of completion tokens

  • status_codestring

    Legacy Portkey query param for HTTP status codes. Comma-separated string; prefer status_codes for structured inputs.

  • weighted_feedback_minnumber

    Minimum weighted feedback score (-10 to 10)

  • weighted_feedback_maxnumber

    Maximum weighted feedback score (-10 to 10)

  • virtual_keysstring

    Legacy Portkey query param for virtual key slugs. Comma-separated string; prefer virtual_key_slugs for structured inputs.

  • configsstring

    Legacy Portkey query param for config slugs. Comma-separated string; prefer config_slugs for structured inputs.

  • status_codesstring[]

    Structured alias for status_code. Use an array of HTTP status codes; normalized to the legacy comma-separated Portkey query param.

  • virtual_key_slugsstring[]

    Structured alias for virtual_keys. Use an array of virtual key slugs; normalized to the legacy comma-separated Portkey query param.

  • config_slugsstring[]

    Structured alias for configs. Use an array of config slugs; normalized to the legacy comma-separated Portkey query param.

  • workspace_slugstring

    Filter by specific workspace

  • api_key_idsstring

    Legacy Portkey query param for API key UUIDs. Comma-separated string; request_analytics also accepts an array and normalizes it to this form.

  • metadatastring

    Legacy Portkey query param for metadata filtering. Stringified JSON object, e.g. '{"env":"prod","app":"myapp"}'; prefer metadata_filter for structured inputs.

  • ai_org_modelstring

    Legacy Portkey query param for provider/model pairs. Format: 'provider__model' with double underscore, e.g. 'openai__gpt-4' or 'anthropic__claude-3-opus'. Comma-separated string; prefer provider_models for structured inputs.

  • provider_modelsstring[]

    Structured alias for ai_org_model. Use provider__model strings in an array; normalized to the legacy comma-separated Portkey query param.

  • trace_idstring

    Legacy Portkey query param for trace IDs. Comma-separated string; prefer trace_ids for structured inputs.

  • trace_idsstring[]

    Structured alias for trace_id. Use an array of trace IDs; normalized to the legacy comma-separated Portkey query param.

  • span_idstring

    Legacy Portkey query param for span IDs. Comma-separated string; prefer span_ids for structured inputs.

  • span_idsstring[]

    Structured alias for span_id. Use an array of span IDs; normalized to the legacy comma-separated Portkey query param.

  • metadata_filterobject

    Structured alias for metadata. Use an object such as { env: 'prod' }; normalized to a JSON string before the request is sent.

  • prompt_slugstring

    Filter by prompt slug

get_rescued_requests_analyticsтолько чтениеидемпотентныйвнешний мир

Получает временные ряды данных о запросах, восстановленных с помощью повторных попыток или обработки аварийного переключения. Используйте это, только если в ваших конфигах есть механизмы отказоустойчивости, и измеряйте, как часто логика восстановления спасала запросы. Enterprise-gated. Возвращает 403 на планах Portkey, не относящихся к Enterprise.

Получает временные ряды данных о запросах, восстановленных с помощью повторных попыток или обработки аварийного переключения. Используйте это, только если в ваших конфигах есть механизмы отказоустойчивости, и измеряйте, как часто логика восстановления спасала запросы. Enterprise-gated. Возвращает 403 на планах Portkey, не относящихся к Enterprise.

Параметры

  • time_of_generation_minstringобязательный

    Start time for the analytics period (ISO8601 format, e.g., '2024-01-01T00:00:00Z')

  • time_of_generation_maxstringобязательный

    End time for the analytics period (ISO8601 format, e.g., '2024-02-01T00:00:00Z')

  • total_units_minnumber

    Minimum number of total tokens to filter by

  • total_units_maxnumber

    Maximum number of total tokens to filter by

  • cost_minnumber

    Minimum cost in cents to filter by

  • cost_maxnumber

    Maximum cost in cents to filter by

  • prompt_token_minnumber

    Minimum number of prompt tokens

  • prompt_token_maxnumber

    Maximum number of prompt tokens

  • completion_token_minnumber

    Minimum number of completion tokens

  • completion_token_maxnumber

    Maximum number of completion tokens

  • status_codestring

    Legacy Portkey query param for HTTP status codes. Comma-separated string; prefer status_codes for structured inputs.

  • weighted_feedback_minnumber

    Minimum weighted feedback score (-10 to 10)

  • weighted_feedback_maxnumber

    Maximum weighted feedback score (-10 to 10)

  • virtual_keysstring

    Legacy Portkey query param for virtual key slugs. Comma-separated string; prefer virtual_key_slugs for structured inputs.

  • configsstring

    Legacy Portkey query param for config slugs. Comma-separated string; prefer config_slugs for structured inputs.

  • status_codesstring[]

    Structured alias for status_code. Use an array of HTTP status codes; normalized to the legacy comma-separated Portkey query param.

  • virtual_key_slugsstring[]

    Structured alias for virtual_keys. Use an array of virtual key slugs; normalized to the legacy comma-separated Portkey query param.

  • config_slugsstring[]

    Structured alias for configs. Use an array of config slugs; normalized to the legacy comma-separated Portkey query param.

  • workspace_slugstring

    Filter by specific workspace

  • api_key_idsstring

    Legacy Portkey query param for API key UUIDs. Comma-separated string; request_analytics also accepts an array and normalizes it to this form.

  • metadatastring

    Legacy Portkey query param for metadata filtering. Stringified JSON object, e.g. '{"env":"prod","app":"myapp"}'; prefer metadata_filter for structured inputs.

  • ai_org_modelstring

    Legacy Portkey query param for provider/model pairs. Format: 'provider__model' with double underscore, e.g. 'openai__gpt-4' or 'anthropic__claude-3-opus'. Comma-separated string; prefer provider_models for structured inputs.

  • provider_modelsstring[]

    Structured alias for ai_org_model. Use provider__model strings in an array; normalized to the legacy comma-separated Portkey query param.

  • trace_idstring

    Legacy Portkey query param for trace IDs. Comma-separated string; prefer trace_ids for structured inputs.

  • trace_idsstring[]

    Structured alias for trace_id. Use an array of trace IDs; normalized to the legacy comma-separated Portkey query param.

  • span_idstring

    Legacy Portkey query param for span IDs. Comma-separated string; prefer span_ids for structured inputs.

  • span_idsstring[]

    Structured alias for span_id. Use an array of span IDs; normalized to the legacy comma-separated Portkey query param.

  • metadata_filterobject

    Structured alias for metadata. Use an object such as { env: 'prod' }; normalized to a JSON string before the request is sent.

  • prompt_slugstring

    Filter by prompt slug

get_secret_referenceтолько чтениеидемпотентныйвнешний мир

Извлекает одну ссылку на секрет по UUID или slug. Portkey маскирует чувствительные поля аутентификации для несистемных пользователей; инструмент возвращает метаданные и замаскированную конфигурацию аутентификации, а не разрешённое значение внешнего секрета.

Извлекает одну ссылку на секрет по UUID или slug. Portkey маскирует чувствительные поля аутентификации для несистемных пользователей; инструмент возвращает метаданные и замаскированную конфигурацию аутентификации, а не разрешённое значение внешнего секрета.

Параметры

  • idstringобязательный

    Secret Reference UUID or slug

get_token_analyticsтолько чтениеидемпотентныйвнешний мир

Получает данные временного ряда использования токенов с summary.total_tokens, summary.prompt_tokens, summary.completion_tokens и количеством total/prompt/completion в каждом сегменте. Используйте это для трендов потребления; используйте get_cost_analytics, когда нужны затраты вместо объёма токенов. Enterprise-gated. Возвращает 403 на не-Enterprise планах Portkey.

Получает данные временного ряда использования токенов с summary.total_tokens, summary.prompt_tokens, summary.completion_tokens и количеством total/prompt/completion в каждом сегменте. Используйте это для трендов потребления; используйте get_cost_analytics, когда нужны затраты вместо объёма токенов. Enterprise-gated. Возвращает 403 на не-Enterprise планах Portkey.

Параметры

  • time_of_generation_minstringобязательный

    Start time for the analytics period (ISO8601 format, e.g., '2024-01-01T00:00:00Z')

  • time_of_generation_maxstringобязательный

    End time for the analytics period (ISO8601 format, e.g., '2024-02-01T00:00:00Z')

  • total_units_minnumber

    Minimum number of total tokens to filter by

  • total_units_maxnumber

    Maximum number of total tokens to filter by

  • cost_minnumber

    Minimum cost in cents to filter by

  • cost_maxnumber

    Maximum cost in cents to filter by

  • prompt_token_minnumber

    Minimum number of prompt tokens

  • prompt_token_maxnumber

    Maximum number of prompt tokens

  • completion_token_minnumber

    Minimum number of completion tokens

  • completion_token_maxnumber

    Maximum number of completion tokens

  • status_codestring

    Legacy Portkey query param for HTTP status codes. Comma-separated string; prefer status_codes for structured inputs.

  • weighted_feedback_minnumber

    Minimum weighted feedback score (-10 to 10)

  • weighted_feedback_maxnumber

    Maximum weighted feedback score (-10 to 10)

  • virtual_keysstring

    Legacy Portkey query param for virtual key slugs. Comma-separated string; prefer virtual_key_slugs for structured inputs.

  • configsstring

    Legacy Portkey query param for config slugs. Comma-separated string; prefer config_slugs for structured inputs.

  • status_codesstring[]

    Structured alias for status_code. Use an array of HTTP status codes; normalized to the legacy comma-separated Portkey query param.

  • virtual_key_slugsstring[]

    Structured alias for virtual_keys. Use an array of virtual key slugs; normalized to the legacy comma-separated Portkey query param.

  • config_slugsstring[]

    Structured alias for configs. Use an array of config slugs; normalized to the legacy comma-separated Portkey query param.

  • workspace_slugstring

    Filter by specific workspace

  • api_key_idsstring

    Legacy Portkey query param for API key UUIDs. Comma-separated string; request_analytics also accepts an array and normalizes it to this form.

  • metadatastring

    Legacy Portkey query param for metadata filtering. Stringified JSON object, e.g. '{"env":"prod","app":"myapp"}'; prefer metadata_filter for structured inputs.

  • ai_org_modelstring

    Legacy Portkey query param for provider/model pairs. Format: 'provider__model' with double underscore, e.g. 'openai__gpt-4' or 'anthropic__claude-3-opus'. Comma-separated string; prefer provider_models for structured inputs.

  • provider_modelsstring[]

    Structured alias for ai_org_model. Use provider__model strings in an array; normalized to the legacy comma-separated Portkey query param.

  • trace_idstring

    Legacy Portkey query param for trace IDs. Comma-separated string; prefer trace_ids for structured inputs.

  • trace_idsstring[]

    Structured alias for trace_id. Use an array of trace IDs; normalized to the legacy comma-separated Portkey query param.

  • span_idstring

    Legacy Portkey query param for span IDs. Comma-separated string; prefer span_ids for structured inputs.

  • span_idsstring[]

    Structured alias for span_id. Use an array of span IDs; normalized to the legacy comma-separated Portkey query param.

  • metadata_filterobject

    Structured alias for metadata. Use an object such as { env: 'prod' }; normalized to a JSON string before the request is sent.

  • prompt_slugstring

    Filter by prompt slug

get_usage_limitтолько чтениеидемпотентныйвнешний мир

Получите один лимит использования по ID и верните его полный бюджет, порог, группировку и детали сброса. Сначала используйте list_usage_limits, чтобы узнать ID или сравнить политики.

Получите один лимит использования по ID и верните его полный бюджет, порог, группировку и детали сброса. Сначала используйте list_usage_limits, чтобы узнать ID или сравнить политики.

Параметры

  • idstringобязательный

    The unique identifier of the usage limit

get_userтолько чтениеидемпотентныйвнешний мир

Получает одного принятого пользователя по идентификатору и возвращает его профиль, роль и временные метки. Если у вас есть только имя или email, используйте list_all_users, чтобы найти идентификатор, а для ожидающих приглашений — get_user_invite. Только для Enterprise. Возвращает 403 на не-Enterprise тарифах Portkey.

Получает одного принятого пользователя по идентификатору и возвращает его профиль, роль и временные метки. Если у вас есть только имя или email, используйте list_all_users, чтобы найти идентификатор, а для ожидающих приглашений — get_user_invite. Только для Enterprise. Возвращает 403 на не-Enterprise тарифах Portkey.

Параметры

  • user_idstringобязательный

    The user ID to retrieve

get_user_inviteтолько чтениеидемпотентныйвнешний мир

Получить одно приглашение по invite id и вернуть его email, роль, статус и срок действия. Используйте это только для ожидающих приглашений; для принятых пользователей используйте get_user.

Получить одно приглашение по invite id и вернуть его email, роль, статус и срок действия. Используйте это только для ожидающих приглашений; для принятых пользователей используйте get_user.

Параметры

  • invite_idstringобязательный

    The invite ID to retrieve

get_user_requests_analyticsтолько чтениеидемпотентныйвнешний мир

Получает поканальные данные временных рядов с количеством запросов, сгруппированных по пользователям. Используйте, чтобы найти активных пользователей и концентрацию трафика; для совокупных трендов активных и новых пользователей используйте get_users_analytics. Только для Enterprise. Возвращает 403 на тарифах Portkey, не являющихся Enterprise.

Получает поканальные данные временных рядов с количеством запросов, сгруппированных по пользователям. Используйте, чтобы найти активных пользователей и концентрацию трафика; для совокупных трендов активных и новых пользователей используйте get_users_analytics. Только для Enterprise. Возвращает 403 на тарифах Portkey, не являющихся Enterprise.

Параметры

  • time_of_generation_minstringобязательный

    Start time for the analytics period (ISO8601 format, e.g., '2024-01-01T00:00:00Z')

  • time_of_generation_maxstringобязательный

    End time for the analytics period (ISO8601 format, e.g., '2024-02-01T00:00:00Z')

  • total_units_minnumber

    Minimum number of total tokens to filter by

  • total_units_maxnumber

    Maximum number of total tokens to filter by

  • cost_minnumber

    Minimum cost in cents to filter by

  • cost_maxnumber

    Maximum cost in cents to filter by

  • prompt_token_minnumber

    Minimum number of prompt tokens

  • prompt_token_maxnumber

    Maximum number of prompt tokens

  • completion_token_minnumber

    Minimum number of completion tokens

  • completion_token_maxnumber

    Maximum number of completion tokens

  • status_codestring

    Legacy Portkey query param for HTTP status codes. Comma-separated string; prefer status_codes for structured inputs.

  • weighted_feedback_minnumber

    Minimum weighted feedback score (-10 to 10)

  • weighted_feedback_maxnumber

    Maximum weighted feedback score (-10 to 10)

  • virtual_keysstring

    Legacy Portkey query param for virtual key slugs. Comma-separated string; prefer virtual_key_slugs for structured inputs.

  • configsstring

    Legacy Portkey query param for config slugs. Comma-separated string; prefer config_slugs for structured inputs.

  • status_codesstring[]

    Structured alias for status_code. Use an array of HTTP status codes; normalized to the legacy comma-separated Portkey query param.

  • virtual_key_slugsstring[]

    Structured alias for virtual_keys. Use an array of virtual key slugs; normalized to the legacy comma-separated Portkey query param.

  • config_slugsstring[]

    Structured alias for configs. Use an array of config slugs; normalized to the legacy comma-separated Portkey query param.

  • workspace_slugstring

    Filter by specific workspace

  • api_key_idsstring

    Legacy Portkey query param for API key UUIDs. Comma-separated string; request_analytics also accepts an array and normalizes it to this form.

  • metadatastring

    Legacy Portkey query param for metadata filtering. Stringified JSON object, e.g. '{"env":"prod","app":"myapp"}'; prefer metadata_filter for structured inputs.

  • ai_org_modelstring

    Legacy Portkey query param for provider/model pairs. Format: 'provider__model' with double underscore, e.g. 'openai__gpt-4' or 'anthropic__claude-3-opus'. Comma-separated string; prefer provider_models for structured inputs.

  • provider_modelsstring[]

    Structured alias for ai_org_model. Use provider__model strings in an array; normalized to the legacy comma-separated Portkey query param.

  • trace_idstring

    Legacy Portkey query param for trace IDs. Comma-separated string; prefer trace_ids for structured inputs.

  • trace_idsstring[]

    Structured alias for trace_id. Use an array of trace IDs; normalized to the legacy comma-separated Portkey query param.

  • span_idstring

    Legacy Portkey query param for span IDs. Comma-separated string; prefer span_ids for structured inputs.

  • span_idsstring[]

    Structured alias for span_id. Use an array of span IDs; normalized to the legacy comma-separated Portkey query param.

  • metadata_filterobject

    Structured alias for metadata. Use an object such as { env: 'prod' }; normalized to a JSON string before the request is sent.

  • prompt_slugstring

    Filter by prompt slug

get_users_analyticsтолько чтениеидемпотентныйвнешний мир

Получает временные ряды роста пользователей с summary.total_active_users, summary.total_new_users и количеством активных/новых пользователей по сегментам. Используйте это для отслеживания тенденций роста и внедрения; используйте get_user_requests_analytics для трафика на пользователя или get_analytics_group_users для стоимости и детализации токенов на пользователя. Функция доступна только в Enterprise. Возвращает 403 на планах Portkey, отличных от Enterprise.

Получает временные ряды роста пользователей с summary.total_active_users, summary.total_new_users и количеством активных/новых пользователей по сегментам. Используйте это для отслеживания тенденций роста и внедрения; используйте get_user_requests_analytics для трафика на пользователя или get_analytics_group_users для стоимости и детализации токенов на пользователя. Функция доступна только в Enterprise. Возвращает 403 на планах Portkey, отличных от Enterprise.

Параметры

  • time_of_generation_minstringобязательный

    Start time for the analytics period (ISO8601 format, e.g., '2024-01-01T00:00:00Z')

  • time_of_generation_maxstringобязательный

    End time for the analytics period (ISO8601 format, e.g., '2024-02-01T00:00:00Z')

  • total_units_minnumber

    Minimum number of total tokens to filter by

  • total_units_maxnumber

    Maximum number of total tokens to filter by

  • cost_minnumber

    Minimum cost in cents to filter by

  • cost_maxnumber

    Maximum cost in cents to filter by

  • prompt_token_minnumber

    Minimum number of prompt tokens

  • prompt_token_maxnumber

    Maximum number of prompt tokens

  • completion_token_minnumber

    Minimum number of completion tokens

  • completion_token_maxnumber

    Maximum number of completion tokens

  • status_codestring

    Legacy Portkey query param for HTTP status codes. Comma-separated string; prefer status_codes for structured inputs.

  • weighted_feedback_minnumber

    Minimum weighted feedback score (-10 to 10)

  • weighted_feedback_maxnumber

    Maximum weighted feedback score (-10 to 10)

  • virtual_keysstring

    Legacy Portkey query param for virtual key slugs. Comma-separated string; prefer virtual_key_slugs for structured inputs.

  • configsstring

    Legacy Portkey query param for config slugs. Comma-separated string; prefer config_slugs for structured inputs.

  • status_codesstring[]

    Structured alias for status_code. Use an array of HTTP status codes; normalized to the legacy comma-separated Portkey query param.

  • virtual_key_slugsstring[]

    Structured alias for virtual_keys. Use an array of virtual key slugs; normalized to the legacy comma-separated Portkey query param.

  • config_slugsstring[]

    Structured alias for configs. Use an array of config slugs; normalized to the legacy comma-separated Portkey query param.

  • workspace_slugstring

    Filter by specific workspace

  • api_key_idsstring

    Legacy Portkey query param for API key UUIDs. Comma-separated string; request_analytics also accepts an array and normalizes it to this form.

  • metadatastring

    Legacy Portkey query param for metadata filtering. Stringified JSON object, e.g. '{"env":"prod","app":"myapp"}'; prefer metadata_filter for structured inputs.

  • ai_org_modelstring

    Legacy Portkey query param for provider/model pairs. Format: 'provider__model' with double underscore, e.g. 'openai__gpt-4' or 'anthropic__claude-3-opus'. Comma-separated string; prefer provider_models for structured inputs.

  • provider_modelsstring[]

    Structured alias for ai_org_model. Use provider__model strings in an array; normalized to the legacy comma-separated Portkey query param.

  • trace_idstring

    Legacy Portkey query param for trace IDs. Comma-separated string; prefer trace_ids for structured inputs.

  • trace_idsstring[]

    Structured alias for trace_id. Use an array of trace IDs; normalized to the legacy comma-separated Portkey query param.

  • span_idstring

    Legacy Portkey query param for span IDs. Comma-separated string; prefer span_ids for structured inputs.

  • span_idsstring[]

    Structured alias for span_id. Use an array of span IDs; normalized to the legacy comma-separated Portkey query param.

  • metadata_filterobject

    Structured alias for metadata. Use an object such as { env: 'prod' }; normalized to a JSON string before the request is sent.

  • prompt_slugstring

    Filter by prompt slug

get_user_statsтолько чтениеидемпотентныйвнешний мир

Возвращает аналитику запросов и затрат на пользователя за указанный временной диапазон. Это использование по пользователям, а не популяционные метрики; используйте get_users_analytics для трендов активных пользователей или когорт. Enterprise-gated. Возвращает 403 на не-Enterprise планах Portkey.

Возвращает аналитику запросов и затрат на пользователя за указанный временной диапазон. Это использование по пользователям, а не популяционные метрики; используйте get_users_analytics для трендов активных пользователей или когорт. Enterprise-gated. Возвращает 403 на не-Enterprise планах Portkey.

Параметры

  • time_of_generation_minstringобязательный

    Start time for the analytics period (ISO8601 format, e.g., '2024-01-01T00:00:00Z')

  • time_of_generation_maxstringобязательный

    End time for the analytics period (ISO8601 format, e.g., '2024-02-01T00:00:00Z')

  • total_units_minnumber

    Minimum number of total tokens to filter by

  • total_units_maxnumber

    Maximum number of total tokens to filter by

  • cost_minnumber

    Minimum cost in cents to filter by

  • cost_maxnumber

    Maximum cost in cents to filter by

  • status_codestring

    Filter by specific HTTP status codes (comma-separated)

  • virtual_keysstring

    Filter by specific virtual key slugs (comma-separated)

  • page_sizeinteger

    Number of results per page (max 100)

get_virtual_keyтолько чтениеидемпотентныйвнешний мир

Получить один виртуальный ключ по slug, включая метаданные, маскированный секрет, лимиты, статус и конфигурацию модели. Используйте этот запрос перед обновлением или для проверки текущей конфигурации.

Получить один виртуальный ключ по slug, включая метаданные, маскированный секрет, лимиты, статус и конфигурацию модели. Используйте этот запрос перед обновлением или для проверки текущей конфигурации.

Параметры

  • slugstringобязательный

    The unique slug identifier of the virtual key to retrieve

get_workspaceтолько чтениеидемпотентныйвнешний мир

Получить одну рабочую область по ID и вернуть её полные детали, включая значения по умолчанию и полный список участников. Используйте это, когда нужны сведения об участниках; для общего обзора используйте list_workspaces.

Получить одну рабочую область по ID и вернуть её полные детали, включая значения по умолчанию и полный список участников. Используйте это, когда нужны сведения об участниках; для общего обзора используйте list_workspaces.

Параметры

  • workspace_idstringобязательный

    The unique identifier of the workspace to retrieve. This can be found in the workspace's URL or from the list_workspaces tool response

get_workspace_memberтолько чтениеидемпотентныйвнешний мир

Получает одного участника рабочего пространства по workspace_id и user_id. Используйте этот метод, когда вам уже известны оба ID; для просмотра полного списка участников используйте list_workspace_members.

Получает одного участника рабочего пространства по workspace_id и user_id. Используйте этот метод, когда вам уже известны оба ID; для просмотра полного списка участников используйте list_workspace_members.

Параметры

  • workspace_idstringобязательный

    The workspace ID

  • user_idstringобязательный

    The user ID to retrieve

insert_logвнешний мир

Добавляет записи логов для запросов, которые обошли шлюз. Это сразу записывает метаданные запроса, ответа и трейса в Portkey, и вызов завершится ошибкой, если request_provider не совпадает с настроенной интеграцией. Используйте поля спанов, чтобы связать иерархии трейсов.

Добавляет записи логов для запросов, которые обошли шлюз. Это сразу записывает метаданные запроса, ответа и трейса в Portkey, и вызов завершится ошибкой, если request_provider не совпадает с настроенной интеграцией. Используйте поля спанов, чтобы связать иерархии трейсов.

Параметры

  • request_urlstring

    The endpoint URL being called

  • request_providerstring

    AI provider name (e.g., 'openai', 'anthropic')

  • request_methodstring

    HTTP method used (defaults to 'post')

  • request_headersobject

    Request headers as key-value pairs

  • request_bodyobject

    Request payload/body

  • response_statusnumber

    HTTP response status code (defaults to 200)

  • response_headersobject

    Response headers as key-value pairs

  • response_bodyobject

    Response payload/body

  • response_timenumber

    Response latency in milliseconds

  • streaming_modeboolean

    Whether the response was streamed

  • metadata_organizationstring

    Organization identifier for the log

  • metadata_userstring

    User identifier for the log

  • metadata_trace_idstring

    Trace ID for distributed tracing

  • metadata_span_idstring

    Span ID for tracing

  • metadata_span_namestring

    Span name for tracing

  • metadata_parent_span_idstring

    Parent span ID for tracing

  • metadata_customobject

    Additional custom metadata key-value pairs

invite_userвнешний мир

Пригласите нового пользователя организации и опционально предоставьте доступ к рабочему пространству и API key одним вызовом. Назначения рабочего пространства вступают в силу только после принятия; используйте add_workspace_member или update_workspace_member позже для последующих изменений.

Пригласите нового пользователя организации и опционально предоставьте доступ к рабочему пространству и API key одним вызовом. Назначения рабочего пространства вступают в силу только после принятия; используйте add_workspace_member или update_workspace_member позже для последующих изменений.

Параметры

  • emailstringобязательный

    Email address of the user to invite

  • roleenumобязательный

    Organization-level role: 'admin' for full access, 'member' for limited access

    adminmember
  • first_namestring

    User's first name

  • last_namestring

    User's last name

  • workspacesobject[]обязательный

    List of workspaces and corresponding roles to grant to the user

  • workspace_api_key_detailsobject

    Optional API key to be created for the user

list_all_usersтолько чтениеидемпотентныйвнешний мир

Получить список принятых пользователей организации с id, именем, email, ролью и временными метками. Используйте это, чтобы найти user_id перед вызовом get_user, update_user, delete_user или add_workspace_member; для приглашений в статусе ожидания используйте list_user_invites. Доступно только для Enterprise. Возвращает 403 на не-Enterprise тарифах Portkey.

Получить список принятых пользователей организации с id, именем, email, ролью и временными метками. Используйте это, чтобы найти user_id перед вызовом get_user, update_user, delete_user или add_workspace_member; для приглашений в статусе ожидания используйте list_user_invites. Доступно только для Enterprise. Возвращает 403 на не-Enterprise тарифах Portkey.

Параметры

  • current_pageinteger

    Page number for pagination

  • page_sizeinteger

    Number of results per page (max 100)

list_api_keysтолько чтениеидемпотентныйвнешний мир

Выводит ключи API Portkey для аудита доступа, областей действия, значений по умолчанию, лимитов и срока действия. Используйте это только для API-ключей; для ключей провайдера используйте list_virtual_keys. Возвращает общее количество, а также id, тип, статус, область действия рабочей области/пользователя, лимиты, значения по умолчанию, адреса для оповещений и способ создания.

Выводит ключи API Portkey для аудита доступа, областей действия, значений по умолчанию, лимитов и срока действия. Используйте это только для API-ключей; для ключей провайдера используйте list_virtual_keys. Возвращает общее количество, а также id, тип, статус, область действия рабочей области/пользователя, лимиты, значения по умолчанию, адреса для оповещений и способ создания.

Параметры

  • page_sizeinteger

    Number of results per page (max 100)

  • current_pageinteger

    Page number for pagination

  • workspace_idstring

    Filter by workspace ID

list_audit_logsтолько чтениеидемпотентныйвнешний мир

Выводит список событий журнала аудита для рабочего пространства или организации Portkey. Возвращает постраничные записи на уровне действий с указанием исполнителя, ресурса, метаданных и временных меток для проверки соответствия или расследования инцидентов; используйте это вместо аналитики, когда нужны отдельные события, а не агрегаты. Доступно только в Enterprise. Возвращает 403 на планах Portkey, отличных от Enterprise.

Выводит список событий журнала аудита для рабочего пространства или организации Portkey. Возвращает постраничные записи на уровне действий с указанием исполнителя, ресурса, метаданных и временных меток для проверки соответствия или расследования инцидентов; используйте это вместо аналитики, когда нужны отдельные события, а не агрегаты. Доступно только в Enterprise. Возвращает 403 на планах Portkey, отличных от Enterprise.

Параметры

  • workspace_idstring

    Filter audit logs by workspace ID

  • actor_idstring

    Filter by the user ID who performed the action

  • actionstring

    Filter by action type (e.g., 'create', 'update', 'delete', 'login')

  • resource_typestring

    Filter by resource type (e.g., 'user', 'workspace', 'config', 'virtual_key')

  • resource_idstring

    Filter by specific resource ID

  • start_timestring

    Start of time range filter (ISO 8601 format, e.g., '2024-01-01T00:00:00Z')

  • end_timestring

    End of time range filter (ISO 8601 format, e.g., '2024-01-31T23:59:59Z')

  • current_pageinteger

    Page number for pagination (starts at 1)

  • page_sizeinteger

    Number of results per page (max 100)

list_collectionsтолько чтениеидемпотентныйвнешний мир

Выводит список коллекций промптов в рабочем пространстве, опционально фильтруя по имени или рабочему пространству. Возвращает идентификаторы, названия, slug и временные метки, чтобы вы могли выбрать collection_id перед вызовом create_prompt, get_collection или list_prompts.

Выводит список коллекций промптов в рабочем пространстве, опционально фильтруя по имени или рабочему пространству. Возвращает идентификаторы, названия, slug и временные метки, чтобы вы могли выбрать collection_id перед вызовом create_prompt, get_collection или list_prompts.

Параметры

  • workspace_idstring

    Filter by workspace ID

  • searchstring

    Search collections by name

  • current_pageinteger

    Page number for pagination

  • page_sizeinteger

    Results per page (max 100)

list_configsтолько чтениеидемпотентныйвнешний мир

Вывести список конфигов в организации с id, slug, name, status, workspace и временными метками. Используйте этот сводный вид, чтобы найти slug; используйте get_config для получения полных настроек маршрутизации, кэша, повторных попыток и целевых параметров перед обновлением или удалением.

Вывести список конфигов в организации с id, slug, name, status, workspace и временными метками. Используйте этот сводный вид, чтобы найти slug; используйте get_config для получения полных настроек маршрутизации, кэша, повторных попыток и целевых параметров перед обновлением или удалением.

Параметры

  • current_pageinteger

    Page number for pagination

  • page_sizeinteger

    Number of results per page (max 100)

list_config_versionsтолько чтениеидемпотентныйвнешний мир

Перечислите все версии конфига с номером версии, содержимым конфига, создателем и временной меткой. Используйте это для аудита истории или сравнения ревизий перед вызовом update_config или delete_config.

Перечислите все версии конфига с номером версии, содержимым конфига, создателем и временной меткой. Используйте это для аудита истории или сравнения ревизий перед вызовом update_config или delete_config.

Параметры

  • slugstringобязательный

    Configuration slug to list versions for

list_guardrailsтолько чтениеидемпотентныйвнешний мир

Выводит список guardrails в организации с id, slug, статусом, владельцем и необязательными фильтрами по рабочему пространству/организации. Используйте это, чтобы найти id и slug перед вызовом get_guardrail, update_guardrail или delete_guardrail.

Выводит список guardrails в организации с id, slug, статусом, владельцем и необязательными фильтрами по рабочему пространству/организации. Используйте это, чтобы найти id и slug перед вызовом get_guardrail, update_guardrail или delete_guardrail.

Параметры

  • workspace_idstring

    Filter guardrails by workspace ID

  • organisation_idstring

    Filter guardrails by organization ID

  • page_sizeinteger

    Number of items per page (1-100, default: 100)

  • current_pageinteger

    Page number for pagination

list_integration_modelsтолько чтениеидемпотентныйвнешний мир

Выводит список моделей, включённых для интеграции. Используйте это, чтобы проверить доступность модели перед созданием промптов или конфигураций. Возвращает общее количество, а также идентификаторы моделей, отображаемые имена, состояние включения и маркеры пользовательских моделей. Доступ ограничен Enterprise. Возвращает 403 для не-Enterprise тарифов Portkey.

Выводит список моделей, включённых для интеграции. Используйте это, чтобы проверить доступность модели перед созданием промптов или конфигураций. Возвращает общее количество, а также идентификаторы моделей, отображаемые имена, состояние включения и маркеры пользовательских моделей. Доступ ограничен Enterprise. Возвращает 403 для не-Enterprise тарифов Portkey.

Параметры

  • slugstringобязательный

    The slug of the integration

  • current_pageinteger

    Page number for pagination

  • page_sizeinteger

    Number of results per page

list_integrationsтолько чтениеидемпотентныйвнешний мир

Выводит список подключений к AI-провайдерам на уровне организации с опциональными фильтрами по рабочему пространству или типу. Используйте это, чтобы найти слаги интеграций перед обновлениями модели или рабочего пространства. Возвращает общее количество, а также id, name, slug, provider, status, description, workspace counts и config summary.

Выводит список подключений к AI-провайдерам на уровне организации с опциональными фильтрами по рабочему пространству или типу. Используйте это, чтобы найти слаги интеграций перед обновлениями модели или рабочего пространства. Возвращает общее количество, а также id, name, slug, provider, status, description, workspace counts и config summary.

Параметры

  • current_pageinteger

    Page number for pagination

  • page_sizeinteger

    Number of results per page (default 100, max 100)

  • workspace_idstring

    Filter integrations accessible by a specific workspace

  • typeenum

    Filter by integration type: 'workspace', 'organisation', or 'all' (default)

    workspaceorganisationall
list_integration_workspacesтолько чтениеидемпотентныйвнешний мир

Выводит список рабочих пространств, которые могут использовать интеграцию, с их лимитами. Используйте для аудита доступа или проверки настроек стоимости и лимитов для каждого рабочего пространства. Возвращает общее количество, а также идентификаторы рабочих пространств, названия, состояние включения, лимиты использования и ограничения скорости. Доступно только на корпоративном тарифе. Возвращает 403 на не-Enterprise планах Portkey.

Выводит список рабочих пространств, которые могут использовать интеграцию, с их лимитами. Используйте для аудита доступа или проверки настроек стоимости и лимитов для каждого рабочего пространства. Возвращает общее количество, а также идентификаторы рабочих пространств, названия, состояние включения, лимиты использования и ограничения скорости. Доступно только на корпоративном тарифе. Возвращает 403 на не-Enterprise планах Portkey.

Параметры

  • slugstringобязательный

    The slug of the integration

  • current_pageinteger

    Page number for pagination

  • page_sizeinteger

    Number of results per page

list_log_exportsтолько чтениеидемпотентныйвнешний мир

Выводит список заданий на экспорт логов в рабочей области со статусом, фильтрами и временными метками. Используйте это, чтобы найти export_id перед вызовом get_log_export, start_log_export, cancel_log_export или download_log_export.

Выводит список заданий на экспорт логов в рабочей области со статусом, фильтрами и временными метками. Используйте это, чтобы найти export_id перед вызовом get_log_export, start_log_export, cancel_log_export или download_log_export.

Параметры

  • workspace_idstringобязательный

    Workspace ID to list exports for (required)

list_mcp_integration_capabilitiesтолько чтениеидемпотентныйвнешний мир

Выводит список возможностей, которые предоставляет внешний MCP-сервер для интеграции. Возвращает общее количество записей и их состояние (включено/выключено), чтобы вы могли решить, что переключать; используйте перед update_mcp_integration_capabilities, когда нужно сравнить текущее состояние.

Выводит список возможностей, которые предоставляет внешний MCP-сервер для интеграции. Возвращает общее количество записей и их состояние (включено/выключено), чтобы вы могли решить, что переключать; используйте перед update_mcp_integration_capabilities, когда нужно сравнить текущее состояние.

Параметры

  • idstringобязательный

    The MCP integration ID or slug

list_mcp_integrationsтолько чтениеидемпотентныйвнешний мир

Выводит список MCP интеграций в организации. Возвращает постраничные записи интеграций, а также total и has_more для обнаружения ID интеграций; используйте get_mcp_integration для получения полной конфигурации одной интеграции на стороне Portkey и list_mcp_servers для серверов внутри интеграции.

Выводит список MCP интеграций в организации. Возвращает постраничные записи интеграций, а также total и has_more для обнаружения ID интеграций; используйте get_mcp_integration для получения полной конфигурации одной интеграции на стороне Portkey и list_mcp_servers для серверов внутри интеграции.

Параметры

  • current_pageinteger

    Page number for pagination

  • page_sizeinteger

    Number of results per page (max 100)

  • workspace_idstring

    Filter by workspace ID

list_mcp_integration_workspacesтолько чтениеидемпотентныйвнешний мир

Список, какие рабочие пространства могут получить доступ к интеграции MCP. Возвращает глобальный режим доступа и настройки включения для каждого рабочего пространства — для аудита или проверки разрешений; используйте перед update_mcp_integration_workspaces.

Список, какие рабочие пространства могут получить доступ к интеграции MCP. Возвращает глобальный режим доступа и настройки включения для каждого рабочего пространства — для аудита или проверки разрешений; используйте перед update_mcp_integration_workspaces.

Параметры

  • idstringобязательный

    The MCP integration ID or slug

list_mcp_server_capabilitiesтолько чтениеидемпотентныйвнешний мир

Перечисляет возможности, предоставляемые экземпляром MCP-сервера. Возвращает общее количество, а также текущие инструменты, ресурсы и поверхность промптов; используйте это вместо списка возможностей на уровне интеграции, когда вам нужно отображение, специфичное для сервера.

Перечисляет возможности, предоставляемые экземпляром MCP-сервера. Возвращает общее количество, а также текущие инструменты, ресурсы и поверхность промптов; используйте это вместо списка возможностей на уровне интеграции, когда вам нужно отображение, специфичное для сервера.

Параметры

  • idstringобязательный

    The MCP server ID or slug

  • current_pageinteger

    Page number for pagination

  • page_sizeinteger

    Number of results per page (max 100)

list_mcp_serversтолько чтениеидемпотентныйвнешний мир

Список MCP-серверов в организации. Возвращает записи серверов с постраничной разбивкой и общее количество для поиска идентификаторов серверов; используйте get_mcp_server для получения деталей одного сервера и list_mcp_integrations для родительской интеграции.

Список MCP-серверов в организации. Возвращает записи серверов с постраничной разбивкой и общее количество для поиска идентификаторов серверов; используйте get_mcp_server для получения деталей одного сервера и list_mcp_integrations для родительской интеграции.

Параметры

  • current_pageinteger

    Page number for pagination

  • page_sizeinteger

    Number of results per page (max 100)

  • workspace_idstring

    Filter by workspace ID

list_mcp_server_user_accessтолько чтениеидемпотентныйвнешний мир

Выводит доступ для каждого пользователя MCP-сервера. Возвращает режим доступа по умолчанию, флаги переопределения и статус подключения, чтобы вы могли проверить, кто может его использовать; используйте перед update_mcp_server_user_access.

Выводит доступ для каждого пользователя MCP-сервера. Возвращает режим доступа по умолчанию, флаги переопределения и статус подключения, чтобы вы могли проверить, кто может его использовать; используйте перед update_mcp_server_user_access.

Параметры

  • idstringобязательный

    The MCP server ID or slug

  • current_pageinteger

    Page number for pagination

  • page_sizeinteger

    Number of results per page (max 100)

list_partial_versionsтолько чтениеидемпотентныйвнешний мир

Выводит все версии для одного партиала, включая номера версий, описания, статус и временные метки. Используйте это, когда нужна история или нужно выбрать version_id перед publish_partial.

Выводит все версии для одного партиала, включая номера версий, описания, статус и временные метки. Используйте это, когда нужна история или нужно выбрать version_id перед publish_partial.

Параметры

  • prompt_partial_idstringобязательный

    Prompt partial ID or slug to list versions for

list_prompt_labelsтолько чтениеидемпотентныйвнешний мир

Перечисляет метки в рабочем пространстве или организации, с опциональными фильтрами поиска и области действия. Возвращает идентификаторы, названия, цвета, статус и временные метки, чтобы вы могли выбрать label_id перед get_prompt_label или update_prompt_version.

Перечисляет метки в рабочем пространстве или организации, с опциональными фильтрами поиска и области действия. Возвращает идентификаторы, названия, цвета, статус и временные метки, чтобы вы могли выбрать label_id перед get_prompt_label или update_prompt_version.

Параметры

  • organisation_idstring

    Filter by organisation ID

  • workspace_idstring

    Filter by workspace ID

  • searchstring

    Search labels by name

  • current_pageinteger

    Page number for pagination

  • page_sizeinteger

    Results per page (max 100)

list_prompt_partialsтолько чтениеидемпотентныйвнешний мир

Выводит список partials по всем коллекциям, с опциональной фильтрацией по коллекции. Возвращает идентификаторы, slugs, названия, коллекции и статус, чтобы вы могли выбрать prompt_partial_id перед вызовом get_prompt_partial, update_prompt_partial, delete_prompt_partial или publish_partial.

Выводит список partials по всем коллекциям, с опциональной фильтрацией по коллекции. Возвращает идентификаторы, slugs, названия, коллекции и статус, чтобы вы могли выбрать prompt_partial_id перед вызовом get_prompt_partial, update_prompt_partial, delete_prompt_partial или publish_partial.

Параметры

  • collection_idstring

    Filter by collection ID. Optional — omit to list all partials across collections

list_promptsтолько чтениеидемпотентныйвнешний мир

Выводит список промптов в рамках рабочего пространства с необязательными фильтрами по коллекции, рабочему пространству или поиску. Возвращает постраничную сводку с id, name, slug, model и status, чтобы вы могли выбрать prompt_id перед get_prompt, update_prompt или render_prompt.

Выводит список промптов в рамках рабочего пространства с необязательными фильтрами по коллекции, рабочему пространству или поиску. Возвращает постраничную сводку с id, name, slug, model и status, чтобы вы могли выбрать prompt_id перед get_prompt, update_prompt или render_prompt.

Параметры

  • collection_idstring

    Filter by collection ID (recommended for app-specific prompts)

  • workspace_idstring

    Filter by workspace ID

  • searchstring

    Search prompts by name

  • current_pageinteger

    Page number for pagination

  • page_sizeinteger

    Results per page (max 100)

list_prompt_versionsтолько чтениеидемпотентныйвнешний мир

Выводит все версии одного промпта: номер версии, описание, статус, метку и краткий предпросмотр шаблона. Используй для просмотра истории или выбора version_id перед вызовом publish_prompt или update_prompt_version.

Выводит все версии одного промпта: номер версии, описание, статус, метку и краткий предпросмотр шаблона. Используй для просмотра истории или выбора version_id перед вызовом publish_prompt или update_prompt_version.

Параметры

  • prompt_idstringобязательный

    Prompt ID or slug to list versions for

list_providersтолько чтениеидемпотентныйвнешний мир

Выводит экземпляры провайдеров в рамках рабочей области и их лимиты или статус. Используйте это, чтобы найти слаги провайдеров для обновлений на уровне рабочей области; для подключения источника на уровне организации используйте list_integrations. Возвращает общее количество, а также имя провайдера, слаг, интеграцию, статус, лимиты, срок действия и флаги сброса.

Выводит экземпляры провайдеров в рамках рабочей области и их лимиты или статус. Используйте это, чтобы найти слаги провайдеров для обновлений на уровне рабочей области; для подключения источника на уровне организации используйте list_integrations. Возвращает общее количество, а также имя провайдера, слаг, интеграцию, статус, лимиты, срок действия и флаги сброса.

Параметры

  • current_pageinteger

    Page number for pagination

  • page_sizeinteger

    Number of results per page (max 100, default 50)

  • workspace_idstring

    Workspace ID - required when using organization admin keys, optional with workspace API keys

list_rate_limitsтолько чтениеидемпотентныйвнешний мир

Выведите список ограничений скорости в организации с id, type, unit, value, status, scope, conditions и grouping. Используйте это, чтобы найти существующую политику перед вызовом get_rate_limit, update_rate_limit или delete_rate_limit.

Выведите список ограничений скорости в организации с id, type, unit, value, status, scope, conditions и grouping. Используйте это, чтобы найти существующую политику перед вызовом get_rate_limit, update_rate_limit или delete_rate_limit.

Параметры

  • workspace_idstring

    Filter rate limits by workspace ID

list_secret_referencesтолько чтениеидемпотентныйвнешний мир

Выводит список ссылок на секреты без возврата конфигурации аутентификации или раскрытых значений секретов. Фильтруйте по типу менеджера, тегам или имени и используйте полученный UUID или slug с get_secret_reference.

Выводит список ссылок на секреты без возврата конфигурации аутентификации или раскрытых значений секретов. Фильтруйте по типу менеджера, тегам или имени и используйте полученный UUID или slug с get_secret_reference.

Параметры

  • manager_typeenum

    Filter by external secret manager: aws_sm, azure_kv, or hashicorp_vault

    aws_smazure_kvhashicorp_vault
  • tagsobject

    Return references matching these tags

  • searchstring

    Search references by name

  • current_pageinteger

    Zero-based page number; defaults to 0

  • page_sizeinteger

    References per page, from 1 to 100; defaults to 20

list_usage_limit_entitiesтолько чтениеидемпотентныйвнешний мир

Выводит список сущностей, которые отслеживаются с учётом лимита использования, включая текущее использование. Используйте это, чтобы узнать, кто близок к бюджету или превысил его, перед вызовом reset_usage_limit_entity или delete_usage_limit.

Выводит список сущностей, которые отслеживаются с учётом лимита использования, включая текущее использование. Используйте это, чтобы узнать, кто близок к бюджету или превысил его, перед вызовом reset_usage_limit_entity или delete_usage_limit.

Параметры

  • limit_idstringобязательный

    Usage limit policy ID

list_usage_limitsтолько чтениеидемпотентныйвнешний мир

Выведи лимиты использования в организации с полями id, type, credit_limit, status, reset schedule, scope, conditions и grouping. Используй это перед вызовом get_usage_limit, update_usage_limit или delete_usage_limit.

Выведи лимиты использования в организации с полями id, type, credit_limit, status, reset schedule, scope, conditions и grouping. Используй это перед вызовом get_usage_limit, update_usage_limit или delete_usage_limit.

Параметры

  • workspace_idstring

    Filter usage limits by workspace ID

list_user_invitesтолько чтениеидемпотентныйвнешний мир

Выводит список ожидающих и отправленных приглашений с id, email, ролью, статусом и сроком действия. Используйте этот метод для проверки статуса приглашения, а list_all_users — для пользователей, которые уже приняли приглашение. Доступно только в Enterprise. Возвращает 403 на планах Portkey, отличных от Enterprise.

Выводит список ожидающих и отправленных приглашений с id, email, ролью, статусом и сроком действия. Используйте этот метод для проверки статуса приглашения, а list_all_users — для пользователей, которые уже приняли приглашение. Доступно только в Enterprise. Возвращает 403 на планах Portkey, отличных от Enterprise.

Параметры

  • current_pageinteger

    Page number for pagination

  • page_sizeinteger

    Number of results per page (max 100)

list_virtual_keysтолько чтениеидемпотентныйвнешний мир

Выводит список ключей API провайдеров, хранящихся как виртуальные ключи в вашей организации Portkey. Используйте это для поиска слагов перед настройкой prompts/configs или аудитом лимитов. Возвращает общее количество, а также имя, слаг, статус, лимиты использования, лимиты скорости, состояние сброса и конфигурацию модели.

Выводит список ключей API провайдеров, хранящихся как виртуальные ключи в вашей организации Portkey. Используйте это для поиска слагов перед настройкой prompts/configs или аудитом лимитов. Возвращает общее количество, а также имя, слаг, статус, лимиты использования, лимиты скорости, состояние сброса и конфигурацию модели.

Параметры

  • current_pageinteger

    Page number for pagination

  • page_sizeinteger

    Number of results per page (max 100)

list_workspace_membersтолько чтениеидемпотентныйвнешний мир

Выведите список всех участников рабочего пространства с указанием роли в организации, роли в рабочем пространстве, статуса и временных меток. Используйте это, чтобы найти user_id перед вызовом get_workspace_member, update_workspace_member или remove_workspace_member.

Выведите список всех участников рабочего пространства с указанием роли в организации, роли в рабочем пространстве, статуса и временных меток. Используйте это, чтобы найти user_id перед вызовом get_workspace_member, update_workspace_member или remove_workspace_member.

Параметры

  • workspace_idstringобязательный

    The workspace ID to list members for

list_workspacesтолько чтениеидемпотентныйвнешний мир

Выводит список рабочих пространств с id, name, slug, настройками по умолчанию и временными метками. Используйте это, чтобы найти workspace_id перед вызовом get_workspace, update_workspace, add_workspace_member или remove_workspace_member.

Выводит список рабочих пространств с id, name, slug, настройками по умолчанию и временными метками. Используйте это, чтобы найти workspace_id перед вызовом get_workspace, update_workspace, add_workspace_member или remove_workspace_member.

Параметры

  • page_sizeinteger

    Number of workspaces to return per page (max 100)

  • current_pageinteger

    Page number to retrieve when results are paginated

migrate_promptидемпотентный

Создаёт или обновляет промпт одним идемпотентным шагом для CI/CD и подхода «промпт как код» — в отличие от create_prompt, который всегда создаёт новый промпт. Ищет промпт по имени внутри collection_id: если его нет — создаёт, если найден с другим содержимым — добавляет новую версию (ничего не перезаписывается), а если содержимое уже совпадает — ничего не делает; dry_run сообщает, что бы произошло, но ничего не меняет. Сохраняет app/env в template_metadata; collection_id получает из list_collections. Возвращает выполненное действие (created, updated или unchanged), флаг dry_run, сообщение, id промпта, slug и id версии.

Создаёт или обновляет промпт одним идемпотентным шагом для CI/CD и подхода «промпт как код» — в отличие от create_prompt, который всегда создаёт новый промпт. Ищет промпт по имени внутри collection_id: если его нет — создаёт, если найден с другим содержимым — добавляет новую версию (ничего не перезаписывается), а если содержимое уже совпадает — ничего не делает; dry_run сообщает, что бы произошло, но ничего не меняет. Сохраняет app/env в template_metadata; collection_id получает из list_collections. Возвращает выполненное действие (created, updated или unchanged), флаг dry_run, сообщение, id промпта, slug и id версии.

Параметры

  • namestringобязательный

    Prompt name to create or find for update

  • appstringобязательный

    App identifier (REQUIRED). Use your deployed app name, for example 'hourlink' or 'support-console'.

  • envstringобязательный

    Environment identifier (REQUIRED). Use your environment name, for example 'dev', 'staging', 'prod', or 'qa'.

  • collection_idstringобязательный

    Collection ID to search in and create under

  • stringstring

    Legacy prompt template string with {{variable}} mustache syntax.

  • messagesobject[]

    Structured chat template alias for migrations. Serialized to the legacy string format before the prompt is created or updated.

  • parametersobjectобязательный

    Default values for template variables

  • virtual_keystringобязательный

    Virtual key slug for model access

  • modelstring

    Model identifier

  • version_descriptionstring

    Description for this version

  • template_metadataobject

    Additional custom metadata

  • functionsobject[]

    Function definitions

  • toolsobject[]

    Tool definitions

  • tool_choiceobject

    Tool choice strategy

  • dry_runboolean

    When true, only check what action would be taken without making changes

promote_promptвнешний мир

Копирует промпт из одного окружения в другое и автоматически создаёт или обновляет целевой. Используйте это для поэтапных релизов, когда нужно синхронизировать целевой промпт без ручных правок, и он возвращает идентификаторы версий исходного и целевого промптов.

Копирует промпт из одного окружения в другое и автоматически создаёт или обновляет целевой. Используйте это для поэтапных релизов, когда нужно синхронизировать целевой промпт без ручных правок, и он возвращает идентификаторы версий исходного и целевого промптов.

Параметры

  • source_prompt_idstringобязательный

    Source prompt ID or slug (e.g., staging prompt)

  • target_collection_idstringобязательный

    Target collection ID for the promoted prompt

  • target_namestring

    Target prompt name (defaults to source name with env suffix replaced)

  • target_envstringобязательный

    Environment identifier (REQUIRED). Use your environment name, for example 'dev', 'staging', 'prod', or 'qa'.

  • virtual_keystring

    Virtual key ID to use (defaults to source prompt's virtual_key)

publish_partialвнешний мир

Опубликуйте конкретную частичную версию как версию по умолчанию, в отличие от update_prompt_partial, который создаёт новый черновик без его активации. Используйте после list_partial_versions, чтобы выбрать version_id — это немедленно меняет то, на что ссылается {{> partial_name}} для всех промптов, и заменяет ранее активную версию без возможности отката.

Опубликуйте конкретную частичную версию как версию по умолчанию, в отличие от update_prompt_partial, который создаёт новый черновик без его активации. Используйте после list_partial_versions, чтобы выбрать version_id — это немедленно меняет то, на что ссылается {{> partial_name}} для всех промптов, и заменяет ранее активную версию без возможности отката.

Параметры

  • prompt_partial_idstringобязательный

    Prompt partial ID or slug

  • versionnumberобязательный

    Version number to publish as default

publish_promptвнешний мир

Опубликовать конкретную версию промпта как активную по умолчанию, в отличие от promote_prompt (которая копирует между средами) или update_prompt (которая создает новый черновик). Это немедленно перенаправляет всех вызывающих, использующих slug, на эту версию, и отката нет — поэтому сначала используйте list_prompt_versions, чтобы выбрать версию, и update_prompt, если нужно создать новый контент перед публикацией.

Опубликовать конкретную версию промпта как активную по умолчанию, в отличие от promote_prompt (которая копирует между средами) или update_prompt (которая создает новый черновик). Это немедленно перенаправляет всех вызывающих, использующих slug, на эту версию, и отката нет — поэтому сначала используйте list_prompt_versions, чтобы выбрать версию, и update_prompt, если нужно создать новый контент перед публикацией.

Параметры

  • prompt_idstringобязательный

    Prompt ID or slug to publish

  • versionnumberобязательный

    Version number to publish as the default

remove_workspace_memberвнешний мир

Удаляет пользователя из рабочего пространства и отзывает доступ к рабочему пространству. Это не удаляет пользователя из организации; используйте delete_user для полного удаления.

Удаляет пользователя из рабочего пространства и отзывает доступ к рабочему пространству. Это не удаляет пользователя из организации; используйте delete_user для полного удаления.

Параметры

  • workspace_idstringобязательный

    The workspace ID

  • user_idstringобязательный

    The user ID to remove

render_promptтолько чтениеидемпотентныйвнешний мир

Сформируйте промпт, подставив переменные, и верните итоговые сообщения, не вызывая модель. Используйте это для проверки вывода шаблона перед завершением; run_prompt_completion — это инструмент, который на самом деле вызывает модель.

Сформируйте промпт, подставив переменные, и верните итоговые сообщения, не вызывая модель. Используйте это для проверки вывода шаблона перед завершением; run_prompt_completion — это инструмент, который на самом деле вызывает модель.

Параметры

  • prompt_idstringобязательный

    Prompt ID or slug to render

  • variablesobjectобязательный

    Variable values to substitute into the template

  • hyperparametersobject

    Override default hyperparameters

resend_user_inviteвнешний мир

Отправляет повторно письмо для ожидающего приглашения, которое ещё не принято, в отличие от invite_user, который создаёт новое приглашение. Это отправляет новое письмо без изменения записи приглашения, срока действия или роли; сначала используйте get_user_invite, если вы не уверены, что приглашение ещё существует, и list_user_invites, чтобы узнать invite_ids.

Отправляет повторно письмо для ожидающего приглашения, которое ещё не принято, в отличие от invite_user, который создаёт новое приглашение. Это отправляет новое письмо без изменения записи приглашения, срока действия или роли; сначала используйте get_user_invite, если вы не уверены, что приглашение ещё существует, и list_user_invites, чтобы узнать invite_ids.

Параметры

  • invite_idstringобязательный

    The invite ID to resend

reset_usage_limit_entityвнешний мир

Сбросьте учтённое использование для одной сущности в рамках лимита использования. Это изменяет накопленное использование только для этой сущности; сначала используйте list_usage_limit_entities, чтобы подтвердить цель.

Сбросьте учтённое использование для одной сущности в рамках лимита использования. Это изменяет накопленное использование только для этой сущности; сначала используйте list_usage_limit_entities, чтобы подтвердить цель.

Параметры

  • limit_idstringобязательный

    Usage limit policy ID

  • entity_idstringобязательный

    Entity ID to reset usage for

rotate_api_keyвнешний мир

Выполните ротацию ключа API без изменения его идентификатора или областей действия. Новый секрет возвращается один раз и раскрывается в этом транскрипте MCP, при этом предыдущий секрет остается действительным до key_transition_expires_at. Сохраните новый ключ безопасно, обновите вызывающие стороны в течение окна перехода и никогда не логируйте ни один из секретов.

Выполните ротацию ключа API без изменения его идентификатора или областей действия. Новый секрет возвращается один раз и раскрывается в этом транскрипте MCP, при этом предыдущий секрет остается действительным до key_transition_expires_at. Сохраните новый ключ безопасно, обновите вызывающие стороны в течение окна перехода и никогда не логируйте ни один из секретов.

Параметры

  • idstringобязательный

    API key UUID obtained from list_api_keys

  • key_transition_period_msinteger

    Overlap in milliseconds while the previous key remains valid; minimum 1,800,000 (30 minutes), for example 3,600,000 for 1 hour

run_prompt_completionвнешний мир

Выполняет запрос к настроенной модели и возвращает результат. Это платный вызов модели, поэтому сначала используйте render_prompt, если нужно проверить шаблон, и validate_completion_metadata, когда поля оплаты неопределены.

Выполняет запрос к настроенной модели и возвращает результат. Это платный вызов модели, поэтому сначала используйте render_prompt, если нужно проверить шаблон, и validate_completion_metadata, когда поля оплаты неопределены.

Параметры

  • prompt_idstringобязательный

    Prompt ID or slug to execute

  • variablesobjectобязательный

    Variable values to substitute into the template

  • metadataobjectобязательный

    Billing metadata - client_id, app, env are REQUIRED for cost attribution

  • hyperparametersobject

    Override default hyperparameters

start_log_exportвнешний мир

Запускает обработку ранее созданного задания экспорта логов. Это асинхронная операция — она только ставит экспорт в очередь и не возвращает строки или файл для скачивания. Используйте get_log_export для отслеживания прогресса и download_log_export после завершения задания.

Запускает обработку ранее созданного задания экспорта логов. Это асинхронная операция — она только ставит экспорт в очередь и не возвращает строки или файл для скачивания. Используйте get_log_export для отслеживания прогресса и download_log_export после завершения задания.

Параметры

  • export_idstringобязательный

    The unique ID of the log export to start

test_mcp_serverвнешний мир

Проверяет соединение с MCP-сервером. Отправляет живую проверку и возвращает успех, время ответа, HTTP-статус и любую ошибку. Используйте это перед изменением конфигурации или при диагностике доступности.

Проверяет соединение с MCP-сервером. Отправляет живую проверку и возвращает успех, время ответа, HTTP-статус и любую ошибку. Используйте это перед изменением конфигурации или при диагностике доступности.

Параметры

  • idstringобязательный

    The MCP server ID or slug to test

update_api_keyвнешний мир

Обновляет имя, описание, области видимости, значения по умолчанию или лимиты ключа API, в отличие от delete_api_key, который отзывает его, или create_api_key, который выпускает новый. Изменения вступают в силу немедленно для нижестоящих вызывающих сторон, тип и подтип остаются фиксированными после создания, а вызов возвращает успех без ротации секрета.

Обновляет имя, описание, области видимости, значения по умолчанию или лимиты ключа API, в отличие от delete_api_key, который отзывает его, или create_api_key, который выпускает новый. Изменения вступают в силу немедленно для нижестоящих вызывающих сторон, тип и подтип остаются фиксированными после создания, а вызов возвращает успех без ротации секрета.

Параметры

  • idstringобязательный

    The UUID of the API key to update

  • namestring

    New display name for the key

  • descriptionstring

    New description for the key

  • scopesstring[]

    New permission scopes for the key

  • credit_limitnumber

    New credit limit for usage

  • alert_thresholdnumber

    New alert threshold percentage (0-100)

  • rate_limit_rpmnumber

    New rate limit in requests per minute

  • default_config_idstring

    New default configuration ID

  • default_metadataobject

    New default metadata key-value pairs

  • alert_emailsstring[]

    New email addresses for alerts

  • expires_atany

    New expiration date in ISO 8601 format, or null to remove expiration

update_collectionвнешний мир

Обновляйте только название или описание коллекции. Это не перемещает промпты и не меняет состав участников, поэтому используйте операцию для изменения метаданных, а не для реорганизации.

Обновляйте только название или описание коллекции. Это не перемещает промпты и не меняет состав участников, поэтому используйте операцию для изменения метаданных, а не для реорганизации.

Параметры

  • collection_idstringобязательный

    Collection ID to update

  • namestring

    New name for the collection

  • descriptionstring

    New description for the collection

update_config

Обновляет конфиг по slug; каждый вызов создаёт новую версию конфига, а не перезаписывает: ранние версии остаются доступными через list_config_versions. Меняются только переданные поля: name, status и все настройки маршрутизации, кеширования и повторных попыток (cache_mode, cache_max_age, retry_attempts, retry_on_status_codes, strategy_mode, targets) редактируются, slug остаётся фиксированным. Изменения применяются немедленно ко всем API-ключам и промптам, ссылающимся на конфиг; получите slug из list_configs и просмотрите текущие настройки с помощью get_config перед редактированием. Возвращает config id, slug и обновлённый payload конфига.

Обновляет конфиг по slug; каждый вызов создаёт новую версию конфига, а не перезаписывает: ранние версии остаются доступными через list_config_versions. Меняются только переданные поля: name, status и все настройки маршрутизации, кеширования и повторных попыток (cache_mode, cache_max_age, retry_attempts, retry_on_status_codes, strategy_mode, targets) редактируются, slug остаётся фиксированным. Изменения применяются немедленно ко всем API-ключам и промптам, ссылающимся на конфиг; получите slug из list_configs и просмотрите текущие настройки с помощью get_config перед редактированием. Возвращает config id, slug и обновлённый payload конфига.

Параметры

  • slugstringобязательный

    Configuration slug to update

  • namestring

    New name for the configuration

  • statusenum

    Configuration status

    activeinactive
  • cache_modeenum

    Cache mode: 'simple' or 'semantic'

    simplesemantic
  • cache_max_agenumber

    Cache max age in seconds

  • retry_attemptsnumber

    Number of retry attempts (1-5)

  • retry_on_status_codesnumber[]

    HTTP status codes to retry on

  • strategy_modeenum

    Routing strategy

    loadbalancefallback
  • targetsobject[]

    Array of target providers

update_feedbackвнешний мир

Обновить существующую запись обратной связи по ID. Возвращает обновлённый статус и ID обратной связи, изменяет только значение, вес и метаданные, а привязку к трассировке оставляет неизменной; используйте create_feedback только для новой записи.

Обновить существующую запись обратной связи по ID. Возвращает обновлённый статус и ID обратной связи, изменяет только значение, вес и метаданные, а привязку к трассировке оставляет неизменной; используйте create_feedback только для новой записи.

Параметры

  • idstringобязательный

    The unique identifier of the feedback to update

  • valuenumber

    New feedback value/rating. Common patterns: 1 for positive, 0 for negative.

  • weightnumber

    New weighting factor for the feedback

  • metadataobject

    New or updated custom metadata for the feedback

update_guardrailвнешний мир

Обновляет имя, проверки или действия guardrail, в отличие от create_guardrail, который регистрирует новый, или delete_guardrail, который удаляет его. Это создаёт новую версию, которая вступает в силу немедленно для зависимых конфигураций, поэтому сначала просмотрите list_guardrails; возвращает обновлённые id, slug и version_id.

Обновляет имя, проверки или действия guardrail, в отличие от create_guardrail, который регистрирует новый, или delete_guardrail, который удаляет его. Это создаёт новую версию, которая вступает в силу немедленно для зависимых конфигураций, поэтому сначала просмотрите list_guardrails; возвращает обновлённые id, slug и version_id.

Параметры

  • guardrail_idstringобязательный

    The guardrail UUID or slug to update

  • namestring

    New name for the guardrail

  • checksobject[]

    Updated array of checks to apply

  • actionsobject

    Updated actions configuration

update_integrationидемпотентный

Обновляет имя, описание, API-ключ или конфигурацию, специфичную для провайдера, у интеграции уровня организации по slug. Изменяются только указанные поля, обновление применяется сразу (без истории версий); изменения ключа и конфигурации вступают в силу немедленно и могут нарушить работу зависимых провайдеров или активных запросов, поэтому сначала проверьте текущие настройки с помощью get_integration. Получите slug из list_integrations; предоставление моделей и доступ к рабочим пространствам управляются отдельно через update_integration_models и update_integration_workspaces. Возвращает флаг успеха.

Обновляет имя, описание, API-ключ или конфигурацию, специфичную для провайдера, у интеграции уровня организации по slug. Изменяются только указанные поля, обновление применяется сразу (без истории версий); изменения ключа и конфигурации вступают в силу немедленно и могут нарушить работу зависимых провайдеров или активных запросов, поэтому сначала проверьте текущие настройки с помощью get_integration. Получите slug из list_integrations; предоставление моделей и доступ к рабочим пространствам управляются отдельно через update_integration_models и update_integration_workspaces. Возвращает флаг успеха.

Параметры

  • slugstringобязательный

    The slug of the integration to update

  • namestring

    New human-readable name for the integration

  • keystring

    New API key for the provider

  • descriptionstring

    New description for the integration

  • api_versionstring

    New API version (for Azure OpenAI)

  • resource_namestring

    New resource name (for Azure OpenAI)

  • deployment_namestring

    New deployment name (for Azure OpenAI)

  • aws_regionstring

    New AWS region (for AWS Bedrock)

  • aws_access_key_idstring

    New AWS access key ID (for AWS Bedrock)

  • aws_secret_access_keystring

    New AWS secret access key (for AWS Bedrock)

  • vertex_project_idstring

    New GCP project ID (for Vertex AI)

  • vertex_regionstring

    New GCP region (for Vertex AI)

  • custom_hoststring

    New custom base URL for the provider

update_integration_modelsвнешний мир

Включает, отключает или регистрирует пользовательские модели для интеграции. Это меняет доступность моделей для всех рабочих пространств, использующих её, поэтому сначала подтвердите влияние на последующие системы. Возвращает успех и количество обновлённых моделей.

Включает, отключает или регистрирует пользовательские модели для интеграции. Это меняет доступность моделей для всех рабочих пространств, использующих её, поэтому сначала подтвердите влияние на последующие системы. Возвращает успех и количество обновлённых моделей.

Параметры

  • slugstringобязательный

    The slug of the integration

  • modelsobject[]обязательный

    Array of model configurations to update

update_integration_workspacesвнешний мир

Управляйте тем, какие рабочие пространства могут использовать интеграцию, и устанавливайте ограничения для каждого рабочего пространства — в отличие от update_integration, который редактирует подключение на уровне организации. Сначала вызовите list_integration_workspaces, чтобы просмотреть текущее состояние; изменения доступа и новые лимиты применяются к последующему использованию сразу, и вызов возвращает успех плюс количество обновлённых рабочих пространств.

Управляйте тем, какие рабочие пространства могут использовать интеграцию, и устанавливайте ограничения для каждого рабочего пространства — в отличие от update_integration, который редактирует подключение на уровне организации. Сначала вызовите list_integration_workspaces, чтобы просмотреть текущее состояние; изменения доступа и новые лимиты применяются к последующему использованию сразу, и вызов возвращает успех плюс количество обновлённых рабочих пространств.

Параметры

  • slugstringобязательный

    The slug of the integration

  • workspacesobject[]обязательный

    Array of workspace configurations to update

update_log_exportвнешний мир

Обновите существующую конфигурацию экспорта логов до или между запусками экспорта. После создания можно изменять только workspace_id, time_of_generation_max и requested_fields, поэтому используйте get_log_export для просмотра текущей задачи и start_log_export после того, как определение будет готово.

Обновите существующую конфигурацию экспорта логов до или между запусками экспорта. После создания можно изменять только workspace_id, time_of_generation_max и requested_fields, поэтому используйте get_log_export для просмотра текущей задачи и start_log_export после того, как определение будет готово.

Параметры

  • export_idstringобязательный

    The unique ID of the log export to update

  • workspace_idstring

    Workspace ID for the export

  • time_of_generation_maxstring

    Maximum time filter in date format (e.g., '2024-07-25' or ISO 8601)

  • requested_fieldsstring[]

    Fields to include in export: id, trace_id, created_at, request, response, is_success, ai_org, ai_model, req_units, res_units, total_units, request_url, cost, cost_currency, response_time, response_status_code, mode, config, prompt_slug, metadata

update_mcp_integrationвнешний мир

Обновляет имя, описание, URL, аутентификацию или транспорт MCP-интеграции. Изменения вступают в силу немедленно, и изменение URL или auth_type может нарушить работу подключённых клиентов; используйте update_mcp_server, если нужно только переименовать или изменить описание сервера.

Обновляет имя, описание, URL, аутентификацию или транспорт MCP-интеграции. Изменения вступают в силу немедленно, и изменение URL или auth_type может нарушить работу подключённых клиентов; используйте update_mcp_server, если нужно только переименовать или изменить описание сервера.

Параметры

  • idstringобязательный

    The MCP integration ID or slug to update

  • namestring

    New display name

  • descriptionstring

    New description

  • urlstring

    New URL endpoint

  • auth_typeenum

    New authentication type

    oauth_autoheadersnone
  • transportenum

    New transport protocol

    httpsse
  • custom_headersobject

    New custom headers for authentication. Sent via configurations.custom_headers

update_mcp_integration_capabilitiesидемпотентный

Массово включает или отключает возможности (инструменты, промпты, ресурсы) в MCP-интеграции. Это обратимое переключение, а не удаление: меняют состояние только те возможности, которые указаны в массиве. Изменение сразу скрывает или показывает их для подключённых пользователей. Повторный вызов с обратным значением enabled восстанавливает исходное состояние. ID интеграции берите из list_mcp_integrations, а текущие названия, типы и состояния возможностей — из list_mcp_integration_capabilities. Возвращает сообщение об успешном выполнении.

Массово включает или отключает возможности (инструменты, промпты, ресурсы) в MCP-интеграции. Это обратимое переключение, а не удаление: меняют состояние только те возможности, которые указаны в массиве. Изменение сразу скрывает или показывает их для подключённых пользователей. Повторный вызов с обратным значением enabled восстанавливает исходное состояние. ID интеграции берите из list_mcp_integrations, а текущие названия, типы и состояния возможностей — из list_mcp_integration_capabilities. Возвращает сообщение об успешном выполнении.

Параметры

  • idstringобязательный

    The MCP integration ID or slug

  • capabilitiesobject[]обязательный

    Array of capability updates

update_mcp_integration_workspacesидемпотентный

Предоставляет или отзывает доступ к рабочему пространству для MCP интеграции массово. Обратимо: изменяются только указанные рабочие пространства, доступ применяется или удаляется немедленно для всех пользователей в этих пространствах, а повторный запуск с переключенным enabled отменяет изменение. Идентификатор интеграции берите из list_mcp_integrations, идентификаторы рабочих пространств — из list_workspaces, а текущее состояние доступа — из list_mcp_integration_workspaces. Возвращает сообщение об успешном подтверждении.

Предоставляет или отзывает доступ к рабочему пространству для MCP интеграции массово. Обратимо: изменяются только указанные рабочие пространства, доступ применяется или удаляется немедленно для всех пользователей в этих пространствах, а повторный запуск с переключенным enabled отменяет изменение. Идентификатор интеграции берите из list_mcp_integrations, идентификаторы рабочих пространств — из list_workspaces, а текущее состояние доступа — из list_mcp_integration_workspaces. Возвращает сообщение об успешном подтверждении.

Параметры

  • idstringобязательный

    The MCP integration ID or slug

  • workspacesobject[]обязательный

    Array of workspace access updates

update_mcp_serverвнешний мир

Обновляет имя или описание MCP-сервера. Изменения применяются немедленно, но URL и авторизация остаются в родительской интеграции — для этих полей используйте update_mcp_integration.

Обновляет имя или описание MCP-сервера. Изменения применяются немедленно, но URL и авторизация остаются в родительской интеграции — для этих полей используйте update_mcp_integration.

Параметры

  • idstringобязательный

    The MCP server ID or slug to update

  • namestring

    New display name

  • descriptionstring

    New description

update_mcp_server_capabilitiesвнешний мир

Включает или отключает возможности на сервере MCP. Изменения вступают в силу немедленно и переопределяют настройки уровня интеграции для этого сервера; сначала используйте list_mcp_server_capabilities, чтобы проверить текущую поверхность.

Включает или отключает возможности на сервере MCP. Изменения вступают в силу немедленно и переопределяют настройки уровня интеграции для этого сервера; сначала используйте list_mcp_server_capabilities, чтобы проверить текущую поверхность.

Параметры

  • idstringобязательный

    The MCP server ID or slug

  • capabilitiesobject[]обязательный

    Array of capability updates

update_mcp_server_user_accessвнешний мир

Предоставьте или отзовите доступ отдельным пользователям к MCP-серверу. Изменения вступают в силу немедленно и переопределяют настройки доступа по умолчанию для выбранных пользователей; сначала используйте list_mcp_server_user_access, если нужно узнать текущее состояние.

Предоставьте или отзовите доступ отдельным пользователям к MCP-серверу. Изменения вступают в силу немедленно и переопределяют настройки доступа по умолчанию для выбранных пользователей; сначала используйте list_mcp_server_user_access, если нужно узнать текущее состояние.

Параметры

  • idstringобязательный

    The MCP server ID or slug

  • usersobject[]обязательный

    Array of user access updates

update_promptвнешний мир

Обновляет существующий промпт и создаёт новую архивную версию. Изменяются только переданные поля, а publish_prompt делает новую версию активной. Для многосообщенийных чат-промптов передавайте messages (предпочтительно) или массив в JSON-кодировке в виде строки.

Обновляет существующий промпт и создаёт новую архивную версию. Изменяются только переданные поля, а publish_prompt делает новую версию активной. Для многосообщенийных чат-промптов передавайте messages (предпочтительно) или массив в JSON-кодировке в виде строки.

Параметры

  • prompt_idstringобязательный

    Prompt ID or slug to update

  • namestring

    New display name for the prompt

  • collection_idstring

    Move to a different collection

  • stringstring

    Legacy prompt template string. Use plain text for single-message prompts, or a JSON-encoded messages array string for multi-message chat prompts.

  • messagesobject[]

    Structured chat template alias for updates. Serialized to the legacy string format before the prompt is updated.

  • parametersobject

    New default values for template variables

  • modelstring

    New model identifier

  • virtual_keystring

    New virtual key slug

  • version_descriptionstring

    Description for this version

  • template_metadataobject

    New metadata

  • functionsobject[]

    New function definitions

  • toolsobject[]

    New tool definitions

  • tool_choiceobject

    New tool choice strategy

  • dry_runboolean

    When true, validate without updating

update_prompt_labelвнешний мир

Обновляет только имя, описание или цвет метки промпта, в отличие от update_prompt_version, которая меняет, какую метку несет версия. Изменение вступает в силу немедленно для всех версий, уже помеченных этой меткой, но не перераспределяет метки и не затрагивает историю; сначала используйте list_prompt_labels, чтобы найти label_id.

Обновляет только имя, описание или цвет метки промпта, в отличие от update_prompt_version, которая меняет, какую метку несет версия. Изменение вступает в силу немедленно для всех версий, уже помеченных этой меткой, но не перераспределяет метки и не затрагивает историю; сначала используйте list_prompt_labels, чтобы найти label_id.

Параметры

  • label_idstringобязательный

    Label ID to update

  • namestring

    New name for the label

  • descriptionstring

    New description

  • color_codestring

    New hex color code (e.g., '#FF5733')

update_prompt_partialвнешний мир

Создаёт новую версию партиала, обновляя её содержимое или метаданные. Меняются только указанные поля, новая версия остаётся неактивной, пока publish_partial не сделает её текущей.

Создаёт новую версию партиала, обновляя её содержимое или метаданные. Меняются только указанные поля, новая версия остаётся неактивной, пока publish_partial не сделает её текущей.

Параметры

  • prompt_partial_idstringобязательный

    Prompt partial ID or slug to update

  • namestring

    New display name for the partial

  • stringstring

    New content for the partial

  • descriptionstring

    Description for this version

  • statusenum

    New status for the partial

    activearchived
update_prompt_versionвнешний мир

Обновляет назначение метки для конкретной версии промпта. Этот инструмент только назначает или удаляет метку, а null очищает метку после того, как вы найдете идентификаторы с помощью list_prompt_labels.

Обновляет назначение метки для конкретной версии промпта. Этот инструмент только назначает или удаляет метку, а null очищает метку после того, как вы найдете идентификаторы с помощью list_prompt_labels.

Параметры

  • prompt_idstringобязательный

    Prompt ID or slug

  • version_idstringобязательный

    Version UUID to update

  • label_idanyобязательный

    Label ID to assign to this version, or null to remove the label

update_providerвнешний мир

Обновляет метаданные, лимиты или срок действия провайдера. reset_usage немедленно сбрасывает накопленные счётчики использования — используйте его, только когда собираетесь сбросить отслеживание квоты. Возвращает обновлённые id и slug провайдера.

Обновляет метаданные, лимиты или срок действия провайдера. reset_usage немедленно сбрасывает накопленные счётчики использования — используйте его, только когда собираетесь сбросить отслеживание квоты. Возвращает обновлённые id и slug провайдера.

Параметры

  • slugstringобязательный

    The slug of the provider to update

  • workspace_idstring

    Workspace ID - required when using organization admin keys

  • namestring

    New display name for the provider

  • notestring

    New note or description for the provider

  • credit_limitnumber

    New credit limit for usage

  • alert_thresholdnumber

    New alert threshold percentage (0-100)

  • usage_limit_typeenum

    Type of usage limit: 'cost' (monetary) or 'tokens' (token count). Defaults to 'cost'.

    costtokens
  • periodic_resetenum

    Period for resetting usage limits: 'monthly' or 'weekly'. Defaults to 'monthly'.

    monthlyweekly
  • rate_limit_valuenumber

    New rate limit value

  • rate_limit_unitenum

    Rate limit unit: 'rpm' (requests per minute), 'rph' (requests per hour), or 'rpd' (requests per day)

    rpmrphrpd
  • expires_atstring

    New expiration date in ISO 8601 format

  • reset_usageboolean

    Set to true to reset accumulated usage metrics

update_rate_limitвнешний мир

Обновите имя, единицу измерения или значение лимита скорости по id. Условия и group_by неизменяемы после создания; сначала используйте get_rate_limit, если вам нужна полная политика.

Обновите имя, единицу измерения или значение лимита скорости по id. Условия и group_by неизменяемы после создания; сначала используйте get_rate_limit, если вам нужна полная политика.

Параметры

  • idstringобязательный

    The unique identifier of the rate limit

  • namestring

    New name for the rate limit

  • unitenum

    New time unit: 'rpm' (per minute), 'rph' (per hour), or 'rpd' (per day)

    rpmrphrpd
  • valuenumber

    New maximum allowed value per unit

update_secret_referenceидемпотентныйвнешний мир

Обновляет хотя бы одно выбранное поле в Secret Reference. auth_config объединяется с существующей конфигурацией, специфичной для менеджера. allowed_workspaces заменяет все привязки рабочих пространств и устанавливает allow_all_workspaces=false; allow_all_workspaces=true удаляет привязки к конкретным рабочим пространствам. Учётные данные отправляются в Portkey и становятся доступны в MCP transcript.

Обновляет хотя бы одно выбранное поле в Secret Reference. auth_config объединяется с существующей конфигурацией, специфичной для менеджера. allowed_workspaces заменяет все привязки рабочих пространств и устанавливает allow_all_workspaces=false; allow_all_workspaces=true удаляет привязки к конкретным рабочим пространствам. Учётные данные отправляются в Portkey и становятся доступны в MCP transcript.

Параметры

  • idstringобязательный

    Secret Reference UUID or slug

  • namestring

    New human-readable name

  • descriptionany

    New description, or null to clear it

  • auth_configany

    Provide at least one changed authentication field to merge into the existing configuration; choose one AWS, Azure, or HashiCorp field family and do not mix families

  • secret_pathstring

    New path of the secret in the external secret manager

  • secret_keyany

    New key within a structured secret, or null to use the whole value

  • allow_all_workspacesboolean

    Whether every workspace may use this reference; cannot be true with allowed_workspaces

  • allowed_workspacesstring[]

    Replacement list of workspace UUIDs or slugs allowed to use this reference; supplying it sets allow_all_workspaces=false

  • tagsany

    Replacement string key-value tags, or null to clear them

update_usage_limitвнешний мир

Обновляет название, кредитный лимит, порог оповещения, расписание сброса или цель сброса лимита использования по его ID — в отличие от update_rate_limit, который настраивает ограничение запросов. Новые значения применяются к отслеживаемому использованию немедленно; условия и group_by неизменны после создания. Вызов возвращает обновленный ID без очистки накопленного использования (для этого используйте reset_usage_limit_entity).

Обновляет название, кредитный лимит, порог оповещения, расписание сброса или цель сброса лимита использования по его ID — в отличие от update_rate_limit, который настраивает ограничение запросов. Новые значения применяются к отслеживаемому использованию немедленно; условия и group_by неизменны после создания. Вызов возвращает обновленный ID без очистки накопленного использования (для этого используйте reset_usage_limit_entity).

Параметры

  • idstringобязательный

    The unique identifier of the usage limit

  • namestring

    New name for the usage limit

  • credit_limitnumber

    New maximum allowed usage value

  • alert_thresholdnumber

    New alert threshold percentage (0-100)

  • periodic_resetenum

    New periodic reset schedule

    monthlyweekly
  • reset_usage_for_valuestring

    Reset usage counters for a specific group_by value

update_userвнешний мир

Обновляет имя, фамилию или организационную роль пользователя по id. Email и роли рабочего пространства здесь не редактируются — для изменения членства в рабочем пространстве используйте update_workspace_member.

Обновляет имя, фамилию или организационную роль пользователя по id. Email и роли рабочего пространства здесь не редактируются — для изменения членства в рабочем пространстве используйте update_workspace_member.

Параметры

  • user_idstringобязательный

    The user ID to update

  • first_namestring

    New first name

  • last_namestring

    New last name

  • roleenum

    New organization-level role

    adminmember
update_virtual_keyвнешний мир

Обновляет имя, секрет, примечание или лимиты виртуального ключа. Ротация ключа вступает в силу немедленно, а изменения лимитов применяются к последующим запросам и конфигурациям, использующим этот slug. Возвращает обновлённые имя, slug и статус.

Обновляет имя, секрет, примечание или лимиты виртуального ключа. Ротация ключа вступает в силу немедленно, а изменения лимитов применяются к последующим запросам и конфигурациям, использующим этот slug. Возвращает обновлённые имя, slug и статус.

Параметры

  • slugstringобязательный

    The slug of the virtual key to update

  • namestring

    New display name for the key

  • keystring

    New provider API key value

  • notestring

    New note or description

  • credit_limitnumber

    New credit limit for usage

  • alert_thresholdnumber

    New alert threshold percentage (0-100)

  • rate_limit_rpmnumber

    New rate limit in requests per minute

update_workspaceвнешний мир

Обновляет имя, slug, описание, флаг по умолчанию или метаданные рабочей области по идентификатору, в отличие от update_workspace_member, который меняет назначение ролей внутри рабочей области. Меняются только указанные поля, обновления вступают в силу немедленно; изменение slug может сломать URL, ссылки на API-ключи и другие внешние ссылки, поэтому сначала убедитесь в отсутствии зависимостей.

Обновляет имя, slug, описание, флаг по умолчанию или метаданные рабочей области по идентификатору, в отличие от update_workspace_member, который меняет назначение ролей внутри рабочей области. Меняются только указанные поля, обновления вступают в силу немедленно; изменение slug может сломать URL, ссылки на API-ключи и другие внешние ссылки, поэтому сначала убедитесь в отсутствии зависимостей.

Параметры

  • workspace_idstringобязательный

    The workspace ID to update

  • namestring

    New name for the workspace

  • slugstring

    New slug for the workspace

  • descriptionstring

    New description

  • is_defaultnumber

    Set as default workspace (1 = yes, 0 = no)

  • metadataobject

    New metadata key-value pairs

update_workspace_memberвнешний мир

Обновляет роль участника рабочего пространства по workspace_id и user_id. Здесь меняется только роль; сначала используйте list_workspace_members или get_workspace_member, чтобы подтвердить текущее назначение.

Обновляет роль участника рабочего пространства по workspace_id и user_id. Здесь меняется только роль; сначала используйте list_workspace_members или get_workspace_member, чтобы подтвердить текущее назначение.

Параметры

  • workspace_idstringобязательный

    The workspace ID

  • user_idstringобязательный

    The user ID to update

  • roleenumобязательный

    New role in the workspace

    adminmembermanager
validate_completion_metadataтолько чтениеидемпотентныйвнешний мир

Проверяет биллинговые метаданные перед run_prompt_completion. Валидирует обязательные поля и значения без внесения изменений — так вы сможете отловить ошибки атрибуции до того, как заплатите за вызов.

Проверяет биллинговые метаданные перед run_prompt_completion. Валидирует обязательные поля и значения без внесения изменений — так вы сможете отловить ошибки атрибуции до того, как заплатите за вызов.

Параметры

  • client_idstring

    Client ID for billing attribution

  • appstring

    App identifier (REQUIRED). Use your deployed app name, for example 'hourlink' or 'support-console'.

  • envstring

    Environment identifier (REQUIRED). Use your environment name, for example 'dev', 'staging', 'prod', or 'qa'.

  • project_idstring

    Project ID for granular billing

  • featurestring

    Feature name for tracking

Другие проверенные MCP-сервера

ReAPI-com/mcp-openapi

ReAPI-com/mcp-openapi

официальный

MCP сервер для загрузки OpenAPI спецификаций и их интеграции с LLM в IDE. Он помогает разработчикам находить операции, схемы и получать контекст для генерации кода и работы с API.

TypeScript⭐ 88
stack-chan/stack-chan

stack-chan/stack-chan

Stack-chan - это JavaScript-управляемый робот на базе M5Stack с супер-кавайным лицом. Управляйте эмоциями, взглядом, речью и сервоприводами. Идеален для DIY и образовательных проектов.

TypeScript⭐ 1597
chatmcp/mcp-server-chatsum

chatmcp/mcp-server-chatsum

MCP-сервер для суммаризации чат-сообщений. Позволяет запрашивать и обобщать переписку с помощью инструмента query_chat_messages. Полезен для анализа бесед и быстрого получения выжимки из чатов.

TypeScript⭐ 1030
PSPDFKit/nutrient-dws-mcp-server

PSPDFKit/nutrient-dws-mcp-server

официальный

MCP-сервер для подключения AI-ассистентов к Nutrient DWS API: создавайте, редактируйте, конвертируйте и подписывайте документы через естественный язык. Полезен разработчикам, внедряющим документооб...

TypeScript⭐ 68
firebase/genkit

firebase/genkit

Genkit - open-source инструмент от Firebase для full-stack AI-приложений. Unified API для моделей Google, OpenAI, Anthropic, Ollama. Поддерживает JS/TS, Go, Python, Dart. Упрощает разработку чат-ботов, автоматизаций, RAG. Включает CLI, UI и мониторинг.

TypeScript⭐ 6255
GLips/Figma-Context-MCP

GLips/Figma-Context-MCP

Framelink MCP для Figma даёт AI-ассистентам вроде Cursor доступ к макетам из Figma. Сервер упрощает данные дизайна, передавая только релевантную информацию о расположении и стилях — так модель точн...

TypeScript⭐ 15431
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин