{"report":"{\"v\":1,\"package\":\"@avallon-labs/mcp\",\"version\":\"68.3.0\",\"ranAt\":\"2026-11-16T11:27:40.772Z\",\"install\":{\"ok\":true,\"integrity\":\"sha512-Cy1xy+ajZpfPHxq8nrED15vSmHlbGV0FDwZQwLco7kRchNJhpGRF/v3ijLu77GBD9YBiWXPyv1KGfYqpAhdfGg==\",\"deps\":95,\"scripts\":[],\"bins\":[\"avallon-mcp\"],\"license\":\"MIT\",\"engines\":\"node >=18\",\"bin\":\"avallon-mcp\"},\"start\":{\"ok\":true,\"ms\":255,\"serverName\":\"avallonAPIServer\",\"serverVersion\":\"1.0.0\",\"protocol\":\"2025-06-18\",\"stderr\":\"MCP server running on stdio\\n\"},\"tools\":[{\"name\":\"listVoiceAgents\",\"description\":\"List all voice agents for your tenant.\\n\\n**Filtering:**\\n\\nFilter voice agents by name using the `agent_name` query parameter (exact match).\\n\\n**Response:**\\n\\nReturns an array of all voice agents with their configurations and a total count.\\n\\nFor compatibility this endpoint is also available using the following (deprecated) paths:\\n`GET /v1/agents`\",\"params\":[\"queryParams\"]},{\"name\":\"createVoiceAgent\",\"description\":\"Create a new voice agent with the specified configuration.\\n\\n**Required fields:**\\n\\nProvide `engine`: a `pipeline` of STT, LLM and TTS models, or a `speech_to_speech` model such as `gpt-live-1`. The flat `llm_model`, `tts_provider`, `tts_model`, `tts_voice_id` and `stt_model` fields are deprecated; they still create a pipeline agent but cannot be combined with `engine`.\\n\\nAll other fields are required except `phone_number_id` and `transfer_phone_number`.\\n\\n**Response:**\\n\\nReturns the created voice agent with its ID and configuration.\\n\\nFor compatibility this endpoint is also available using the following (deprecated) paths:\\n`POST /v1/agents`\",\"params\":[\"bodyParams\"]},{\"name\":\"getVoiceAgent\",\"description\":\"Retrieve a single voice agent by its ID.\\n\\nFor compatibility this endpoint is also available using the following (deprecated) paths:\\n`GET /v1/agents/{id}`\",\"params\":[\"pathParams\"]},{\"name\":\"updateVoiceAgent\",\"description\":\"Update a voice agent. Only the fields you send change; omitted fields keep their current value.\\n\\nTo change the processor assignment, `call_processor_id` and `call_processor_type` must be provided together. Set `call_processor_id` to `null` to detach (`call_processor_type` is still required).\\n\\nSet `engine` to replace the whole model setup: `pipeline` (STT, LLM and TTS models plus optional fallbacks) or `speech_to_speech` (`gpt-live-1` and a voice). For `gpt-live-1`, `prompt` is the reasoner prompt and `speaker_instructions` the speaker prompt.\\n\\nThe flat model fields (`llm_model`, `tts_provider`, `tts_model`, `tts_voice_id`, `stt_model` and their `fallback_*` counterparts) are deprecated and only work on pipeline agents. They cannot be combined with `engine`. They are validated against the resulting configuration, so a single field such as `tts_voice_id` can be sent on its own.\\n\\nSet `voice_mail_detection` to `true` to have the agent listen for a voicemail beep tone. Detection only runs on `OUTBOUND` agents; enabling it on an `INBOUND` agent is stored but has no effect.\\n\\nSet `max_call_duration_seconds` to change how long a call may run before the agent ends it (default 1800).\\n\\nSet `background_sounds` to `disabled` to turn off the ambient office background sounds played during calls.\\n\\nSet `noise_cancellation` to choose the noise cancellation mode applied to the caller audio.\\n\\nSet `tool_ids` to replace the agent's attached tool set. This is the supported way to manage tool attachments; the dedicated add and remove endpoints are deprecated.\\n\\nSet `evaluator_slug` to score the agent's calls with that evaluator. Calls only use it once the new version is promoted, because a call is evaluated with the version it ran on.\\n\\nAll changes in one request create a single new voice agent config version. The live and test releases keep pointing at their current versions until the new version is promoted.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"deleteVoiceAgent\",\"description\":\"Delete a voice agent. The agent is hidden from all reads; its call and job history is preserved.\",\"params\":[\"pathParams\"]},{\"name\":\"listVoiceAgentVersions\",\"description\":\"List all config versions for a voice agent, ordered by version (newest first by default).\",\"params\":[\"pathParams\",\"queryParams\"]},{\"name\":\"getVoiceAgentVersion\",\"description\":\"Retrieve a single voice agent config version, including the agent's identity, the config snapshot at that version, and version-specific metadata.\",\"params\":[\"pathParams\"]},{\"name\":\"promoteVoiceAgentVersion\",\"description\":\"Select a voice agent configuration version for the live or test environment.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"getVoiceAgentVersionChangeSummary\",\"description\":\"Returns an AI-generated summary of what changed between this version and the previous one. Initial version returns an empty string since there is no predecessor.\",\"params\":[\"pathParams\"]},{\"name\":\"getVoiceAgentPlaceholders\",\"description\":\"Retrieve the available placeholder variables defined in a voice agent's prompt.\\n\\nFor compatibility this endpoint is also available using the following (deprecated) paths:\\n`GET /v1/agents/{id}/prompt`\",\"params\":[\"pathParams\"]},{\"name\":\"getVoiceAgentPrompt\",\"description\":\"Retrieve the prompt for a voice agent. Pass `version` to fetch the prompt snapshot at a specific config version; omit it to fetch the current prompt. Internal use only.\",\"params\":[\"pathParams\",\"queryParams\"]},{\"name\":\"updateVoiceAgentPrompt\",\"description\":\"Update the prompt for a voice agent. Internal use only.\\n\\n**Deprecated:** Use `PATCH /v1/voice-agents/{voiceAgentId}` instead.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"updateVoiceAgentModels\",\"description\":\"Update the LLM, TTS, and STT model configuration for a voice agent.\\n\\n**Deprecated:** Use `PATCH /v1/voice-agents/{voiceAgentId}` instead.\\n\\nFor compatibility this endpoint is also available using the following (deprecated) paths:\\n`PATCH /v1/agents/{id}/models`\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"updateCallControls\",\"description\":\"Update call control settings for a voice agent.\\n\\nConfigure whether the voice agent supports dial pad input, can end calls, and set a transfer phone number.\\n\\n**Deprecated:** Use `PATCH /v1/voice-agents/{voiceAgentId}` instead.\\n\\nFor compatibility this endpoint is also available using the following (deprecated) paths:\\n`PUT /v1/agents/{id}/call-controls`\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"scheduleJob\",\"description\":\"**Deprecated:** use `POST /v1/calls`, which returns the call itself.\\n\\nSchedule a new outbound call job for a voice agent.\\n\\nThe job can be scheduled for a future time or triggered immediately with `trigger_immediately: true`.\\n\\n**Scheduling:**\\n\\nWhen scheduling for a future time, provide `scheduled_at` (ISO 8601) and optionally `schedule_window_minutes` (minimum 10 minutes).\\n\\n**Environment:**\\n\\n`environment` selects which promoted agent configuration and phone binding the call dispatches against (`live` or `test`). Defaults to `live`. Scheduling fails when the selected environment has no active promotion.\\n\\nFor compatibility this endpoint is also available using the following (deprecated) paths:\\n`POST /v1/agents/{id}/jobs`\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"listJobs\",\"description\":\"**Deprecated:** use `GET /v1/calls?state=scheduled,in_progress,ended,canceled,failed`, which also filters by `scheduled_after` / `scheduled_before`. `GET /v1/calls/{id}` returns a call's `payload`.\\n\\nList all outbound jobs with pagination and filtering.\\n\\n**Filtering:**\\n\\n- Filter by agent ID, status, or scheduled time range.\\n- Multiple statuses can be comma-separated (e.g. `status=pending,queued`).\\n\\nFor compatibility this endpoint is also available using the following (deprecated) paths:\\n`GET /v1/agents/jobs`\",\"params\":[\"queryParams\"]},{\"name\":\"cancelJob\",\"description\":\"**Deprecated:** use `POST /v1/calls/{id}/cancel`.\\n\\nCancel a pending or queued outbound job. Jobs that are already in progress or completed cannot be canceled.\\n\\nFor compatibility this endpoint is also available using the following (deprecated) paths:\\n`POST /v1/agents/jobs/{id}/cancel`\",\"params\":[\"pathParams\"]},{\"name\":\"listApiKeys\",\"description\":\"List all API keys for your tenant.\\n\\nBy default, revoked keys are excluded. Set `include_revoked=true` to include them.\\n\\n**Note:** The full API key value is never returned — only the key prefix is shown.\",\"params\":[\"queryParams\"]},{\"name\":\"createApiKey\",\"description\":\"Create a new API key for authenticating with the Avallon API.\\n\\n**Important:** The full API key is only returned once in the response. Store it securely — it cannot be retrieved again.\\n\\nKeys are scoped to an environment (`test` or `live`) and optionally accept an expiration date.\",\"params\":[\"bodyParams\"]},{\"name\":\"revokeApiKey\",\"description\":\"Revoke an existing API key. Once revoked, the key can no longer be used for authentication.\\n\\nThis operation is irreversible — revoked keys cannot be re-enabled. Create a new key if needed.\\n\\nReturns 409 if the key is already revoked, 404 if the key does not exist.\",\"params\":[\"pathParams\"]},{\"name\":\"updateApiKey\",\"description\":\"Update mutable fields of an API key. Currently only `role` can be updated.\\n\\nThe caller's role caps the maximum role they can grant — an `admin` cannot promote a key to `avallon_admin`.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"createArtifact\",\"description\":\"Upload a document as a base64-encoded artifact for processing.\\n\\n**Limits:**\\n\\nMaximum file size is approximately 6.75MB (base64 encoded). The API Gateway has a 10MB request limit.\\n\\n**Processing options:**\\n\\n- `file_password`: Password for encrypted PDFs\\n- `file_splitting_enabled`: Split multi-page PDFs into separate artifacts\",\"params\":[\"bodyParams\"]},{\"name\":\"listArtifacts\",\"description\":\"List all artifacts with pagination, filtering, and sorting.\\n\\n**Case Filtering:**\\n\\nUse `case_id` to return only artifacts linked to a case. This reads the case links\\ncreated via `POST /v1/cases/{caseId}/links`, and is independent of any\\n`metadata.case_id` an artifact may carry.\\n\\n**Metadata Filtering:**\\n\\nUse bracket notation to filter by metadata keys:\\n- `metadata[claim_id]=abc-123`\\n- `metadata[source]=email`\\n\\nMultiple metadata filters can be combined (AND logic).\",\"params\":[\"queryParams\"]},{\"name\":\"getArtifact\",\"description\":\"Retrieve a single artifact by ID, including its metadata, file URL, extracted content, and chunk-annotated content.\\n\\nThe response always includes `content_with_chunkids_md`: the parsed content annotated with `[chunk_id=...]` markers when the artifact has parsed chunks. Chunk IDs are stable citation anchors — cite them to attribute extracted values to their source location.\",\"params\":[\"pathParams\"]},{\"name\":\"deleteArtifact\",\"description\":\"Soft-delete an artifact. Soft-deleted artifacts and their chunks no longer appear in any read.\",\"params\":[\"pathParams\"]},{\"name\":\"getArtifactChunks\",\"description\":\"Resolve chunk ids to their document, page, bounding box and text, keyed by chunk id.\\n\\nChunk ids are the `[chunk_id=…]` markers in `content_with_chunkids_md` and the values\\nworkers cite (e.g. `data-cite-chunk`). Ids that are unknown or whose document was deleted\\nare omitted.\",\"params\":[\"queryParams\"]},{\"name\":\"getArtifactStatusSummary\",\"description\":\"Count the artifacts in a scope, broken down by processing status.\\n\\nDefine the scope with bracket notation (e.g. `scope[email_id]=abc-123`). At least one key is required; multiple keys are combined with AND logic.\",\"params\":[\"queryParams\"]},{\"name\":\"getArtifactUploadUrl\",\"description\":\"Returns a pre-signed PUT URL. Upload the file directly to `upload_url`, then pass `file_url` as `source_url` to POST /v1/upload-file.\",\"params\":[\"bodyParams\"]},{\"name\":\"updateArtifactMetadata\",\"description\":\"Merge-update metadata on an existing artifact. Provided keys are added or overwritten; other existing keys are preserved.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"signUp\",\"description\":\"Create a new user account with email and password. When the response includes a pending_authentication_token, the account requires email verification: complete it via sign-in (type: email_otp) with the emailed one-time password and this token.\",\"params\":[\"bodyParams\"]},{\"name\":\"signIn\",\"description\":\"Authenticate using one of the supported methods:\\n\\n- **Password:** Email and password credentials. If the password is correct but the email is not verified yet, responds 403 with `data.pending_authentication_token` and a fresh verification code is emailed; complete verification via **Email OTP**. Each password attempt invalidates earlier codes and tokens, so always use the most recent pair — repeating the password sign-in is also how a new code is requested.\\n- **OAuth:** Authorization code from OAuth flow (social or enterprise SSO). Pass the `provider` the flow was started with so the code is exchanged against the system that issued it. `verifier` is only required when the flow was started with a `code_challenge` — see **Get OAuth sign-in URL**.\\n- **Email OTP:** One-time password sent to email. Include the `pending_authentication_token` from sign-up, or from the 403 returned by an unverified user's password sign-in, when completing email verification.\",\"params\":[\"bodyParams\"]},{\"name\":\"requestPasswordReset\",\"description\":\"Start password recovery for an email/password account. When the email belongs to an account, a reset link is emailed to it. The response is 200 regardless, and does not reveal whether an account exists.\",\"params\":[\"bodyParams\"]},{\"name\":\"resetPassword\",\"description\":\"Complete password recovery with the token from the emailed reset link and set a new password. Completing the reset also verifies the account's email address. Afterwards, sign in with the new password.\",\"params\":[\"bodyParams\"]},{\"name\":\"refreshToken\",\"description\":\"Exchange a valid access token and refresh token pair for new tokens.\",\"params\":[\"bodyParams\"]},{\"name\":\"refreshSession\",\"description\":\"Rotate the refresh token and return a new access token for `tenant_id`. Call it with a different `tenant_id` to switch tenants.\\n\\nSend the current access token as `Authorization: Bearer`. It may be expired: it only identifies the user, and the refresh token must belong to that same user. The identity provider decides whether the session is still valid. The user must be a member of `tenant_id` (404 otherwise).\",\"params\":[\"bodyParams\"]},{\"name\":\"getOAuthUrl\",\"description\":\"Generate an OAuth authorization URL for a given provider.\\n\\nPKCE is optional. To use it, generate a random verifier, derive `code_challenge` from it, and pass both `code_challenge` and the matching `code_challenge_method` — then send the verifier to **Sign in** when exchanging the code. Omit both to run the flow without PKCE and exchange the code on its own.\\n\\nFor enterprise SSO, pass `provider=sso` together with the user's `email`; the email domain selects the SSO organization. Responds 404 when no SSO organization is configured for the domain.\",\"params\":[\"queryParams\"]},{\"name\":\"getSessionToken\",\"description\":\"Exchange an identity token for a tenant-scoped Core Plane access token.\\n\\n- If `tenant_id` is provided, validates the user is a member of that tenant and returns 404 if they are not.\\n- If `tenant_id` is omitted, selects the tenant of the identity token's organization, falling back to the user's default (oldest) tenant.\\n- Call this endpoint again with a different `tenant_id` to switch tenants.\",\"params\":[\"bodyParams\"]},{\"name\":\"getPartnerJwks\",\"description\":\"Returns the JSON Web Key Set (RFC 7517) of a partner's public signing keys, used to verify partner-issued launch tokens.\",\"params\":[\"pathParams\"]},{\"name\":\"partnerLaunch\",\"description\":\"Verifies a partner-signed launch token, mints an Avallon session, and redirects (302) the user into the app's handoff route, carrying the session token in the URL fragment (no cookie).\",\"params\":[\"queryParams\"]},{\"name\":\"listCalls\",\"description\":\"List all calls, with pagination, filtering, and sorting.\\n\\n**Filtering:**\\n\\nFilter by agent, direction, status, time range, phone number, and more. Phone number filter supports both exact E.164 matches and partial search.\\n\\n**Case Filtering:**\\n\\nUse `case_id` to return only calls linked to a case. This reads the case links created\\nvia `POST /v1/cases/{caseId}/links`, and is independent of any `metadata.case_id` a\\ncall may carry.\\n\\n**Metadata Filtering:**\\n\\nUse bracket notation to filter by metadata keys:\\n- `metadata[claim_id]=abc-123`\\n- `metadata[source]=worker`\\n\\nMultiple metadata filters can be combined (AND logic).\",\"params\":[\"queryParams\"]},{\"name\":\"createCall\",\"description\":\"Create an outbound call for a voice agent, either for later or right away.\\n\\n**Scheduling:**\\n\\nProvide `scheduled_at` (ISO 8601) to place the call later. It is dialed within 60 minutes of that time, or it expires. Omit `scheduled_at` to dial immediately.\\n\\n**Lifecycle:**\\n\\nThe call starts as `scheduled` and moves to `in_progress` when it is dialed, then `ended`. A scheduled call can be canceled with `POST /v1/calls/{id}/cancel`.\\n\\n**Environment:**\\n\\n`environment` selects which promoted agent configuration and phone binding the call dispatches against (`live` or `test`). Defaults to `live`.\",\"params\":[\"bodyParams\"]},{\"name\":\"getCall\",\"description\":\"Retrieve detailed information about a specific call.\\n\\nSet `include_messages=true` to include the full message transcript.\",\"params\":[\"pathParams\",\"queryParams\"]},{\"name\":\"cancelCall\",\"description\":\"Cancel an outbound call that is still `scheduled`. Canceling a call that is already canceled returns it unchanged; a call that is in progress or has ended cannot be canceled.\",\"params\":[\"pathParams\"]},{\"name\":\"listenCall\",\"description\":\"Issue a short-lived token that joins a connected call as a hidden, listen-only participant. Only calls that are `in_progress` with a `connected_at` can be listened to.\",\"params\":[\"pathParams\"]},{\"name\":\"getCallEvaluation\",\"description\":\"Retrieve the evaluation results for a specific call, including overall score, pass status, and per-metric breakdowns.\",\"params\":[\"pathParams\"]},{\"name\":\"getCallAnalytics\",\"description\":\"Retrieve aggregated call analytics for a time range.\\n\\nIncludes summary statistics, call volume over time, evaluation scores, score and duration distributions, and per-metric performance.\",\"params\":[\"queryParams\"]},{\"name\":\"getAnalyticsTimeSeries\",\"description\":\"Retrieve a tenant-scoped time series for a single metric.\\n\\nPick a `metric`, a date range, a bucket `granularity` (day/week/month), and optionally a `group_by` dimension and filters. The series is sparse (only buckets with data) over the half-open window `[from, to)`.\\n\\n- `worker_runs`, `documents`, `pages`: processing volume, bucketed by creation time. `worker_runs` can be grouped by `worker_id` and filtered by `worker_id` and `environment`. Documents are shared across environments and cannot be filtered by them.\\n- `finished_worker_runs`, `avg_worker_run_duration_ms`, `avg_worker_run_artifacts`, `worker_run_cost_usd`, `avg_worker_run_cost_usd`: worker runs that ended as completed, failed or canceled, windowed and bucketed by completion time. Runs created by worker evals and benchmarks are excluded. These can be filtered by `worker_id` and `environment`.\\n  - `finished_worker_runs`: number of finished runs. Can be grouped by `outcome` (`goal_reached`, `goal_not_reached`, `failed`, `canceled`); a completed run without a reported outcome counts as `goal_reached`.\\n  - `avg_worker_run_duration_ms`: average time from start to completion, in milliseconds. Runs that never started are excluded.\\n  - `avg_worker_run_artifacts`: average number of input artifacts resolved from the run's scope. Runs without a recorded artifact resolution are excluded.\\n  - `worker_run_cost_usd`, `avg_worker_run_cost_usd`: total and average estimated LLM cost of the runs, in USD. Canceled runs, runs that never reported the cost of their extraction, and runs that used a model without published pricing are excluded. Requires the `analytics:view-cost` permission.\\n\\n`data` is an array of per-metric results; today it always contains exactly one entry (the requested metric).\",\"params\":[\"queryParams\"]},{\"name\":\"createCallFeedback\",\"description\":\"Create feedback for a specific message in a call. Requires user (JWT) authentication; the author is derived from the authenticated user's profile and API-key callers are rejected.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"listCallFeedback\",\"description\":\"List all feedback for a call. Paginated.\",\"params\":[\"pathParams\",\"queryParams\"]},{\"name\":\"deleteCallFeedback\",\"description\":\"Delete a single feedback entry.\",\"params\":[\"pathParams\"]},{\"name\":\"checkInboxAvailability\",\"description\":\"Check whether a given email username is available for creating a new inbox.\\n\\nFor compatibility this endpoint is also available using the following (deprecated) paths:\\n`GET /v1/email-agents/availability`\",\"params\":[\"queryParams\"]},{\"name\":\"createInbox\",\"description\":\"Create a new inbox linked to a processor (extractor or worker).\\n\\nThe inbox receives emails at the live address built from `username` and at a test address built from `test_username` (defaults to `<username>-test`), and automatically processes attachments using the specified processor.\\n\\nEither `processor_id` or the deprecated `extractor_id` must be provided. When using `extractor_id`, the processor type defaults to `extractor`.\\n\\nFor compatibility this endpoint is also available using the following (deprecated) paths:\\n`POST /v1/email-agents`\",\"params\":[\"bodyParams\"]},{\"name\":\"listInboxes\",\"description\":\"List all inboxes with pagination and sorting.\\n\\nFor compatibility this endpoint is also available using the following (deprecated) paths:\\n`GET /v1/email-agents`\",\"params\":[\"queryParams\"]},{\"name\":\"updateInbox\",\"description\":\"Update an inbox's configuration.\\n\\nFor compatibility this endpoint is also available using the following (deprecated) paths:\\n`PATCH /v1/email-agents/{id}`\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"deleteInbox\",\"description\":\"Delete an inbox. The inbox stops routing new mail; existing email history is preserved.\",\"params\":[\"pathParams\"]},{\"name\":\"getEmail\",\"description\":\"Retrieve detailed information about a specific email, including full body content and the artifact IDs of its attachments.\",\"params\":[\"pathParams\"]},{\"name\":\"deleteEmail\",\"description\":\"Soft-delete an email. The message is hidden from all reads (get, list, and thread aggregation) but its content is retained until a separate hard purge.\",\"params\":[\"pathParams\"]},{\"name\":\"listEmails\",\"description\":\"List all emails with pagination and filtering.\\n\\n**Filtering:**\\n\\nFilter by email agent, sender, recipient, content search, or case.\",\"params\":[\"queryParams\"]},{\"name\":\"listEmailThreads\",\"description\":\"List email threads with pagination. Each thread includes the subject of the first email, the sender of the first email, and the date of the last email.\\n\\n**Filtering:**\\n\\nFilter by inbox or environment. Without an `environment` filter, live and test threads are returned together.\",\"params\":[\"queryParams\"]},{\"name\":\"replyToEmail\",\"description\":\"Reply to an existing email thread via Nylas. The reply is sent to the original sender by default.\\n\\nOptionally include additional recipients via `to` (merged with the original sender), `cc`, and `bcc` arrays.\\n\\nThe `body` is HTML by default. Set `is_html` to `false` to provide plain text instead; it is converted to HTML before sending.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"sendEmail\",\"description\":\"Send a new email through an inbox. The provider-assigned thread id is returned and persisted on the stored email row, so subsequent inbound replies on that thread are linked to this send.\\n\\nThe `body` is HTML by default. Set `is_html` to `false` to provide plain text instead; it is converted to HTML before sending.\",\"params\":[\"bodyParams\"]},{\"name\":\"listExtractorJobs\",\"description\":\"List all extraction jobs with pagination, filtering, and sorting.\\n\\n**Scope Filtering:**\\n\\nUse bracket notation to filter by scope keys:\\n- `scope[call_id]=abc-123`\\n- `scope[email_id]=xyz-456`\\n- `scope[case_id]=case-789`\\n\\nMultiple scope filters can be combined (AND logic).\",\"params\":[\"queryParams\"]},{\"name\":\"createExtractorJob\",\"description\":\"Create a new extraction job for the specified extractor.\\n\\nProvide a non-empty `scope` object to define what the extractor should process (e.g. `{ \\\"claim_id\\\": \\\"abc-123\\\" }`).\",\"params\":[\"bodyParams\"]},{\"name\":\"getExtractorJob\",\"description\":\"Retrieve detailed information about a specific extractor job, including its status, timing, and result.\",\"params\":[\"pathParams\"]},{\"name\":\"listWorkerRuns\",\"description\":\"List all worker runs with pagination, filtering, and sorting.\\n\\n**Scope Filtering:**\\n\\nUse bracket notation to filter by scope keys:\\n- `scope[call_id]=abc-123`\\n- `scope[email_id]=xyz-456`\\n\\nMultiple scope filters can be combined (AND logic).\",\"params\":[\"queryParams\"]},{\"name\":\"createWorkerRun\",\"description\":\"Create a new worker run for the specified worker.\\n\\nProvide a `scope` object with at least one key to define which artifacts the worker should process (e.g. `{ \\\"claim_id\\\": \\\"abc-123\\\" }`). The run stays `pending` until those artifacts are ready.\\n\\nPass `null` to run the worker without any artifacts — the run is queued immediately. An empty object, or a scope that matches no artifacts, is rejected.\",\"params\":[\"bodyParams\"]},{\"name\":\"getWorkerRun\",\"description\":\"Retrieve detailed information about a specific worker run, including its status, timing, and errors.\",\"params\":[\"pathParams\"]},{\"name\":\"listWorkerRunMessages\",\"description\":\"Retrieve messages emitted during a worker run, ordered by emission time. Supports cursor-style pagination via `after` and `count`.\",\"params\":[\"pathParams\",\"queryParams\"]},{\"name\":\"cancelWorkerRun\",\"description\":\"Cancel a worker run. For in_progress runs, the underlying E2B sandbox is terminated when possible. Pending and queued runs are simply marked canceled. Runs that are starting are still being handed their context and cannot be interrupted, so they cannot be canceled until they reach in_progress. Runs in terminal states (completed, failed) cannot be canceled. Already-canceled runs are returned without side effects.\",\"params\":[\"pathParams\"]},{\"name\":\"createWorkerEvalFromRun\",\"description\":\"Snapshot a worker run's trigger and resolved artifacts, and record its MCP tool responses from telemetry for replay. Each assertion is graded PASS/FAIL independently on every run.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"runEval\",\"description\":\"Queue an explicit worker version against the eval's immutable artifact snapshot and mocked tools.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"getEvalRun\",\"description\":\"Get the status and prompt-grader result for an eval run.\",\"params\":[\"pathParams\"]},{\"name\":\"createEvalBenchmark\",\"description\":\"Queue runs_per_configuration trials of the eval against a candidate and a baseline worker version. When all trials finish, the benchmark reports mean ± stddev pass rate per configuration, the candidate-minus-baseline delta, and analyzer notes.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"listEvalBenchmarks\",\"description\":\"Benchmark history of an eval (newest first by default) without per-run details. Use GET /v1/benchmarks/{benchmarkId} for the runs.\",\"params\":[\"pathParams\",\"queryParams\"]},{\"name\":\"getBenchmark\",\"description\":\"Get a benchmark with its per-run gradings and metrics, and once all runs finished, the per-configuration summary, delta, and analyzer notes.\",\"params\":[\"pathParams\"]},{\"name\":\"listWorkerEvals\",\"description\":\"List the evals recorded for a worker, newest first by default.\",\"params\":[\"pathParams\",\"queryParams\"]},{\"name\":\"createWorkerBenchmarks\",\"description\":\"Create one benchmark per eval of the worker, each queueing runs_per_configuration trials against the candidate and the baseline version. Poll each benchmark with GET /v1/benchmarks/{benchmarkId}.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"createExtractor\",\"description\":\"Create a new extractor with a name and JSON schema defining the extraction output format.\",\"params\":[\"bodyParams\"]},{\"name\":\"listExtractors\",\"description\":\"List all extractors with pagination, filtering, and sorting.\\n\\nFilter by name using the `name` query parameter.\",\"params\":[\"queryParams\"]},{\"name\":\"getExtractor\",\"description\":\"Retrieve a single extractor by ID, including its schema and version.\",\"params\":[\"pathParams\"]},{\"name\":\"updateExtractor\",\"description\":\"Update an extractor's schema. This creates a new version of the extractor.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"deleteExtractor\",\"description\":\"Soft-delete an extractor and all of its versions. Soft-deleted extractors no longer appear in any read.\",\"params\":[\"pathParams\"]},{\"name\":\"createWorker\",\"description\":\"Create a new worker with a name and prompt.\",\"params\":[\"bodyParams\"]},{\"name\":\"listWorkers\",\"description\":\"List all workers with pagination, filtering, and sorting.\\n\\nFilter by name using the `name` query parameter.\",\"params\":[\"queryParams\"]},{\"name\":\"getWorker\",\"description\":\"Retrieve a single worker by ID.\",\"params\":[\"pathParams\"]},{\"name\":\"deleteWorker\",\"description\":\"Delete a worker. The worker is hidden from all reads; its run history is preserved.\",\"params\":[\"pathParams\"]},{\"name\":\"updateWorker\",\"description\":\"Partially update a worker. Omitted fields are left unchanged, and one request creates at most one new config version.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"getWorkerPrompt\",\"description\":\"Retrieve the prompt for a worker. Pass `version` to fetch the prompt snapshot at a specific config version; omit it to fetch the current prompt. Internal use only.\",\"params\":[\"pathParams\",\"queryParams\"]},{\"name\":\"updateWorkerPrompt\",\"description\":\"Update the prompt for a worker. Internal use only.\\n\\n**Deprecated:** Use `PATCH /v1/workers/{workerId}` instead.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"listWorkerModels\",\"description\":\"List the LLM models that can be assigned to a worker via the `model` field on update.\",\"params\":[]},{\"name\":\"updateWorkerMcps\",\"description\":\"Replace the set of MCP servers a worker connects to. Pass an empty array to disconnect.\\n\\n**Deprecated:** Use `PATCH /v1/workers/{workerId}` instead.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"getAccess\",\"description\":\"List who an entity is shared with. Admins see every entity through their role, whether or not they are listed. Requires `workers:write` on a worker, `case-types:write` on a case type and `voice-agents:write` on a voice agent.\",\"params\":[\"pathParams\"]},{\"name\":\"changeAccess\",\"description\":\"Grant, change or revoke access for specific team members and workers. Everyone not named keeps their access. Each grantee must be a team member or a worker of the tenant. Requires `workers:write` on a worker, `case-types:write` on a case type and `voice-agents:write` on a voice agent. An editor who revokes their own grant loses access, and one who downgrades it can no longer change or share the entity, unless their role gives it.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"getMyAccess\",\"description\":\"List what the caller may do with an entity, through their role or a grant on it, to decide which controls to show. An entity the caller cannot see is not found.\",\"params\":[\"pathParams\"]},{\"name\":\"listWorkerVersions\",\"description\":\"List all config versions for a worker, ordered by version (newest first by default).\",\"params\":[\"pathParams\",\"queryParams\"]},{\"name\":\"getWorkerVersion\",\"description\":\"Retrieve a single worker config version, including the worker's identity, the config snapshot at that version, and version-specific metadata. The prompt is served separately by the worker prompt endpoint.\",\"params\":[\"pathParams\"]},{\"name\":\"promoteWorkerVersion\",\"description\":\"Select a worker configuration version for the live or test environment. This freezes the config snapshot only — the E2B template, attached tools and attached secrets are not versioned and always resolve to their current values.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"getWorkerVersionChangeSummary\",\"description\":\"Returns an AI-generated summary of what changed between this version and the previous one. Initial version returns an empty string since there is no predecessor.\",\"params\":[\"pathParams\"]},{\"name\":\"createWorkerWebhook\",\"description\":\"Create a webhook that fires when events occur for the specified worker.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"listWorkerWebhooks\",\"description\":\"List all webhooks configured for a specific worker.\",\"params\":[\"pathParams\",\"queryParams\"]},{\"name\":\"listCases\",\"description\":\"List all cases for the current tenant, paginated, filterable, and sortable.\",\"params\":[\"queryParams\"]},{\"name\":\"createCase\",\"description\":\"Create a case with a client-supplied id.\\n\\nCase ids are tenant-scoped opaque keys (e.g. \\\"clm-1\\\", \\\"STD-001\\\") and are normalized server-side (trimmed and lowercased). Creating an id that already exists **in the same environment** returns 409 — the same id can exist once in `live` and once in `test`.\",\"params\":[\"bodyParams\"]},{\"name\":\"searchCases\",\"description\":\"Probe for candidate cases. Matches the query as a normalized substring of the case id, and fuzzily (trigram) against subject and reporter. Results are relevance-ranked — id matches first, then best fuzzy match, then most recently updated — so ordering is fixed and not configurable.\",\"params\":[\"queryParams\"]},{\"name\":\"getCase\",\"description\":\"Retrieve a case by id, with its current fields.\\n\\nRelated entities are not embedded — fetch them via the filtered list endpoints,\\ne.g. `GET /v1/worker-runs?case_id=…` and `GET /v1/artifacts?metadata[case_id]=…`.\",\"params\":[\"pathParams\",\"queryParams\"]},{\"name\":\"deleteCase\",\"description\":\"Delete a case.\\n\\nThe case and its links stop being visible; the linked entities themselves are untouched. The id becomes available again — a case created with the same id afterwards is a new, empty case, not the deleted one.\\n\\nUnlike removing a case link, this is **not** idempotent: deleting a case that does not exist, or has already been deleted, returns 404.\",\"params\":[\"pathParams\",\"queryParams\"]},{\"name\":\"updateCase\",\"description\":\"Only the fields sent change.\",\"params\":[\"pathParams\",\"queryParams\",\"bodyParams\"]},{\"name\":\"getCaseCitations\",\"description\":\"Resolve the chunks cited by a case's current field values, keyed by chunk id.\\n\\nEach field in `GET /v1/cases/{id}` lists its citations as chunk ids; this endpoint\\nreturns the document, page, bounding box and text for each. Chunks whose document\\nwas deleted are omitted. A case with no cited fields returns an empty map.\",\"params\":[\"pathParams\",\"queryParams\"]},{\"name\":\"addCaseLinks\",\"description\":\"Link up to 100 entities (artifacts, calls, chats, emails, extracts, information requests, schedules, worker runs) to a case.\\n\\nThe case and every entity must already exist in the tenant — unknown ids return 404 and nothing is created. Calls, emails, information requests and worker runs must belong to the case's environment, and a schedule must run in it; artifacts, chats and extracts are not environment-scoped and can be linked to a case in either. A mismatch rejects the whole request. Adding is idempotent: re-linking an already linked entity returns the existing link with its original `created_at`.\",\"params\":[\"pathParams\",\"queryParams\",\"bodyParams\"]},{\"name\":\"listCaseLinks\",\"description\":\"List the entities linked to a case, paginated and filterable by entity type.\",\"params\":[\"pathParams\",\"queryParams\"]},{\"name\":\"removeCaseLink\",\"description\":\"Remove the link between a case and an entity. Removal is idempotent: removing a link that does not exist succeeds without effect.\",\"params\":[\"pathParams\",\"queryParams\"]},{\"name\":\"createChatAgent\",\"description\":\"Create a new chat agent with a name and prompt.\",\"params\":[\"bodyParams\"]},{\"name\":\"listChatAgents\",\"description\":\"List the tenant's chat agents with pagination and sorting. Prompts are not returned.\",\"params\":[\"queryParams\"]},{\"name\":\"getChatAgent\",\"description\":\"Retrieve a single chat agent by ID, including the IDs of its attached code tools. The prompt is not returned.\",\"params\":[\"pathParams\"]},{\"name\":\"updateChatAgent\",\"description\":\"Patch a chat agent's attached code tool set and evaluator. The response does not include the resulting tool list; the agent's `updated_at` is not bumped when only the tool set changes.\\n\\nSet `evaluator_slug` to score the agent's chats with that evaluator when they end. It applies to every chat that ends afterwards.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"deleteChatAgent\",\"description\":\"Soft-delete a chat agent. The agent no longer appears in any read and stops accepting new chats; existing chats and messages are preserved.\",\"params\":[\"pathParams\"]},{\"name\":\"getChatAgentPrompt\",\"description\":\"Retrieve the prompt and greeting for a chat agent. Internal use only.\",\"params\":[\"pathParams\"]},{\"name\":\"updateChatAgentPrompt\",\"description\":\"Update the prompt and/or greeting for a chat agent. Internal use only.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"createChat\",\"description\":\"Create a new chat against an existing chat agent. The chat agent's tenant becomes the owner of the chat. If the agent requires authentication (`identity_provider_id` on the public chat agent), send the identity token from `POST /public/v1/identity/token` in the `X-External-Identity-Token` header; without a valid token the request fails with 401.\",\"params\":[\"bodyParams\"]},{\"name\":\"getChat\",\"description\":\"Return a chat and its messages in chronological order. Used to re-render a transcript after a reload. Only `user` and `assistant` messages are included; tool calls and tool results are omitted. Each message's `content` is the concatenation of its text blocks separated by newlines.\\n\\nFor compatibility this endpoint is also available using the following (deprecated) paths:\\n`GET /public/v1/chat`\",\"params\":[\"pathParams\"]},{\"name\":\"getPublicChatAgent\",\"description\":\"Return the public-facing fields of a chat agent for use in the chat UI. Sensitive fields such as the agent's prompt and tenant ID are not exposed.\",\"params\":[\"pathParams\"]},{\"name\":\"postChatMessage\",\"description\":\"Post a user message to an existing chat and return the assistant reply. Both messages are persisted.\\n\\nFor compatibility this endpoint is also available using the following (deprecated) paths:\\n`POST /public/v1/chat/messages`\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"endChat\",\"description\":\"End a chat. Further messages are rejected with `409`. Ending an ended chat also returns `204`.\",\"params\":[]},{\"name\":\"exchangeExternalIdentityToken\",\"description\":\"Redeem a single-use interclient token from a partner identity provider for a short-lived Avallon identity token. A malformed request body returns 400. A rejected exchange returns 401; the interclient token may already be spent, so request a fresh one before retrying.\",\"params\":[\"bodyParams\"]},{\"name\":\"listChats\",\"description\":\"List the tenant's chats with pagination, sorting, and optional filtering by case. Returns chat metadata, message counts and evaluation outcome; messages are not included.\",\"params\":[\"queryParams\"]},{\"name\":\"listChatMessages\",\"description\":\"List messages for a chat owned by the tenant, in chronological order by default.\",\"params\":[\"pathParams\",\"queryParams\"]},{\"name\":\"getChatEvaluation\",\"description\":\"Retrieve the evaluation results for a chat, including overall score, pass status, and per-metric breakdowns.\",\"params\":[\"pathParams\"]},{\"name\":\"getPublicFormSubmission\",\"description\":\"Return the title and JSON Schema of the form version a submission link is pinned to, for the form renderer. The id and the password set on create are the credential; an unknown id is 404 and a wrong password, or a link created without one, is 401. Once the request has been submitted the request fails with 409 and `{ title }`.\",\"params\":[\"pathParams\",\"queryParams\"]},{\"name\":\"submitFormSubmission\",\"description\":\"Store the answers for a submission link and hand them to the form's processor. Each link can be submitted once: a second submit fails with 409. The id and the password set on create are the credential; an unknown id is 404 and a wrong password, or a link created without one, is 401.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"getPublicFormSubmissionTheme\",\"description\":\"Return the form title and the name and branding of the tenant a submission link belongs to, so the form renderer can style the page before the password is entered. Needs no password; an unknown id is 404.\",\"params\":[\"pathParams\"]},{\"name\":\"createForm\",\"description\":\"Create a form. Its schema becomes version 1, used by both live and test. The schema is validated against the renderer subset; violations are reported as 400 with the offending field path.\",\"params\":[\"bodyParams\"]},{\"name\":\"listForms\",\"description\":\"List the forms shared with the caller, each at its latest version.\",\"params\":[\"queryParams\"]},{\"name\":\"getForm\",\"description\":\"Retrieve a form at its latest version.\",\"params\":[\"pathParams\"]},{\"name\":\"updateForm\",\"description\":\"Partially update a form. Omitted fields are left unchanged, and one request creates at most one new version — none when nothing changed. Live and test keep pointing at their versions until promoted.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"listFormVersions\",\"description\":\"List a form's versions without their schemas, newest first by default. Fetch a version's schema with the form version endpoint.\",\"params\":[\"pathParams\",\"queryParams\"]},{\"name\":\"getFormVersion\",\"description\":\"Retrieve a form at the given version, including that version's schema.\",\"params\":[\"pathParams\"]},{\"name\":\"promoteFormVersion\",\"description\":\"Point the live or test environment at an existing form version. New submission links for that environment are pinned to it; open links keep their version.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"createFormSubmission\",\"description\":\"Open a submission link for a form, pinned to the version the given environment points at. Send the returned url and the password to the person filling the form.\",\"params\":[\"bodyParams\"]},{\"name\":\"listFormSubmissions\",\"description\":\"List the submission links of the forms shared with the caller, with the answers of those already submitted.\",\"params\":[\"queryParams\"]},{\"name\":\"getFormSubmission\",\"description\":\"Retrieve a submission link and, once it was submitted, the answers. Used by the form's worker and the studio; respondents use the public endpoint instead.\",\"params\":[\"pathParams\"]},{\"name\":\"getExtract\",\"description\":\"Retrieve a single extract by ID, including the extraction result data.\",\"params\":[\"pathParams\"]},{\"name\":\"getExtractCitations\",\"description\":\"Retrieve the citation tree with resolved chunk data for a given extract. Returns 404 if the extract does not exist or has no citations (the citations sub-resource is not available).\",\"params\":[\"pathParams\"]},{\"name\":\"listExtracts\",\"description\":\"List all extracts with pagination, filtering, and sorting.\\n\\n**Scope Filtering:**\\n\\nUse bracket notation to filter by scope keys:\\n- `scope[claim_id]=abc-123`\\n\\nMultiple scope filters can be combined (AND logic).\",\"params\":[\"queryParams\"]},{\"name\":\"getProfile\",\"description\":\"Retrieve the current user's profile information. This endpoint requires a user session and cannot be used with API Keys.\",\"params\":[]},{\"name\":\"listTeamMembers\",\"description\":\"List all members in the current tenant.\",\"params\":[]},{\"name\":\"inviteTeamMember\",\"description\":\"Invite an email address to join the current tenant. The invitee receives an email and joins at the `member` role once they accept; promote them afterwards with `PATCH /v1/team/members/{id}`.\\n\\nRequires the `teams:write` permission.\\n\\nReturns `409` if the address already has a pending invitation or is already a member.\",\"params\":[\"bodyParams\"]},{\"name\":\"listTeamInvitations\",\"description\":\"List the invitations for the current tenant that are still awaiting acceptance. Accepted, revoked and expired invitations are not returned.\\n\\nInvitees are not team members yet, so they do not appear in `GET /v1/team/members`. A member-management screen shows both by merging the two lists.\\n\\nRequires the `teams:write` permission.\",\"params\":[]},{\"name\":\"revokeTeamInvitation\",\"description\":\"Cancel a pending invitation. The link that was emailed to the invitee stops working, and the address becomes free to invite again.\\n\\nIdempotent: an invitation that was already accepted, revoked or expired also returns `204`.\\n\\nRequires the `teams:write` permission.\\n\\nReturns `404` for an unknown invitation or one that belongs to another tenant.\",\"params\":[\"pathParams\"]},{\"name\":\"resendTeamInvitation\",\"description\":\"Email the invitation to its recipient again, for an invite that never arrived. The invitation keeps its `id` and its original expiry — this re-sends the existing link rather than issuing a new one.\\n\\nTo give someone a genuinely fresh 5 days, revoke the invitation and send a new one instead.\\n\\nRequires the `teams:write` permission.\\n\\nReturns `409` if the invitation is no longer pending — it was accepted, revoked or expired underneath the caller — and `404` for an unknown invitation or one that belongs to another tenant.\",\"params\":[\"pathParams\"]},{\"name\":\"updateMemberRole\",\"description\":\"Change the role of a team member.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"removeMember\",\"description\":\"Soft-delete a team member, revoking access on the next token refresh.\",\"params\":[\"pathParams\"]},{\"name\":\"getTenantSettings\",\"description\":\"Retrieve the settings of the current tenant.\",\"params\":[]},{\"name\":\"updateTenantSettings\",\"description\":\"Update settings of the current tenant. Requires the `tenants:write` permission, which only Avallon admins hold.\",\"params\":[\"bodyParams\"]},{\"name\":\"createSecret\",\"description\":\"Create an organization-level secret. The value is encrypted at rest and **write-only** — no endpoint ever returns it.\\n\\nRequires the `secrets:write` permission. Env keys used by the worker runtime itself (e.g. `OPENAI_API_KEY`, `AVALLON_*`, `AWS_*`) are reserved and rejected.\",\"params\":[\"bodyParams\"]},{\"name\":\"listSecrets\",\"description\":\"List the organization's secrets with pagination and sorting. Values are never included. Requires the `secrets:read` permission.\",\"params\":[\"queryParams\"]},{\"name\":\"getSecret\",\"description\":\"Get a secret's metadata. The value is never included. Requires the `secrets:read` permission.\",\"params\":[\"pathParams\"]},{\"name\":\"updateSecret\",\"description\":\"Update a secret's display name or description, or rotate its live or test value. Rotation overwrites the stored value — previous values are not retrievable.\\n\\nThe `env_key` is immutable: consumers of the secret receive the value under that key, so changing it would silently break them. Create a new secret instead.\\n\\nRequires the `secrets:write` permission.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"deleteSecret\",\"description\":\"Delete a secret and detach it from all entities. Requires the `secrets:write` permission.\",\"params\":[\"pathParams\"]},{\"name\":\"createEvaluator\",\"description\":\"Create an evaluator: a named set of metrics that an LLM judge scores every call or chat of the agents it is attached to.\\n\\nEvaluators can't be changed after creation, so past scores keep their meaning. To change the criteria, create a new evaluator (e.g. `support-quality-v2`) and attach that instead. A slug that already exists returns 409.\\n\\nAttach it to a voice agent with `PATCH /v1/voice-agents/{voiceAgentId}` (`evaluator_slug`), then promote that version, or to a chat agent with `PATCH /v1/chat-agents/{chatAgentId}` (`evaluator_slug`). Requires the `evaluators:write` permission.\",\"params\":[\"bodyParams\"]},{\"name\":\"listEvaluators\",\"description\":\"List all evaluators of the tenant with their metrics.\",\"params\":[]},{\"name\":\"getEvaluator\",\"description\":\"Retrieve an evaluator and the metrics its judge scores.\",\"params\":[\"pathParams\"]},{\"name\":\"createSchedule\",\"description\":\"Create a schedule that performs an action, either repeatedly or once.\\n\\n`action` describes **what** happens: `trigger_worker` starts a worker run with the given scope, and `execute_tool` executes a tool without parameters. `rule` describes **when**: `recurring` carries one or more `patterns`, and fires whenever any of them comes round. A pattern fires every hour at `minute`, narrowed by `hours` and `weekdays` — so `hours: [9]` is daily at 09:00, `hours: [12], weekdays: [1]` is Mondays at noon, and `hours: [9, 13, 17], weekdays: [1, 2, 3, 4, 5]` is three times a day on weekdays. Give a second pattern to mix cadences: hourly on weekdays plus 09:00, 11:00 and 18:00 at weekends is two patterns on one schedule. Patterns overlap harmlessly — two that land on the same minute fire once. Every set is read in the schedule's own time zone — an IANA identifier such as `America/Chicago`, resolved across DST transitions. `once` fires a single time at a UTC instant.\\n\\n`environments` says **which version** of the worker or tool each occurrence runs: `live` resolves it at its live version, `test` at its test version. Give both to soak a candidate version on the same cadence as production — every occurrence then fires twice, once per environment. Omit it to fire in `live` only.\\n\\nThe response's `next_run_at` is the first occurrence strictly after the moment of creation; a rule that resolves to no such occurrence is rejected. Create with `enabled: false` to stage a recurring schedule without letting it fire. A one-off is always enabled: delete it to cancel it, and its `next_run_at` becomes null once it has fired.\\n\\nRequires the `schedules:write` permission, and `tools:execute` for an `execute_tool` action.\",\"params\":[\"bodyParams\"]},{\"name\":\"listSchedules\",\"description\":\"List the organization's schedules. Requires the `schedules:read` permission.\",\"params\":[\"queryParams\"]},{\"name\":\"getSchedule\",\"description\":\"Retrieve a single schedule. Requires the `schedules:read` permission.\",\"params\":[\"pathParams\"]},{\"name\":\"updateSchedule\",\"description\":\"Update a schedule's rule, environments, name, or enabled state.\\n\\nChanging the rule moves `next_run_at` to the first occurrence after the update; a rule that resolves to no such occurrence is rejected. One-off schedules are always enabled — delete one to cancel it before it fires.\\n\\n`environments` replaces the whole list rather than adding to it. It takes effect from the next occurrence: one already due keeps the environments it was created with.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"deleteSchedule\",\"description\":\"Delete a schedule so it stops firing.\",\"params\":[\"pathParams\"]},{\"name\":\"listDispatches\",\"description\":\"List the organization's dispatches, newest occurrence first.\\n\\nA dispatch is one occurrence of a trigger in one environment, carried out on its own: a schedule produces one per environment it runs in every time it fires, an inbound email produces one for the environment its inbox received it in, a resolved information request produces one that restarts the worker that asked, an ended call produces one that runs its voice agent's post-call processor once its transcript is ready, and creating a worker run through the API produces a `manual` one, carried out before the request returns. Listing them shows what a trigger has actually done, including occurrences that never produced anything.\\n\\n- `pending` — not carried out yet: waiting to be picked up, in flight, or waiting on a retry after an earlier pickup did not complete.\\n- `dispatched` — carried out.\\n- `abandoned` — gave up, because the occurrence passed its `expires_at` deadline before it could be carried out, or, for a `manual` dispatch, because the request that created it failed.\\n\\n`attempts` counts how many times the occurrence has been picked up, not how many times it failed: a dispatch carried out on the first pickup ends at `attempts: 1`, and a higher count means earlier pickups did not complete.\\n\\n`target` is what the occurrence produced: a worker run, an extractor job (for an email whose inbox extracts or a call whose voice agent extracts), or a tool call (for an `execute_tool` schedule). It is null until the dispatch is carried out, and for a tool call until the tool has run.\\n\\nNarrow to one trigger with `trigger_type` and `trigger_id` — the schedule's ID for a schedule, the email's ID for an email, the request's ID for an information request, the call's ID for a call. `trigger_id` requires `trigger_type`.\",\"params\":[\"queryParams\"]},{\"name\":\"listNotifications\",\"description\":\"List the organization's notifications, newest first.\\n\\nA notification is a durable record that something happened and that somebody should know about it. Notifications are not yet addressed to individual people, so everyone in the organization sees the same feed.\\n\\n`title` and `body` are the display text — render them as-is rather than deriving your own wording from `type`, so every surface says the same thing. `data` carries the identifiers the notification points at, so a client can link to the thing it is about; which keys are present depends on `type`.\\n\\n`worker_issue_reported` means a worker hit a problem during a run and reported it; its `body` is the worker's own message and its `data` is the reporting `worker_id` and `run_id`. `information_request_created` means a worker paused to ask a person a question; its `data` is the `request_id` to answer through `POST /v1/information-requests/{informationRequestId}/resolve`.\",\"params\":[\"queryParams\"]},{\"name\":\"getNotification\",\"description\":\"Retrieve a single notification by its ID, the id a `notification.created` webhook delivery carries.\\n\\n`title` and `body` are the display text — render them as-is rather than deriving your own wording from `type`, so every surface says the same thing. `data` carries the identifiers the notification points at, so a client can link to the thing it is about; which keys are present depends on `type`.\\n\\n`worker_issue_reported` means a worker hit a problem during a run and reported it; its `body` is the worker's own message and its `data` is the reporting `worker_id` and `run_id`. `information_request_created` means a worker paused to ask a person a question; its `data` is the `request_id` to answer through `POST /v1/information-requests/{informationRequestId}/resolve`.\",\"params\":[\"pathParams\"]},{\"name\":\"createInformationRequest\",\"description\":\"Ask a person for a specific fact you cannot establish yourself.\\n\\nUse this when one missing piece of information is blocking you and only a human can supply it — which claim a document belongs to, which of two policies applies, what an ambiguous reference means. Ask one answerable question per request, and write it so it stands on its own: whoever resolves it sees your title and your question and nothing else.\\n\\nImmediately link the request to its case with `addCaseLinks` and `entity_type: \\\"information_request\\\"`. That is how it reaches the person working that case; unlinked, it sits in a queue nobody is looking at. Leave it unlinked only when you genuinely cannot tell which case it belongs to.\\n\\n**This does not block or suspend you.** Nobody resolves it while this run is happening. Carry on with what you can still do, or stop, and say in your final report that you asked.\\n\\nDo not use it for progress updates, or for anything you can work out yourself.\",\"params\":[\"bodyParams\"]},{\"name\":\"listInformationRequests\",\"description\":\"List the organization's information requests, newest first.\\n\\nAn information request is a specific question a worker could not settle on its own and needs a person to resolve. It stays open until somebody resolves it; there is no separate status field.\",\"params\":[\"queryParams\"]},{\"name\":\"getInformationRequest\",\"description\":\"Retrieve a single information request by its ID.\",\"params\":[\"pathParams\"]},{\"name\":\"deleteInformationRequest\",\"description\":\"Delete an information request, open or resolved..\",\"params\":[\"pathParams\"]},{\"name\":\"resolveInformationRequest\",\"description\":\"Resolve an open information request by providing an answer/resolution.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"createCaseType\",\"description\":\"Create a case type. Its fields become version 1, used by both live and test.\",\"params\":[\"bodyParams\"]},{\"name\":\"listCaseTypes\",\"description\":\"List the organization's case types, without their fields.\",\"params\":[\"queryParams\"]},{\"name\":\"getCaseType\",\"description\":\"Retrieve a case type with its fields at the newest version. Inside a worker run, returns the version the run's environment points at.\",\"params\":[\"pathParams\"]},{\"name\":\"updateCaseType\",\"description\":\"Update a case type. Its fields are changed through `/v1/case-types/{caseTypeSlug}/fields`.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"listCaseTypeVersions\",\"description\":\"List a case type's versions, newest first by default.\",\"params\":[\"pathParams\",\"queryParams\"]},{\"name\":\"getCaseTypeVersion\",\"description\":\"Retrieve a case type with its fields at a specific version.\",\"params\":[\"pathParams\"]},{\"name\":\"promoteCaseTypeVersion\",\"description\":\"Point the live or test environment at a version. Any existing version can be promoted, including an older one.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"createCaseTypeField\",\"description\":\"Add a field to a case type. Creates a new version; promote it to use the field.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"updateCaseTypeField\",\"description\":\"Change a field's label, description, nullability, enum or sensitivity. Creates a new version when something changes; promote it to use the change. A field's key, type, list-ness and parent are permanent.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"deleteCaseTypeField\",\"description\":\"Remove a field from a case type. Creates a new version; once it is promoted, the field can't be written. Deleting an object deletes its fields with it. Cases keep their values, and the key can't be reused.\",\"params\":[\"pathParams\"]},{\"name\":\"createTool\",\"description\":\"Create a new code tool that can be attached to agents. Provide the tool's name, code, and description.\",\"params\":[\"bodyParams\"]},{\"name\":\"listTools\",\"description\":\"List all code tools with sorting.\\n\\nFor compatibility this endpoint is also available using the following (deprecated) paths:\\n`GET /worker/v1/tools`\",\"params\":[\"queryParams\"]},{\"name\":\"deleteTool\",\"description\":\"Delete a tool. Fails with a conflict when the tool is still attached to a voice agent, worker, or chat agent; detach it first.\",\"params\":[\"pathParams\"]},{\"name\":\"getTool\",\"description\":\"Retrieve a single tool by ID at its newest config version, including its code, schema, description and attached secrets, plus the versions each environment runs.\\n\\nFor compatibility this endpoint is also available using the following (deprecated) paths:\\n`GET /worker/v1/tools/{id}`\",\"params\":[\"pathParams\"]},{\"name\":\"updateTool\",\"description\":\"Update a code tool's name, description, code, or attached secrets. All fields are optional — only provided fields are updated.\\n\\nChanging the code, description or attached secrets creates a new config version; runs keep executing the versions promoted to live and test until that version is promoted. Renaming does not create a version.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"executeCode\",\"description\":\"Execute a code tool with the given parameters. Returns the result, any errors, and execution traces.\\n\\nFor compatibility this endpoint is also available using the following (deprecated) paths:\\n`POST /worker/v1/tools/{id}/execute`\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"listToolVersions\",\"description\":\"List all config versions for a tool, ordered by version (newest first by default).\",\"params\":[\"pathParams\",\"queryParams\"]},{\"name\":\"getToolVersion\",\"description\":\"Retrieve a single tool config version: the tool's identity, the code, schema, description and attached secrets at that version, and version metadata.\",\"params\":[\"pathParams\"]},{\"name\":\"promoteToolVersion\",\"description\":\"Select a tool config version for the live or test environment. Runs in that environment execute this version's code with this version's schema and attached secrets from then on.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"getToolVersionChangeSummary\",\"description\":\"Returns an AI-generated summary of what changed between this version and the previous one. Initial version returns an empty string since there is no predecessor.\",\"params\":[\"pathParams\"]},{\"name\":\"listToolCalls\",\"description\":\"List tool calls without their params, result, error and traces. Requires the `tool-calls:read` permission.\",\"params\":[\"queryParams\"]},{\"name\":\"getToolCall\",\"description\":\"Retrieve a single tool call. Requires the `tool-calls:read` permission.\",\"params\":[\"pathParams\"]},{\"name\":\"workerListTools\",\"description\":\"List all code tools with sorting.\",\"params\":[\"queryParams\"]},{\"name\":\"workerGetTool\",\"description\":\"Retrieve a single tool by ID at its newest config version, including its code, schema, description and attached secrets, plus the versions each environment runs.\",\"params\":[\"pathParams\"]},{\"name\":\"workerExecuteTool\",\"description\":\"Execute a code tool with the given parameters. Returns the result, any errors, and execution traces.\",\"params\":[\"pathParams\",\"bodyParams\"]},{\"name\":\"notifyAdmin\",\"description\":\"Report a problem to the people who run this organization.\\n\\nUse this for something a human has to resolve — a login that no longer works, a document you cannot read, a system that will not let you in, instructions that contradict what you found. The report goes to the organization's notifications; nobody sees it while the run is happening, so it does not unblock you now. Carry on with what you can still do, or stop, and say in your final report that you raised it.\\n\\nDo not use it for progress updates or for anything you can work around yourself.\",\"params\":[\"bodyParams\"]},{\"name\":\"uploadFile\",\"description\":\"Upload a file for processing by passing a URL to a file. Use this for uploading larger files.\\n\\nThis endpoint returns an upload id that can be used to find the created artifacts using the list artifacts endpoint.\",\"params\":[\"bodyParams\"]}],\"toolsHash\":\"ab7c41eca1eb30d2f91b45df61574c47cfa905da0218561689db83f5dab4781a\",\"wrote\":[],\"callsAt\":\"2026-11-16T11:27:47.165Z\",\"calls\":[{\"tool\":\"listWorkerModels\",\"ok\":false,\"ms\":4593,\"bytes\":0,\"error\":\"tool reported an error: Avallon API error 401: missing authentication credentials. Provide either Authorization header (JWT) or x-api-key header is not authorized\"},{\"tool\":\"getProfile\",\"ok\":false,\"ms\":117,\"bytes\":0,\"error\":\"tool reported an error: Avallon API error 401: missing authentication credentials. Provide either Authorization header (JWT) or x-api-key header is not authorized\"},{\"tool\":\"listTeamMembers\",\"ok\":false,\"ms\":4391,\"bytes\":0,\"error\":\"tool reported an error: Avallon API error 401: missing authentication credentials. Provide either Authorization header (JWT) or x-api-key header is not authorized\"},{\"tool\":\"getTenantSettings\",\"ok\":false,\"ms\":4572,\"bytes\":0,\"error\":\"tool reported an error: Avallon API error 401: missing authentication credentials. Provide either Authorization header (JWT) or x-api-key header is not authorized\"},{\"tool\":\"listEvaluators\",\"ok\":false,\"ms\":4442,\"bytes\":0,\"error\":\"tool reported an error: Avallon API error 401: missing authentication credentials. Provide either Authorization header (JWT) or x-api-key header is not authorized\"}],\"host\":{\"commit\":\"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c\",\"run\":\"https://github.com/itsHaddad/bragproof/actions/runs/43857070216\"},\"network\":{\"names\":[\"registry.npmjs.org\"],\"conns\":[],\"callNames\":[\"api.avallon.ai\"],\"callConns\":[]}}","token":"eyJhbGciOiJSUzI1NiIsImtpZCI6IjM4ODI2YjE3LTZhMzAtNWY5Yi1iMTY5LThiZWI4MjAyZjcyMyIsInR5cCI6IkpXVCIsIng1dCI6InlrTmFZNHFNX3RhNGsyVGdaT0NFWUxrY1lsQSJ9.eyJhY3RvciI6Iml0c0hhZGRhZCIsImFjdG9yX2lkIjoiMTE0NzMyNjEiLCJhdWQiOiJicmFncHJvb2YtcmVwb3J0OmMwMjEzNTdjNGEyYzg4NTBiZjE0ZGI2ODI3ZGU1NjNjZmFkZTgyOGE4ZDEyMDllMmZjOTNjZDNkZmQxMTU4ZjIiLCJiYXNlX3JlZiI6IiIsImNoZWNrX3J1bl9pZCI6IjEzMzI2Mzk5NTQyOCIsImV2ZW50X25hbWUiOiJzY2hlZHVsZSIsImV4cCI6MTc5NDgyODc5MSwiaGVhZF9yZWYiOiIiLCJpYXQiOjE3OTQ4Mjg0OTEsImlzcyI6Imh0dHBzOi8vdG9rZW4uYWN0aW9ucy5naXRodWJ1c2VyY29udGVudC5jb20iLCJqb2Jfd29ya2Zsb3dfcmVmIjoiaXRzSGFkZGFkL2JyYWdwcm9vZi8uZ2l0aHViL3dvcmtmbG93cy9yZXBvcnQueW1sQHJlZnMvaGVhZHMvbWFpbiIsImpvYl93b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIiwianRpIjoiZTA4YWU2ZTMtOGY0My00NTg3LWEyMzMtZGQ3ZmE0NTEwZTA4IiwibmJmIjoxNzk0ODI4MTkxLCJyZWYiOiJyZWZzL2hlYWRzL21haW4iLCJyZWZfcHJvdGVjdGVkIjoiZmFsc2UiLCJyZWZfdHlwZSI6ImJyYW5jaCIsInJlcG9zaXRvcnkiOiJpdHNIYWRkYWQvYnJhZ3Byb29mIiwicmVwb3NpdG9yeV9pZCI6IjE0NTQ2MjExODMiLCJyZXBvc2l0b3J5X293bmVyIjoiaXRzSGFkZGFkIiwicmVwb3NpdG9yeV9vd25lcl9pZCI6IjExNDczMjYxIiwicmVwb3NpdG9yeV92aXNpYmlsaXR5IjoicHVibGljIiwicnVuX2F0dGVtcHQiOiIxIiwicnVuX2lkIjoiNDM4NTcwNzAyMTYiLCJydW5fbnVtYmVyIjoiMjQiLCJydW5uZXJfZW52aXJvbm1lbnQiOiJnaXRodWItaG9zdGVkIiwic2hhIjoiZWFhZmZmZmFmNTIyNTVkMWI3N2RjNGFhY2ZmZGZhZjM1M2YwYzEyYyIsInN1YiI6InJlcG86aXRzSGFkZGFkQDExNDczMjYxL2JyYWdwcm9vZkAxNDU0NjIxMTgzOnJlZjpyZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvdyI6InJlcG9ydCIsIndvcmtmbG93X3JlZiI6Iml0c0hhZGRhZC9icmFncHJvb2YvLmdpdGh1Yi93b3JrZmxvd3MvcmVwb3J0LnltbEByZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIn0.O6wO-hzlEGHCq1OX6R10U_0ExL6V3RxSNZlnKfZTjJPvY-sEOZeKyBCR5Ao6aayQfnxtOVTv6NLUJuUbrSihF1sY2yT-ZSv2CrUesDLSu39KATwyZO80X1kbkYM5uSDLyG2DUxG7B2TWZ3N8Y4Bn3JCQGhjtxlkR1PV05JV3UFOKjsX2vQHTQi0lalUwjzDK-98SL-akVRn8pzQEgLHL7r_c2hTVAIEbFgaDHSx9vJXU5ZkoXKD1W_ry6PrdvtNb3ZG6hX-z0FL2CjjQJuH0YagWzM_lURPR4D6hqLcZHXe2d_KeWmJlEcVh-SvcVr2zfrZPG49QgGA9y6hXrVGHyQ"}