{"openapi":"3.1.0","info":{"title":"Bird (BYOK) API","version":"0.1.0","description":"Bird (BYOK) lets an AI assistant read your own Bird data through the Bird API with a key you supply (Bird workspace API key (bk_...)). Read-only: 12 tools (get_workspace, list_whatsapp_numbers, list_whatsapp_number_events, list_whatsapp_business_accounts, list_whatsapp_templates, get_whatsapp_template, get_whatsapp_stats_summary, get_whatsapp_stats_daily, get_whatsapp_stats_by_template,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-bird-messaging.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-bird-messaging/docs"},"termsOfService":"https://connectorbay.com/byok-bird-messaging/terms"},"servers":[{"url":"https://byok-bird-messaging.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-bird-messaging/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_workspace":{"post":{"operationId":"get_workspace","summary":"Show the Bird workspace the key belongs to: id, organization id, name and creation time. Use for \"Which Bird workspace i","description":"Show the Bird workspace the key belongs to: id, organization id, name and creation time. Use for \"Which Bird workspace is this API key for\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Region your Bird organization is hosted in: us1 or eu1 (the key prefix bk_us1_ or bk_eu1_ shows it).","enum":["us1","eu1"],"title":"Region","type":"string"}},"required":["region"],"title":"get_workspaceArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_whatsapp_numbers":{"post":{"operationId":"list_whatsapp_numbers","summary":"List WhatsApp business numbers with connection status, quality rating, messaging limit tier, throughput level and offici","description":"List WhatsApp business numbers with connection status, quality rating, messaging limit tier, throughput level and official-account flag. Use for \"What is the quality rating and messaging limit of my WhatsApp numbers on Bird\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Region your Bird organization is hosted in: us1 or eu1 (the key prefix bk_us1_ or bk_eu1_ shows it).","enum":["us1","eu1"],"title":"Region","type":"string"},"waba":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only numbers of this WhatsApp Business Account (Meta WABA id).","title":"Waba"},"phone_number":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only this number, in E.164 form such as +919876543210.","title":"Phone Number"},"scope":{"anyOf":[{"enum":["system","workspace"],"type":"string"},{"type":"null"}],"default":null,"description":"system for platform-managed numbers, workspace for your own.","title":"Scope"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many items to return (1 to 100).","title":"Limit"},"starting_after":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor: the next_cursor value of the previous answer (leave empty for the first page).","title":"Starting After"}},"required":["region"],"title":"list_whatsapp_numbersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_whatsapp_number_events":{"post":{"operationId":"list_whatsapp_number_events","summary":"List the status-change events of one WhatsApp number (for example quality or limit changes), newest first: type, summary","description":"List the status-change events of one WhatsApp number (for example quality or limit changes), newest first: type, summary and time. Use for \"What changed recently on my WhatsApp number wan_1 in Bird\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Region your Bird organization is hosted in: us1 or eu1 (the key prefix bk_us1_ or bk_eu1_ shows it).","enum":["us1","eu1"],"title":"Region","type":"string"},"number_id":{"description":"WhatsApp number id with the wan_ prefix (from list_whatsapp_numbers).","maxLength":60,"title":"Number Id","type":"string"},"order":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":"desc","description":"Sort direction by creation time.","title":"Order"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many items to return (1 to 100).","title":"Limit"},"starting_after":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor: the next_cursor value of the previous answer (leave empty for the first page).","title":"Starting After"}},"required":["region","number_id"],"title":"list_whatsapp_number_eventsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_whatsapp_business_accounts":{"post":{"operationId":"list_whatsapp_business_accounts","summary":"List connected WhatsApp Business Accounts with status, account review status, business verification status and Meta heal","description":"List connected WhatsApp Business Accounts with status, account review status, business verification status and Meta health. Use for \"Are my WhatsApp Business Accounts on Bird verified and healthy\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Region your Bird organization is hosted in: us1 or eu1 (the key prefix bk_us1_ or bk_eu1_ shows it).","enum":["us1","eu1"],"title":"Region","type":"string"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many items to return (1 to 100).","title":"Limit"},"starting_after":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor: the next_cursor value of the previous answer (leave empty for the first page).","title":"Starting After"}},"required":["region"],"title":"list_whatsapp_business_accountsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_whatsapp_templates":{"post":{"operationId":"list_whatsapp_templates","summary":"List WhatsApp message templates with category, approval status, default language and available languages. Template body ","description":"List WhatsApp message templates with category, approval status, default language and available languages. Template body text is not included in this list. Use for \"Which WhatsApp templates do I have on Bird and which are approved\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Region your Bird organization is hosted in: us1 or eu1 (the key prefix bk_us1_ or bk_eu1_ shows it).","enum":["us1","eu1"],"title":"Region","type":"string"},"waba":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only templates of this WhatsApp Business Account (Meta WABA id).","title":"Waba"},"scope":{"anyOf":[{"enum":["system","workspace"],"type":"string"},{"type":"null"}],"default":null,"description":"system for Bird's built-in catalog, workspace for your own templates.","title":"Scope"},"category":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only this template category, for example utility, marketing or authentication.","title":"Category"},"q":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Case-insensitive search across slug, name and description.","title":"Q"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many items to return (1 to 100).","title":"Limit"},"starting_after":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor: the next_cursor value of the previous answer (leave empty for the first page).","title":"Starting After"}},"required":["region"],"title":"list_whatsapp_templatesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_whatsapp_template":{"post":{"operationId":"get_whatsapp_template","summary":"Get one WhatsApp template by id or slug: category, status, default language, available languages and version ids. Use fo","description":"Get one WhatsApp template by id or slug: category, status, default language, available languages and version ids. Use for \"What is the approval status of the WhatsApp template order_shipped\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Region your Bird organization is hosted in: us1 or eu1 (the key prefix bk_us1_ or bk_eu1_ shows it).","enum":["us1","eu1"],"title":"Region","type":"string"},"template_ref":{"description":"Template id (wat_ prefix) or slug.","maxLength":100,"title":"Template Ref","type":"string"}},"required":["region","template_ref"],"title":"get_whatsapp_templateArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_whatsapp_stats_summary":{"post":{"operationId":"get_whatsapp_stats_summary","summary":"Get aggregate outbound WhatsApp counts and rates (accepted, sent, delivered, failed, rejected, delivery and failure rate","description":"Get aggregate outbound WhatsApp counts and rates (accepted, sent, delivered, failed, rejected, delivery and failure rate, read count) for a period. Use for \"How many of my WhatsApp messages on Bird were delivered and read this month\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Region your Bird organization is hosted in: us1 or eu1 (the key prefix bk_us1_ or bk_eu1_ shows it).","enum":["us1","eu1"],"title":"Region","type":"string"},"date_from":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"First day of the window, YYYY-MM-DD, counted in the timezone below (default: the service's default window).","title":"Date From"},"date_to":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Last day of the window (inclusive), YYYY-MM-DD.","title":"Date To"},"timezone":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"IANA timezone used to group the days, for example Asia/Kolkata (default UTC).","title":"Timezone"},"template":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only this template (id wat_... or slug).","title":"Template"},"category":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only this template category.","title":"Category"},"phone_number":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only this business sender number in E.164 form.","title":"Phone Number"}},"required":["region"],"title":"get_whatsapp_stats_summaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_whatsapp_stats_daily":{"post":{"operationId":"get_whatsapp_stats_daily","summary":"Get outbound WhatsApp delivery and read counts per day for a period. Use for \"Show my daily WhatsApp delivery counts on ","description":"Get outbound WhatsApp delivery and read counts per day for a period. Use for \"Show my daily WhatsApp delivery counts on Bird for the last two weeks\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Region your Bird organization is hosted in: us1 or eu1 (the key prefix bk_us1_ or bk_eu1_ shows it).","enum":["us1","eu1"],"title":"Region","type":"string"},"date_from":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"First day of the window, YYYY-MM-DD, counted in the timezone below (default: the service's default window).","title":"Date From"},"date_to":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Last day of the window (inclusive), YYYY-MM-DD.","title":"Date To"},"timezone":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"IANA timezone used to group the days, for example Asia/Kolkata (default UTC).","title":"Timezone"},"template":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only this template (id wat_... or slug).","title":"Template"},"category":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only this template category.","title":"Category"},"phone_number":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only this business sender number in E.164 form.","title":"Phone Number"}},"required":["region"],"title":"get_whatsapp_stats_dailyArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_whatsapp_stats_by_template":{"post":{"operationId":"get_whatsapp_stats_by_template","summary":"Get outbound WhatsApp statistics per template, ranked by accepted volume. Use for \"Which of my WhatsApp templates on Bir","description":"Get outbound WhatsApp statistics per template, ranked by accepted volume. Use for \"Which of my WhatsApp templates on Bird sent the most and failed the most\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Region your Bird organization is hosted in: us1 or eu1 (the key prefix bk_us1_ or bk_eu1_ shows it).","enum":["us1","eu1"],"title":"Region","type":"string"},"date_from":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"First day of the window, YYYY-MM-DD, counted in the timezone below (default: the service's default window).","title":"Date From"},"date_to":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Last day of the window (inclusive), YYYY-MM-DD.","title":"Date To"},"timezone":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"IANA timezone used to group the days, for example Asia/Kolkata (default UTC).","title":"Timezone"},"limit":{"anyOf":[{"maximum":200,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many templates to return (1 to 200).","title":"Limit"}},"required":["region"],"title":"get_whatsapp_stats_by_templateArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_whatsapp_stats_error_codes":{"post":{"operationId":"get_whatsapp_stats_error_codes","summary":"Get outbound WhatsApp failures grouped by error code, most frequent first. Use for \"Why are my WhatsApp messages failing","description":"Get outbound WhatsApp failures grouped by error code, most frequent first. Use for \"Why are my WhatsApp messages failing on Bird\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Region your Bird organization is hosted in: us1 or eu1 (the key prefix bk_us1_ or bk_eu1_ shows it).","enum":["us1","eu1"],"title":"Region","type":"string"},"date_from":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"First day of the window, YYYY-MM-DD, counted in the timezone below (default: the service's default window).","title":"Date From"},"date_to":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Last day of the window (inclusive), YYYY-MM-DD.","title":"Date To"},"timezone":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"IANA timezone used to group the days, for example Asia/Kolkata (default UTC).","title":"Timezone"},"limit":{"anyOf":[{"maximum":200,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many error codes to return (1 to 200).","title":"Limit"}},"required":["region"],"title":"get_whatsapp_stats_error_codesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_sms_stats_summary":{"post":{"operationId":"get_sms_stats_summary","summary":"Get aggregate outbound SMS counts and rates (accepted, sent, delivered, undelivered, failed, rejected, expired) for a pe","description":"Get aggregate outbound SMS counts and rates (accepted, sent, delivered, undelivered, failed, rejected, expired) for a period. Use for \"How did my SMS deliveries on Bird do this month\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Region your Bird organization is hosted in: us1 or eu1 (the key prefix bk_us1_ or bk_eu1_ shows it).","enum":["us1","eu1"],"title":"Region","type":"string"},"date_from":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"First day of the window, YYYY-MM-DD, counted in the timezone below (default: the service's default window).","title":"Date From"},"date_to":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Last day of the window (inclusive), YYYY-MM-DD.","title":"Date To"},"timezone":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"IANA timezone used to group the days, for example Asia/Kolkata (default UTC).","title":"Timezone"},"country":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"Only this destination country, ISO 3166-1 alpha-2 such as IN.","title":"Country"},"originator":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only this sender address.","title":"Originator"},"carrier":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only this delivery carrier.","title":"Carrier"}},"required":["region"],"title":"get_sms_stats_summaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_sms_templates":{"post":{"operationId":"list_sms_templates","summary":"List SMS templates with category, status, default language and available languages. Use for \"Which SMS templates do I ha","description":"List SMS templates with category, status, default language and available languages. Use for \"Which SMS templates do I have on Bird\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Region your Bird organization is hosted in: us1 or eu1 (the key prefix bk_us1_ or bk_eu1_ shows it).","enum":["us1","eu1"],"title":"Region","type":"string"},"scope":{"anyOf":[{"enum":["system","workspace"],"type":"string"},{"type":"null"}],"default":null,"description":"system for built-in templates, workspace for your own.","title":"Scope"},"category":{"anyOf":[{"enum":["transactional","marketing","authentication"],"type":"string"},{"type":"null"}],"default":null,"description":"Only this category.","title":"Category"},"status":{"anyOf":[{"enum":["draft","pending","active","rejected","inactive"],"type":"string"},{"type":"null"}],"default":null,"description":"Only templates in this lifecycle status.","title":"Status"},"q":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Case-insensitive search across slug, name and description.","title":"Q"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many items to return (1 to 100).","title":"Limit"},"starting_after":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor: the next_cursor value of the previous answer (leave empty for the first page).","title":"Starting After"}},"required":["region"],"title":"list_sms_templatesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}