{"id":"5e20cb68-26b9-43d2-8943-79e0f82740dd","shortId":"9GXanD","kind":"skill","title":"telnyx-account-ruby","tagline":">-","description":"<!-- Auto-generated from Telnyx OpenAPI specs. Do not edit. -->\n\n# Telnyx Account - Ruby\n\n## Installation\n\n```bash\ngem install telnyx\n```\n\n## Setup\n\n```ruby\nrequire \"telnyx\"\n\nclient = Telnyx::Client.new(\n  api_key: ENV[\"TELNYX_API_KEY\"], # This is the default and can be omitted\n)\n```\n\nAll examples below assume `client` is already initialized as shown above.\n\n## Error Handling\n\nAll API calls can fail with network errors, rate limits (429), validation errors (422),\nor authentication errors (401). Always handle errors in production code:\n\n```ruby\nbegin\n  result = client.messages.send_(to: \"+13125550001\", from: \"+13125550002\", text: \"Hello\")\nrescue Telnyx::Errors::APIConnectionError\n  puts \"Network error — check connectivity and retry\"\nrescue Telnyx::Errors::RateLimitError\n  # 429: rate limited — wait and retry with exponential backoff\n  sleep(1) # Check Retry-After header for actual delay\nrescue Telnyx::Errors::APIStatusError => e\n  puts \"API error #{e.status}: #{e.message}\"\n  if e.status == 422\n    puts \"Validation error — check required fields and formats\"\n  end\nend\n```\n\nCommon error codes: `401` invalid API key, `403` insufficient permissions,\n`404` resource not found, `422` validation error (check field formats),\n`429` rate limited (retry with exponential backoff).\n\n## Important Notes\n\n- **Pagination:** Use `.auto_paging_each` for automatic iteration: `page.auto_paging_each { |item| puts item.id }`.\n\n## List Audit Logs\n\nRetrieve a list of audit log entries. Audit logs are a best-effort, eventually consistent record of significant account-related changes.\n\n`GET /audit_events`\n\n```ruby\npage = client.audit_events.list\n\nputs(page)\n```\n\nReturns: `alternate_resource_id` (string | null), `change_made_by` (enum: telnyx, account_manager, account_owner, organization_member), `change_type` (string), `changes` (array | null), `created_at` (date-time), `id` (uuid), `organization_id` (uuid), `record_type` (string), `resource_id` (string), `user_id` (uuid)\n\n## Get user balance details\n\n`GET /balance`\n\n```ruby\nbalance = client.balance.retrieve\n\nputs(balance)\n```\n\nReturns: `available_credit` (string), `balance` (string), `credit_limit` (string), `currency` (string), `pending` (string), `record_type` (enum: balance)\n\n## Get monthly charges breakdown\n\nRetrieve a detailed breakdown of monthly charges for phone numbers in a specified date range. The date range cannot exceed 31 days.\n\n`GET /charges_breakdown`\n\n```ruby\ncharges_breakdown = client.charges_breakdown.retrieve(start_date: \"2025-05-01\")\n\nputs(charges_breakdown)\n```\n\nReturns: `currency` (string), `end_date` (date), `results` (array[object]), `start_date` (date), `user_email` (email), `user_id` (string)\n\n## Get monthly charges summary\n\nRetrieve a summary of monthly charges for a specified date range. The date range cannot exceed 31 days.\n\n`GET /charges_summary`\n\n```ruby\ncharges_summary = client.charges_summary.retrieve(end_date: \"2025-06-01\", start_date: \"2025-05-01\")\n\nputs(charges_summary)\n```\n\nReturns: `currency` (string), `end_date` (date), `start_date` (date), `summary` (object), `total` (object), `user_email` (email), `user_id` (string)\n\n## Search detail records\n\nSearch for any detail record across the Telnyx Platform\n\n`GET /detail_records`\n\n```ruby\npage = client.detail_records.list\n\nputs(page)\n```\n\nReturns: `carrier` (string), `carrier_fee` (string), `cld` (string), `cli` (string), `completed_at` (date-time), `cost` (string), `country_code` (string), `created_at` (date-time), `currency` (string), `delivery_status` (string), `delivery_status_failover_url` (string), `delivery_status_webhook_url` (string), `direction` (enum: inbound, outbound), `errors` (array[string]), `fteu` (boolean), `mcc` (string), `message_type` (enum: SMS, MMS, RCS), `mnc` (string), `on_net` (boolean), `parts` (integer), `profile_id` (string), `profile_name` (string), `rate` (string), `record_type` (string), `sent_at` (date-time), `source_country_code` (string), `status` (enum: gw_timeout, delivered, dlr_unconfirmed, dlr_timeout, received, gw_reject, failed), `tags` (string), `updated_at` (date-time), `user_id` (string), `uuid` (string)\n\n## List invoices\n\nRetrieve a paginated list of invoices.\n\n`GET /invoices`\n\n```ruby\npage = client.invoices.list\n\nputs(page)\n```\n\nReturns: `file_id` (uuid), `invoice_id` (uuid), `paid` (boolean), `period_end` (date), `period_start` (date), `url` (uri)\n\n## Get invoice by ID\n\nRetrieve a single invoice by its unique identifier.\n\n`GET /invoices/{id}`\n\n```ruby\ninvoice = client.invoices.retrieve(\"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e\")\n\nputs(invoice)\n```\n\nReturns: `download_url` (uri), `file_id` (uuid), `invoice_id` (uuid), `paid` (boolean), `period_end` (date), `period_start` (date), `url` (uri)\n\n## List auto recharge preferences\n\nReturns the payment auto recharge preferences.\n\n`GET /payment/auto_recharge_prefs`\n\n```ruby\nauto_recharge_prefs = client.payment.auto_recharge_prefs.list\n\nputs(auto_recharge_prefs)\n```\n\nReturns: `enabled` (boolean), `id` (string), `invoice_enabled` (boolean), `preference` (enum: credit_paypal, ach), `recharge_amount` (string), `record_type` (string), `threshold_amount` (string)\n\n## Update auto recharge preferences\n\nUpdate payment auto recharge preferences.\n\n`PATCH /payment/auto_recharge_prefs`\n\nOptional: `enabled` (boolean), `invoice_enabled` (boolean), `preference` (enum: credit_paypal, ach), `recharge_amount` (string), `threshold_amount` (string)\n\n```ruby\nauto_recharge_pref = client.payment.auto_recharge_prefs.update\n\nputs(auto_recharge_pref)\n```\n\nReturns: `enabled` (boolean), `id` (string), `invoice_enabled` (boolean), `preference` (enum: credit_paypal, ach), `recharge_amount` (string), `record_type` (string), `threshold_amount` (string)\n\n## List User Tags\n\nList all user tags.\n\n`GET /user_tags`\n\n```ruby\nuser_tags = client.user_tags.list\n\nputs(user_tags)\n```\n\nReturns: `number_tags` (array[string]), `outbound_profile_tags` (array[string])\n\n## Create a stored payment transaction\n\n`POST /v2/payment/stored_payment_transactions` — Required: `amount`\n\n```ruby\nresponse = client.payment.create_stored_payment_transaction(amount: \"120.00\")\n\nputs(response)\n```\n\nReturns: `amount_cents` (integer), `amount_currency` (string), `auto_recharge` (boolean), `created_at` (date-time), `id` (string), `processor_status` (string), `record_type` (enum: transaction), `transaction_processing_type` (enum: stored_payment)\n\n## List webhook deliveries\n\nLists webhook_deliveries for the authenticated user\n\n`GET /webhook_deliveries`\n\n```ruby\npage = client.webhook_deliveries.list\n\nputs(page)\n```\n\nReturns: `attempts` (array[object]), `finished_at` (date-time), `id` (uuid), `record_type` (string), `started_at` (date-time), `status` (enum: delivered, failed), `user_id` (uuid), `webhook` (object)\n\n## Find webhook_delivery details by ID\n\nProvides webhook_delivery debug data, such as timestamps, delivery status and attempts.\n\n`GET /webhook_deliveries/{id}`\n\n```ruby\nwebhook_delivery = client.webhook_deliveries.retrieve(\"C9C0797E-901D-4349-A33C-C2C8F31A92C2\")\n\nputs(webhook_delivery)\n```\n\nReturns: `attempts` (array[object]), `finished_at` (date-time), `id` (uuid), `record_type` (string), `started_at` (date-time), `status` (enum: delivered, failed), `user_id` (uuid), `webhook` (object)","tags":["telnyx","account","ruby","team-telnyx","agent-skills","ai-coding-agent","claude-code","cpaas","cursor","iot","llm","sdk"],"capabilities":["skill","source-team-telnyx","skill-telnyx-account-ruby","topic-agent-skills","topic-ai-coding-agent","topic-claude-code","topic-cpaas","topic-cursor","topic-iot","topic-llm","topic-sdk","topic-sip","topic-sms","topic-speech-to-text","topic-telephony"],"categories":["ai"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/team-telnyx/ai/telnyx-account-ruby","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add team-telnyx/ai","source_repo":"https://github.com/team-telnyx/ai","install_from":"skills.sh"}},"qualityScore":"0.533","qualityRationale":"deterministic score 0.53 from registry signals: · indexed on github topic:agent-skills · 167 github stars · SKILL.md body (7,246 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T12:54:43.225Z","embedding":null,"createdAt":"2026-04-18T22:06:12.006Z","updatedAt":"2026-04-22T12:54:43.225Z","lastSeenAt":"2026-04-22T12:54:43.225Z","tsv":"'+13125550001':76 '+13125550002':78 '-01':320,374,379 '-05':319,378 '-06':373 '/audit_events':208 '/balance':261 '/charges_breakdown':311 '/charges_summary':365 '/detail_records':415 '/invoices':539,575 '/payment/auto_recharge_prefs':619,661 '/user_tags':718 '/v2/payment/stored_payment_transactions':742 '/webhook_deliveries':796,849 '1':106 '120.00':752 '182bd5e5':581 '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e':580 '2025':318,372,377 '31':308,362 '401':64,141 '403':145 '404':148 '422':60,127,152 '429':57,96,158 '4349':858 '4fe4':583 '6e1a':582 '901d':857 'a33c':860 'a33c-c2c8f31a92c2':859 'a799':584 'aa6d9a6ab26e':585 'account':3,6,204,225,227 'account-rel':203 'ach':641,672,700 'across':410 'actual':113 'alreadi':40 'altern':215 'alway':65 'amount':643,649,674,677,702,708,744,751,756,759 'api':20,24,48,121,143 'apiconnectionerror':84 'apistatuserror':118 'array':235,331,466,729,734,804,867 'assum':37 'attempt':803,847,866 'audit':182,188,191 'authent':62,793 'auto':169,609,615,621,626,652,657,680,685,762 'automat':173 'avail':268 'backoff':104,164 'balanc':258,263,266,271,283 'bash':9 'begin':72 'best':196 'best-effort':195 'boolean':469,482,553,599,631,636,664,667,690,695,764 'breakdown':287,291,314,323 'c2c8f31a92c2':861 'c9c0797e':856 'c9c0797e-901d':855 'call':49 'cannot':306,360 'carrier':422,424 'cent':757 'chang':206,220,231,234 'charg':286,294,313,322,344,351,367,381 'check':88,107,131,155 'cld':427 'cli':429 'client':17,38 'client.audit_events.list':211 'client.balance.retrieve':264 'client.charges_breakdown.retrieve':315 'client.charges_summary.retrieve':369 'client.detail_records.list':418 'client.invoices.list':542 'client.invoices.retrieve':579 'client.messages.send':74 'client.new':19 'client.payment.auto_recharge_prefs.list':624 'client.payment.auto_recharge_prefs.update':683 'client.payment.create':747 'client.user_tags.list':722 'client.webhook_deliveries.list':799 'client.webhook_deliveries.retrieve':854 'code':70,140,439,503 'common':138 'complet':431 'connect':89 'consist':199 'cost':436 'countri':438,502 'creat':237,441,736,765 'credit':269,273,639,670,698 'currenc':276,325,384,446,760 'data':840 'date':240,301,304,317,328,329,334,335,355,358,371,376,387,388,390,391,434,444,499,523,556,559,602,605,768,809,819,872,882 'date-tim':239,433,443,498,522,767,808,818,871,881 'day':309,363 'debug':839 'default':29 'delay':114 'deliv':509,823,886 'deliveri':448,451,456,787,790,832,838,844,853,864 'detail':259,290,403,408,833 'direct':461 'dlr':510,512 'download':589 'e':119 'e.message':124 'e.status':123,126 'effort':197 'email':337,338,397,398 'enabl':630,635,663,666,689,694 'end':136,137,327,370,386,555,601 'entri':190 'enum':223,282,462,474,506,638,669,697,777,782,822,885 'env':22 'error':45,54,59,63,67,83,87,94,117,122,130,139,154,465 'eventu':198 'exampl':35 'exceed':307,361 'exponenti':103,163 'fail':51,517,824,887 'failov':453 'fee':425 'field':133,156 'file':546,592 'find':830 'finish':806,869 'format':135,157 'found':151 'fteu':468 'gem':10 'get':207,256,260,284,310,342,364,414,538,562,574,618,717,795,848 'gw':507,515 'handl':46,66 'header':111 'hello':80 'id':217,242,245,251,254,340,400,486,526,547,550,565,576,593,596,632,691,770,811,826,835,850,874,889 'identifi':573 'import':165 'inbound':463 'initi':41 'instal':8,11 'insuffici':146 'integ':484,758 'invalid':142 'invoic':531,537,549,563,569,578,587,595,634,665,693 'item':178 'item.id':180 'iter':174 'key':21,25,144 'limit':56,98,160,274 'list':181,186,530,535,608,710,713,785,788 'log':183,189,192 'made':221 'manag':226 'mcc':470 'member':230 'messag':472 'mms':476 'mnc':478 'month':285,293,343,350 'name':489 'net':481 'network':53,86 'note':166 'null':219,236 'number':297,727 'object':332,393,395,805,829,868,892 'omit':33 'option':662 'organ':229,244 'outbound':464,731 'owner':228 'page':170,176,210,213,417,420,541,544,798,801 'page.auto':175 'pagin':167,534 'paid':552,598 'part':483 'patch':660 'payment':614,656,739,749,784 'paypal':640,671,699 'pend':278 'period':554,557,600,603 'permiss':147 'phone':296 'platform':413 'post':741 'pref':623,628,682,687 'prefer':611,617,637,654,659,668,696 'process':780 'processor':772 'product':69 'profil':485,488,732 'provid':836 'put':85,120,128,179,212,265,321,380,419,543,586,625,684,723,753,800,862 'rang':302,305,356,359 'rate':55,97,159,491 'ratelimiterror':95 'rcs':477 'receiv':514 'recharg':610,616,622,627,642,653,658,673,681,686,701,763 'record':200,247,280,404,409,493,645,704,775,813,876 'reject':516 'relat':205 'requir':15,132,743 'rescu':81,92,115 'resourc':149,216,250 'respons':746,754 'result':73,330 'retri':91,101,109,161 'retriev':184,288,346,532,566 'retry-aft':108 'return':214,267,324,383,421,545,588,612,629,688,726,755,802,865 'rubi':4,7,14,71,209,262,312,366,416,540,577,620,679,719,745,797,851 'search':402,405 'sent':496 'setup':13 'shown':43 'signific':202 'singl':568 'skill' 'skill-telnyx-account-ruby' 'sleep':105 'sms':475 'sourc':501 'source-team-telnyx' 'specifi':300,354 'start':316,333,375,389,558,604,816,879 'status':449,452,457,505,773,821,845,884 'store':738,748,783 'string':218,233,249,252,270,272,275,277,279,326,341,385,401,423,426,428,430,437,440,447,450,455,460,467,471,479,487,490,492,495,504,519,527,529,633,644,647,650,675,678,692,703,706,709,730,735,761,771,774,815,878 'summari':345,348,368,382,392 'tag':518,712,716,721,725,728,733 'telnyx':2,5,12,16,18,23,82,93,116,224,412 'telnyx-account-rubi':1 'text':79 'threshold':648,676,707 'time':241,435,445,500,524,769,810,820,873,883 'timeout':508,513 'timestamp':843 'topic-agent-skills' 'topic-ai-coding-agent' 'topic-claude-code' 'topic-cpaas' 'topic-cursor' 'topic-iot' 'topic-llm' 'topic-sdk' 'topic-sip' 'topic-sms' 'topic-speech-to-text' 'topic-telephony' 'total':394 'transact':740,750,778,779 'type':232,248,281,473,494,646,705,776,781,814,877 'unconfirm':511 'uniqu':572 'updat':520,651,655 'uri':561,591,607 'url':454,459,560,590,606 'use':168 'user':253,257,336,339,396,399,525,711,715,720,724,794,825,888 'uuid':243,246,255,528,548,551,594,597,812,827,875,890 'valid':58,129,153 'wait':99 'webhook':458,786,789,828,831,837,852,863,891","prices":[{"id":"59ec78aa-593b-4db7-92be-ba3b8e702106","listingId":"5e20cb68-26b9-43d2-8943-79e0f82740dd","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"team-telnyx","category":"ai","install_from":"skills.sh"},"createdAt":"2026-04-18T22:06:12.006Z"}],"sources":[{"listingId":"5e20cb68-26b9-43d2-8943-79e0f82740dd","source":"github","sourceId":"team-telnyx/ai/telnyx-account-ruby","sourceUrl":"https://github.com/team-telnyx/ai/tree/main/skills/telnyx-account-ruby","isPrimary":false,"firstSeenAt":"2026-04-18T22:06:12.006Z","lastSeenAt":"2026-04-22T12:54:43.225Z"}],"details":{"listingId":"5e20cb68-26b9-43d2-8943-79e0f82740dd","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"team-telnyx","slug":"telnyx-account-ruby","github":{"repo":"team-telnyx/ai","stars":167,"topics":["agent-skills","ai","ai-coding-agent","claude-code","cpaas","cursor","iot","llm","sdk","sip","sms","speech-to-text","telephony","telnyx","tts","twilio-migration","voice-agents","voice-ai","webrtc","windsurf"],"license":"mit","html_url":"https://github.com/team-telnyx/ai","pushed_at":"2026-04-21T22:09:49Z","description":"Official one-stop shop for AI Agents and developers building with Telnyx.","skill_md_sha":"bd3be6aec84142a85d16dff7120ca42a0cae2e46","skill_md_path":"skills/telnyx-account-ruby/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/team-telnyx/ai/tree/main/skills/telnyx-account-ruby"},"layout":"multi","source":"github","category":"ai","frontmatter":{"name":"telnyx-account-ruby","description":">-"},"skills_sh_url":"https://skills.sh/team-telnyx/ai/telnyx-account-ruby"},"updatedAt":"2026-04-22T12:54:43.225Z"}}