{"id":"9012af10-4de9-4832-a75b-2e3528683f12","shortId":"yz8YaJ","kind":"skill","title":"telnyx-numbers-go","tagline":">-","description":"<!-- Auto-generated from Telnyx OpenAPI specs. Do not edit. -->\n\n# Telnyx Numbers - Go\n\n## Installation\n\n```bash\ngo get github.com/team-telnyx/telnyx-go\n```\n\n## Setup\n\n```go\nimport (\n  \"context\"\n  \"fmt\"\n  \"os\"\n\n  \"github.com/team-telnyx/telnyx-go\"\n  \"github.com/team-telnyx/telnyx-go/option\"\n)\n\nclient := telnyx.NewClient(\n  option.WithAPIKey(os.Getenv(\"TELNYX_API_KEY\")),\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```go\nimport \"errors\"\n\navailablePhoneNumbers, err := client.AvailablePhoneNumbers.List(context.Background(), telnyx.AvailablePhoneNumberListParams{})\nif err != nil {\n  var apiErr *telnyx.Error\n  if errors.As(err, &apiErr) {\n    switch apiErr.StatusCode {\n    case 422:\n      fmt.Println(\"Validation error — check required fields and formats\")\n    case 429:\n      fmt.Println(\"Rate limited, retrying...\")\n    default:\n      fmt.Printf(\"API error %d: %s\\n\", apiErr.StatusCode, apiErr.Error())\n    }\n  } else {\n    fmt.Println(\"Network error — check connectivity and retry\")\n  }\n}\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- **Phone numbers** must be in E.164 format (e.g., `+13125550001`). Include the `+` prefix and country code. No spaces, dashes, or parentheses.\n- **Pagination:** Use `ListAutoPaging()` for automatic iteration: `iter := client.Resource.ListAutoPaging(ctx, params); for iter.Next() { item := iter.Current() }`.\n\n## Reference Use Rules\n\nDo not invent Telnyx parameters, enums, response fields, or webhook fields.\n\n- If the parameter, enum, or response field you need is not shown inline in this skill, read [references/api-details.md](references/api-details.md) before writing code.\n- Before using any operation in `## Additional Operations`, read [the optional-parameters section](references/api-details.md#optional-parameters) and [the response-schemas section](references/api-details.md#response-schemas).\n\n## Core Tasks\n\n### Search available phone numbers\n\nNumber search is the entrypoint for provisioning. Agents need the search method, key query filters, and the fields returned for candidate numbers.\n\n`client.AvailablePhoneNumbers.List()` — `GET /available_phone_numbers`\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `Filter` | object | No | Consolidated filter parameter (deepObject style). |\n\n```go\n\tavailablePhoneNumbers, err := client.AvailablePhoneNumbers.List(context.Background(), telnyx.AvailablePhoneNumberListParams{})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tfmt.Printf(\"%+v\\n\", availablePhoneNumbers.Data)\n```\n\nResponse wrapper:\n- items: `availablePhoneNumbers.data`\n- pagination: `availablePhoneNumbers.meta`\n\nPrimary item fields:\n- `PhoneNumber`\n- `RecordType`\n- `Quickship`\n- `Reservable`\n- `BestEffort`\n- `CostInformation`\n\n### Create a number order\n\nNumber ordering is the production provisioning step after number selection.\n\n`client.NumberOrders.New()` — `POST /number_orders`\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `PhoneNumbers` | array[object] | Yes |  |\n| `ConnectionId` | string (UUID) | No | Identifies the connection associated with this phone number. |\n| `MessagingProfileId` | string (UUID) | No | Identifies the messaging profile associated with the phone n... |\n| `BillingGroupId` | string (UUID) | No | Identifies the billing group associated with the phone numbe... |\n| ... | | | +1 optional params in [references/api-details.md](references/api-details.md) |\n\n```go\n\tnumberOrder, err := client.NumberOrders.New(context.Background(), telnyx.NumberOrderNewParams{\n\t\tPhoneNumbers: []telnyx.NumberOrderNewParamsPhoneNumber{{PhoneNumber: \"+18005550101\"}},\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tfmt.Printf(\"%+v\\n\", numberOrder.Data)\n```\n\nPrimary response fields:\n- `numberOrder.Data.ID`\n- `numberOrder.Data.Status`\n- `numberOrder.Data.PhoneNumbersCount`\n- `numberOrder.Data.RequirementsMet`\n- `numberOrder.Data.MessagingProfileID`\n- `numberOrder.Data.ConnectionID`\n\n### Check number order status\n\nOrder status determines whether provisioning completed or additional requirements are still blocking fulfillment.\n\n`client.NumberOrders.Get()` — `GET /number_orders/{number_order_id}`\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `NumberOrderId` | string (UUID) | Yes | The number order ID. |\n\n```go\n\tnumberOrder, err := client.NumberOrders.Get(context.Background(), \"number_order_id\")\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tfmt.Printf(\"%+v\\n\", numberOrder.Data)\n```\n\nPrimary response fields:\n- `numberOrder.Data.ID`\n- `numberOrder.Data.Status`\n- `numberOrder.Data.RequirementsMet`\n- `numberOrder.Data.PhoneNumbersCount`\n- `numberOrder.Data.PhoneNumbers`\n- `numberOrder.Data.ConnectionID`\n\n---\n\n## Important Supporting Operations\n\nUse these when the core tasks above are close to your flow, but you need a common variation or follow-up step.\n\n### Create a number reservation\n\nCreate or provision an additional resource when the core tasks do not cover this flow.\n\n`client.NumberReservations.New()` — `POST /number_reservations`\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `PhoneNumbers` | array[object] | Yes |  |\n| `Status` | enum (pending, success, failure) | No | The status of the entire reservation. |\n| `Id` | string (UUID) | No |  |\n| `RecordType` | string | No |  |\n| ... | | | +3 optional params in [references/api-details.md](references/api-details.md) |\n\n```go\n\tnumberReservation, err := client.NumberReservations.New(context.Background(), telnyx.NumberReservationNewParams{\n\t\tPhoneNumbers: []telnyx.NumberReservationNewParamsPhoneNumber{{PhoneNumber: \"+18005550101\"}},\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tfmt.Printf(\"%+v\\n\", numberReservation.Data)\n```\n\nPrimary response fields:\n- `numberReservation.Data.ID`\n- `numberReservation.Data.Status`\n- `numberReservation.Data.CreatedAt`\n- `numberReservation.Data.UpdatedAt`\n- `numberReservation.Data.CustomerReference`\n- `numberReservation.Data.Errors`\n\n### Retrieve a number reservation\n\nFetch the current state before updating, deleting, or making control-flow decisions.\n\n`client.NumberReservations.Get()` — `GET /number_reservations/{number_reservation_id}`\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `NumberReservationId` | string (UUID) | Yes | The number reservation ID. |\n\n```go\n\tnumberReservation, err := client.NumberReservations.Get(context.Background(), \"number_reservation_id\")\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tfmt.Printf(\"%+v\\n\", numberReservation.Data)\n```\n\nPrimary response fields:\n- `numberReservation.Data.ID`\n- `numberReservation.Data.Status`\n- `numberReservation.Data.CreatedAt`\n- `numberReservation.Data.UpdatedAt`\n- `numberReservation.Data.CustomerReference`\n- `numberReservation.Data.Errors`\n\n### List Advanced Orders\n\nInspect available resources or choose an existing resource before mutating it.\n\n`client.AdvancedOrders.List()` — `GET /advanced_orders`\n\n```go\n\tadvancedOrders, err := client.AdvancedOrders.List(context.Background())\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tfmt.Printf(\"%+v\\n\", advancedOrders.Data)\n```\n\nResponse wrapper:\n- items: `advancedOrders.data`\n\nPrimary item fields:\n- `ID`\n- `Status`\n- `AreaCode`\n- `Comments`\n- `CountryCode`\n- `CustomerReference`\n\n### Create Advanced Order\n\nCreate or provision an additional resource when the core tasks do not cover this flow.\n\n`client.AdvancedOrders.New()` — `POST /advanced_orders`\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `PhoneNumberType` | enum (local, mobile, toll_free, shared_cost, national, ...) | No |  |\n| `RequirementGroupId` | string (UUID) | No | The ID of the requirement group to associate with this advan... |\n| `CountryCode` | string (ISO 3166-1 alpha-2) | No |  |\n| ... | | | +5 optional params in [references/api-details.md](references/api-details.md) |\n\n```go\n\tadvancedOrder, err := client.AdvancedOrders.New(context.Background(), telnyx.AdvancedOrderNewParams{\n\t\tAdvancedOrder: telnyx.AdvancedOrderParam{},\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tfmt.Printf(\"%+v\\n\", advancedOrder.ID)\n```\n\nPrimary response fields:\n- `advancedOrder.ID`\n- `advancedOrder.Status`\n- `advancedOrder.AreaCode`\n- `advancedOrder.Comments`\n- `advancedOrder.CountryCode`\n- `advancedOrder.CustomerReference`\n\n### Update Advanced Order\n\nModify an existing resource without recreating it.\n\n`client.AdvancedOrders.UpdateRequirementGroup()` — `PATCH /advanced_orders/{advanced-order-id}/requirement_group`\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `Advanced-order-id` | string (UUID) | Yes |  |\n| `PhoneNumberType` | enum (local, mobile, toll_free, shared_cost, national, ...) | No |  |\n| `RequirementGroupId` | string (UUID) | No | The ID of the requirement group to associate with this advan... |\n| `CountryCode` | string (ISO 3166-1 alpha-2) | No |  |\n| ... | | | +5 optional params in [references/api-details.md](references/api-details.md) |\n\n```go\n\tresponse, err := client.AdvancedOrders.UpdateRequirementGroup(\n\t\tcontext.Background(),\n\t\t\"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e\",\n\t\ttelnyx.AdvancedOrderUpdateRequirementGroupParams{\n\t\t\tAdvancedOrder: telnyx.AdvancedOrderParam{},\n\t\t},\n\t)\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tfmt.Printf(\"%+v\\n\", response.ID)\n```\n\nPrimary response fields:\n- `response.ID`\n- `response.Status`\n- `response.AreaCode`\n- `response.Comments`\n- `response.CountryCode`\n- `response.CustomerReference`\n\n### Get Advanced Order\n\nFetch the current state before updating, deleting, or making control-flow decisions.\n\n`client.AdvancedOrders.Get()` — `GET /advanced_orders/{order_id}`\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `OrderId` | string (UUID) | Yes |  |\n\n```go\n\tadvancedOrder, err := client.AdvancedOrders.Get(context.Background(), \"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e\")\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tfmt.Printf(\"%+v\\n\", advancedOrder.ID)\n```\n\nPrimary response fields:\n- `advancedOrder.ID`\n- `advancedOrder.Status`\n- `advancedOrder.AreaCode`\n- `advancedOrder.Comments`\n- `advancedOrder.CountryCode`\n- `advancedOrder.CustomerReference`\n\n### List available phone number blocks\n\nInspect available resources or choose an existing resource before mutating it.\n\n`client.AvailablePhoneNumberBlocks.List()` — `GET /available_phone_number_blocks`\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `Filter` | object | No | Consolidated filter parameter (deepObject style). |\n\n```go\n\tavailablePhoneNumberBlocks, err := client.AvailablePhoneNumberBlocks.List(context.Background(), telnyx.AvailablePhoneNumberBlockListParams{})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tfmt.Printf(\"%+v\\n\", availablePhoneNumberBlocks.Data)\n```\n\nResponse wrapper:\n- items: `availablePhoneNumberBlocks.data`\n- pagination: `availablePhoneNumberBlocks.meta`\n\nPrimary item fields:\n- `PhoneNumber`\n- `CostInformation`\n- `Features`\n- `Range`\n- `RecordType`\n- `RegionInformation`\n\n### Retrieve all comments\n\nInspect available resources or choose an existing resource before mutating it.\n\n`client.Comments.List()` — `GET /comments`\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `Filter` | object | No | Consolidated filter parameter (deepObject style). |\n\n```go\n\tcomments, err := client.Comments.List(context.Background(), telnyx.CommentListParams{})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tfmt.Printf(\"%+v\\n\", comments.Data)\n```\n\nResponse wrapper:\n- items: `comments.data`\n- pagination: `comments.meta`\n\nPrimary item fields:\n- `ID`\n- `Body`\n- `CreatedAt`\n- `UpdatedAt`\n- `CommentRecordID`\n- `CommentRecordType`\n\n---\n\n## Additional Operations\n\nUse the core tasks above first. The operations below are indexed here with exact SDK methods and required params; use [references/api-details.md](references/api-details.md) for full optional params, response schemas, and lower-frequency webhook payloads.\nBefore using any operation below, read [the optional-parameters section](references/api-details.md#optional-parameters) and [the response-schemas section](references/api-details.md#response-schemas) so you do not guess missing fields.\n\n| Operation | SDK method | Endpoint | Use when | Required params |\n|-----------|------------|----------|----------|-----------------|\n| Create a comment | `client.Comments.New()` | `POST /comments` | Create or provision an additional resource when the core tasks do not cover this flow. | None |\n| Retrieve a comment | `client.Comments.Get()` | `GET /comments/{id}` | Fetch the current state before updating, deleting, or making control-flow decisions. | `Id` |\n| Mark a comment as read | `client.Comments.MarkAsRead()` | `PATCH /comments/{id}/read` | Modify an existing resource without recreating it. | `Id` |\n| Get country coverage | `client.CountryCoverage.Get()` | `GET /country_coverage` | Inspect available resources or choose an existing resource before mutating it. | None |\n| Get coverage for a specific country | `client.CountryCoverage.GetCountry()` | `GET /country_coverage/countries/{country_code}` | Fetch the current state before updating, deleting, or making control-flow decisions. | `CountryCode` |\n| List customer service records | `client.CustomerServiceRecords.List()` | `GET /customer_service_records` | Inspect available resources or choose an existing resource before mutating it. | None |\n| Create a customer service record | `client.CustomerServiceRecords.New()` | `POST /customer_service_records` | Create or provision an additional resource when the core tasks do not cover this flow. | None |\n| Verify CSR phone number coverage | `client.CustomerServiceRecords.VerifyPhoneNumberCoverage()` | `POST /customer_service_records/phone_number_coverages` | Create or provision an additional resource when the core tasks do not cover this flow. | None |\n| Get a customer service record | `client.CustomerServiceRecords.Get()` | `GET /customer_service_records/{customer_service_record_id}` | Fetch the current state before updating, deleting, or making control-flow decisions. | `CustomerServiceRecordId` |\n| List inexplicit number orders | `client.InexplicitNumberOrders.List()` | `GET /inexplicit_number_orders` | Inspect available resources or choose an existing resource before mutating it. | None |\n| Create an inexplicit number order | `client.InexplicitNumberOrders.New()` | `POST /inexplicit_number_orders` | Create or provision an additional resource when the core tasks do not cover this flow. | `OrderingGroups` |\n| Retrieve an inexplicit number order | `client.InexplicitNumberOrders.Get()` | `GET /inexplicit_number_orders/{id}` | Fetch the current state before updating, deleting, or making control-flow decisions. | `Id` |\n| Create an inventory coverage request | `client.InventoryCoverage.List()` | `GET /inventory_coverage` | Inspect available resources or choose an existing resource before mutating it. | None |\n| List mobile network operators | `client.MobileNetworkOperators.List()` | `GET /mobile_network_operators` | Inspect available resources or choose an existing resource before mutating it. | None |\n| List network coverage locations | `client.NetworkCoverage.List()` | `GET /network_coverage` | Inspect available resources or choose an existing resource before mutating it. | None |\n| List number block orders | `client.NumberBlockOrders.List()` | `GET /number_block_orders` | Inspect available resources or choose an existing resource before mutating it. | None |\n| Create a number block order | `client.NumberBlockOrders.New()` | `POST /number_block_orders` | Create or provision an additional resource when the core tasks do not cover this flow. | `StartingNumber`, `Range` |\n| Retrieve a number block order | `client.NumberBlockOrders.Get()` | `GET /number_block_orders/{number_block_order_id}` | Fetch the current state before updating, deleting, or making control-flow decisions. | `NumberBlockOrderId` |\n| Retrieve a list of phone numbers associated to orders | `client.NumberOrderPhoneNumbers.List()` | `GET /number_order_phone_numbers` | Inspect available resources or choose an existing resource before mutating it. | None |\n| Retrieve a single phone number within a number order. | `client.NumberOrderPhoneNumbers.Get()` | `GET /number_order_phone_numbers/{number_order_phone_number_id}` | Fetch the current state before updating, deleting, or making control-flow decisions. | `NumberOrderPhoneNumberId` |\n| Update requirements for a single phone number within a number order. | `client.NumberOrderPhoneNumbers.UpdateRequirements()` | `PATCH /number_order_phone_numbers/{number_order_phone_number_id}` | Modify an existing resource without recreating it. | `NumberOrderPhoneNumberId` |\n| List number orders | `client.NumberOrders.List()` | `GET /number_orders` | Create or inspect provisioning orders for number purchases. | None |\n| Update a number order | `client.NumberOrders.Update()` | `PATCH /number_orders/{number_order_id}` | Modify an existing resource without recreating it. | `NumberOrderId` |\n| List number reservations | `client.NumberReservations.List()` | `GET /number_reservations` | Inspect available resources or choose an existing resource before mutating it. | None |\n| Extend a number reservation | `client.NumberReservations.Actions.Extend()` | `POST /number_reservations/{number_reservation_id}/actions/extend` | Trigger a follow-up action in an existing workflow rather than creating a new top-level resource. | `NumberReservationId` |\n| Retrieve the features for a list of numbers | `client.NumbersFeatures.New()` | `POST /numbers_features` | Create or provision an additional resource when the core tasks do not cover this flow. | `PhoneNumbers` |\n| Lists the phone number blocks jobs | `client.PhoneNumberBlocks.Jobs.List()` | `GET /phone_number_blocks/jobs` | Inspect available resources or choose an existing resource before mutating it. | None |\n| Deletes all numbers associated with a phone number block | `client.PhoneNumberBlocks.Jobs.DeletePhoneNumberBlock()` | `POST /phone_number_blocks/jobs/delete_phone_number_block` | Create or provision an additional resource when the core tasks do not cover this flow. | `PhoneNumberBlockId` |\n| Retrieves a phone number blocks job | `client.PhoneNumberBlocks.Jobs.Get()` | `GET /phone_number_blocks/jobs/{id}` | Fetch the current state before updating, deleting, or making control-flow decisions. | `Id` |\n| List sub number orders | `client.SubNumberOrders.List()` | `GET /sub_number_orders` | Inspect available resources or choose an existing resource before mutating it. | None |\n| Retrieve a sub number order | `client.SubNumberOrders.Get()` | `GET /sub_number_orders/{sub_number_order_id}` | Fetch the current state before updating, deleting, or making control-flow decisions. | `SubNumberOrderId` |\n| Update a sub number order's requirements | `client.SubNumberOrders.Update()` | `PATCH /sub_number_orders/{sub_number_order_id}` | Modify an existing resource without recreating it. | `SubNumberOrderId` |\n| Cancel a sub number order | `client.SubNumberOrders.Cancel()` | `PATCH /sub_number_orders/{sub_number_order_id}/cancel` | Modify an existing resource without recreating it. | `SubNumberOrderId` |\n| Create a sub number orders report | `client.SubNumberOrdersReport.New()` | `POST /sub_number_orders_report` | Create or provision an additional resource when the core tasks do not cover this flow. | None |\n| Retrieve a sub number orders report | `client.SubNumberOrdersReport.Get()` | `GET /sub_number_orders_report/{report_id}` | Fetch the current state before updating, deleting, or making control-flow decisions. | `ReportId` |\n| Download a sub number orders report | `client.SubNumberOrdersReport.Download()` | `GET /sub_number_orders_report/{report_id}/download` | Fetch the current state before updating, deleting, or making control-flow decisions. | `ReportId` |\n\n### Other Webhook Events\n\n| Event | `data.event_type` | Description |\n|-------|-------------------|-------------|\n| `numberOrderStatusUpdate` | `number.order.status.update` | Number Order Status Update |\n\n---\n\nFor exhaustive optional parameters, full response schemas, and complete webhook payloads, see [references/api-details.md](references/api-details.md).","tags":["telnyx","numbers","team-telnyx","agent-skills","ai-coding-agent","claude-code","cpaas","cursor","iot","llm","sdk","sip"],"capabilities":["skill","source-team-telnyx","skill-telnyx-numbers-go","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-numbers-go","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 (20,727 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-22T06:54:43.249Z","embedding":null,"createdAt":"2026-04-18T22:07:13.360Z","updatedAt":"2026-04-22T06:54:43.249Z","lastSeenAt":"2026-04-22T06:54:43.249Z","tsv":"'+1':386 '+13125550001':161 '+18005550101':401,571 '+3':556 '+5':753,847 '-1':749,843 '-2':751,845 '/actions/extend':1673 '/advanced_orders':667,715,797,903 '/available_phone_number_blocks':961 '/available_phone_numbers':280 '/cancel':1873 '/comments':1020,1144,1166,1189 '/country_coverage':1205 '/country_coverage/countries':1226 '/customer_service_records':1249,1269,1317 '/customer_service_records/phone_number_coverages':1293 '/download':1943 '/inexplicit_number_orders':1342,1362,1386 '/inventory_coverage':1409 '/mobile_network_operators':1428 '/network_coverage':1447 '/number_block_orders':1466,1486,1511 '/number_order_phone_numbers':1541,1565,1598 '/number_orders':339,439,1617,1633 '/number_reservations':528,609,1650,1669 '/numbers_features':1704 '/phone_number_blocks/jobs':1729,1778 '/phone_number_blocks/jobs/delete_phone_number_block':1753 '/read':1191 '/requirement_group':802 '/sub_number_orders':1800,1820,1848,1868 '/sub_number_orders_report':1890,1915,1940 '/team-telnyx/telnyx-go':14,23 '/team-telnyx/telnyx-go/option':26 '182bd5e5':859,920 '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e':858,919 '3166':748,842 '401':64,127 '403':131 '404':134 '422':60,92,138 '429':57,102,144 '4fe4':861,922 '6e1a':860,921 'a799':862,923 'aa6d9a6ab26e':863,924 'action':1679 'addit':228,431,515,702,1063,1149,1274,1298,1367,1491,1709,1758,1895 'advan':744,838 'advanc':652,696,786,799,808,886 'advanced-order-id':798,807 'advancedord':669,760,765,865,915 'advancedorder.areacode':781,939 'advancedorder.comments':782,940 'advancedorder.countrycode':783,941 'advancedorder.customerreference':784,942 'advancedorder.id':775,779,933,937 'advancedorder.status':780,938 'advancedorders.data':681,685 'agent':263 'alpha':750,844 'alreadi':40 'alway':65 'api':32,48,109,129 'apierr':83,88 'apierr.error':115 'apierr.statuscode':90,114 'areacod':691 'array':345,534 'associ':355,368,381,741,835,1536,1745 'assum':37 'authent':62 'automat':177 'avail':253,655,944,949,1008,1207,1251,1344,1411,1430,1449,1468,1543,1652,1731,1802 'availablephonenumb':74,294 'availablephonenumberblock':975 'availablephonenumberblocks.data':988,992 'availablephonenumberblocks.meta':994 'availablephonenumbers.data':307,311 'availablephonenumbers.meta':313 'backoff':150 'bash':9 'besteffort':321 'bill':379 'billinggroupid':373 'block':435,947,1462,1482,1507,1513,1725,1750,1774 'bodi':1058 'call':49 'cancel':1861 'candid':276 'case':91,101 'check':96,120,141,420 'choos':658,952,1011,1210,1254,1347,1414,1433,1452,1471,1546,1655,1734,1805 'client':27,38 'client.advancedorders.get':901,917 'client.advancedorders.list':665,671 'client.advancedorders.new':713,762 'client.advancedorders.updaterequirementgroup':795,856 'client.availablephonenumberblocks.list':959,977 'client.availablephonenumbers.list':76,278,296 'client.comments.get':1164 'client.comments.list':1018,1036 'client.comments.markasread':1187 'client.comments.new':1142 'client.countrycoverage.get':1203 'client.countrycoverage.getcountry':1224 'client.customerservicerecords.get':1315 'client.customerservicerecords.list':1247 'client.customerservicerecords.new':1267 'client.customerservicerecords.verifyphonenumbercoverage':1291 'client.inexplicitnumberorders.get':1384 'client.inexplicitnumberorders.list':1340 'client.inexplicitnumberorders.new':1360 'client.inventorycoverage.list':1407 'client.mobilenetworkoperators.list':1426 'client.networkcoverage.list':1445 'client.numberblockorders.get':1509 'client.numberblockorders.list':1464 'client.numberblockorders.new':1484 'client.numberorderphonenumbers.get':1563 'client.numberorderphonenumbers.list':1539 'client.numberorderphonenumbers.updaterequirements':1596 'client.numberorders.get':437,458 'client.numberorders.list':1615 'client.numberorders.new':337,395 'client.numberorders.update':1631 'client.numberreservations.actions.extend':1667 'client.numberreservations.get':607,628 'client.numberreservations.list':1648 'client.numberreservations.new':526,565 'client.numbersfeatures.new':1702 'client.phonenumberblocks.jobs.deletephonenumberblock':1751 'client.phonenumberblocks.jobs.get':1776 'client.phonenumberblocks.jobs.list':1727 'client.resource.listautopaging':180 'client.subnumberorders.cancel':1866 'client.subnumberorders.get':1818 'client.subnumberorders.list':1798 'client.subnumberorders.update':1846 'client.subnumberordersreport.download':1938 'client.subnumberordersreport.get':1913 'client.subnumberordersreport.new':1888 'close':492 'code':70,126,167,222,1228 'comment':692,1006,1034,1141,1163,1184 'commentrecordid':1061 'commentrecordtyp':1062 'comments.data':1047,1051 'comments.meta':1053 'common':124,500 'complet':429,1979 'connect':121,354 'connectionid':348 'consolid':288,969,1028 'context':18 'context.background':77,297,396,459,566,629,672,763,857,918,978,1037 'control':604,898,1178,1239,1332,1398,1526,1581,1790,1835,1928,1954 'control-flow':603,897,1177,1238,1331,1397,1525,1580,1789,1834,1927,1953 'core':250,488,519,706,1067,1153,1278,1302,1371,1495,1713,1762,1899 'cost':727,821 'costinform':322,999 'countri':166,1201,1223,1227 'countrycod':693,745,839,1242 'cover':523,710,1157,1282,1306,1375,1499,1717,1766,1903 'coverag':1202,1219,1290,1405,1443 'creat':323,507,511,695,698,1139,1145,1262,1270,1294,1355,1363,1402,1479,1487,1618,1686,1705,1754,1882,1891 'createdat':1059 'csr':1287 'ctx':181 'current':596,890,1170,1231,1324,1390,1518,1573,1782,1827,1920,1946 'custom':1244,1264,1312,1318 'customerrefer':694 'customerservicerecordid':1335 'd':111 'dash':170 'data.event':1962 'decis':606,900,1180,1241,1334,1400,1528,1583,1792,1837,1930,1956 'deepobject':291,972,1031 'default':107 'delet':600,894,1174,1235,1328,1394,1522,1577,1742,1786,1831,1924,1950 'descript':284,343,446,532,616,719,806,909,965,1024,1964 'determin':426 'download':1932 'e.164':158 'e.g':160 'els':116 'endpoint':1134 'entir':547 'entrypoint':260 'enum':195,204,538,721,815 'err':75,80,87,295,300,303,394,403,406,457,464,467,564,573,576,627,634,637,670,674,677,761,768,771,855,868,871,916,926,929,976,981,984,1035,1040,1043 'error':45,54,59,63,67,73,95,110,119,125,140 'errors.as':86 'event':1960,1961 'exact':1078 'exampl':35 'exhaust':1972 'exist':660,790,954,1013,1194,1212,1256,1349,1416,1435,1454,1473,1548,1606,1639,1657,1682,1736,1807,1855,1876 'exponenti':149 'extend':1663 'fail':51 'failur':541 'featur':1000,1696 'fetch':594,888,1168,1229,1322,1388,1516,1571,1780,1825,1918,1944 'field':98,142,197,200,207,273,316,413,474,583,644,688,778,878,936,997,1056,1130 'filter':270,285,289,966,970,1025,1029 'first':1070 'flow':495,525,605,712,899,1159,1179,1240,1284,1308,1333,1377,1399,1501,1527,1582,1719,1768,1791,1836,1905,1929,1955 'fmt':19 'fmt.printf':108,304,407,468,577,638,678,772,872,930,985,1044 'fmt.println':93,103,117 'follow':504,1677 'follow-up':503,1676 'format':100,143,159 'found':137 'free':725,819 'frequenc':1096 'fulfil':436 'full':1088,1975 'get':11,279,438,608,666,885,902,960,1019,1165,1200,1204,1218,1225,1248,1310,1316,1341,1385,1408,1427,1446,1465,1510,1540,1564,1616,1649,1728,1777,1799,1819,1914,1939 'github.com':13,22,25 'github.com/team-telnyx/telnyx-go':12,21 'github.com/team-telnyx/telnyx-go/option':24 'go':4,7,10,16,71,293,392,455,562,625,668,759,853,914,974,1033 'group':380,739,833 'guess':1128 'handl':46,66 'id':442,454,462,549,612,624,632,689,735,801,810,829,905,1057,1167,1181,1190,1199,1321,1387,1401,1515,1570,1603,1636,1672,1779,1793,1824,1852,1872,1917,1942 'identifi':352,364,377 'import':17,72,151,481 'includ':162 'index':1075 'inexplicit':1337,1357,1381 'initi':41 'inlin':213 'inspect':654,948,1007,1206,1250,1343,1410,1429,1448,1467,1542,1620,1651,1730,1801 'instal':8 'insuffici':132 'invalid':128 'invent':192 'inventori':1404 'iso':747,841 'item':185,310,315,684,687,991,996,1050,1055 'iter':178,179 'iter.current':186 'iter.next':184 'job':1726,1775 'key':33,130,268 'level':1691 'limit':56,105,146 'list':651,943,1243,1336,1422,1441,1460,1532,1612,1645,1699,1721,1794 'listautopag':175 'local':722,816 'locat':1444 'log.fatal':302,405,466,575,636,676,770,870,928,983,1042 'lower':1095 'lower-frequ':1094 'make':602,896,1176,1237,1330,1396,1524,1579,1788,1833,1926,1952 'mark':1182 'messag':366 'messagingprofileid':360 'method':267,1080,1133 'miss':1129 'mobil':723,817,1423 'modifi':788,1192,1604,1637,1853,1874 'must':155 'mutat':663,957,1016,1215,1259,1352,1419,1438,1457,1476,1551,1660,1739,1810 'n':113,306,372,409,470,579,640,680,774,874,932,987,1046 'nation':728,822 'need':209,264,498 'network':53,118,1424,1442 'new':1688 'nil':81,301,404,465,574,635,675,769,869,927,982,1041 'none':1160,1217,1261,1285,1309,1354,1421,1440,1459,1478,1553,1626,1662,1741,1812,1906 'note':152 'numb':385 'number':3,6,154,255,256,277,325,327,335,359,421,440,452,460,509,592,610,622,630,946,1289,1338,1358,1382,1461,1481,1506,1512,1535,1558,1561,1566,1569,1591,1594,1599,1602,1613,1624,1629,1634,1646,1665,1670,1701,1724,1744,1749,1773,1796,1816,1822,1842,1850,1864,1870,1885,1910,1935,1967 'number.order.status.update':1966 'numberblockorderid':1529 'numberord':393,456 'numberorder.data':410,471 'numberorder.data.connectionid':419,480 'numberorder.data.id':414,475 'numberorder.data.messagingprofileid':418 'numberorder.data.phonenumbers':479 'numberorder.data.phonenumberscount':416,478 'numberorder.data.requirementsmet':417,477 'numberorder.data.status':415,476 'numberorderid':447,1644 'numberorderphonenumberid':1584,1611 'numberorderstatusupd':1965 'numberreserv':563,626 'numberreservation.data':580,641 'numberreservation.data.createdat':586,647 'numberreservation.data.customerreference':588,649 'numberreservation.data.errors':589,650 'numberreservation.data.id':584,645 'numberreservation.data.status':585,646 'numberreservation.data.updatedat':587,648 'numberreservationid':617,1693 'object':286,346,535,967,1026 'oper':226,229,483,1064,1072,1102,1131,1425 'option':233,238,387,557,754,848,1089,1107,1112,1973 'option.withapikey':29 'optional-paramet':232,237,1106,1111 'order':326,328,422,424,441,453,461,653,697,787,800,809,887,904,1339,1359,1383,1463,1483,1508,1514,1538,1562,1567,1595,1600,1614,1622,1630,1635,1797,1817,1823,1843,1851,1865,1871,1886,1911,1936,1968 'orderid':910 'orderinggroup':1378 'os':20 'os.getenv':30 'pagin':173,312,993,1052 'param':182,388,558,755,849,1083,1090,1138 'paramet':194,203,234,239,281,290,340,443,529,613,716,803,906,962,971,1021,1030,1108,1113,1974 'parenthes':172 'patch':796,1188,1597,1632,1847,1867 'payload':1098,1981 'pend':539 'permiss':133 'phone':153,254,358,371,384,945,1288,1534,1557,1568,1590,1601,1723,1748,1772 'phonenumb':317,344,398,400,533,568,570,998,1720 'phonenumberblockid':1769 'phonenumbertyp':720,814 'post':338,527,714,1143,1268,1292,1361,1485,1668,1703,1752,1889 'prefix':164 'primari':314,411,472,581,642,686,776,876,934,995,1054 'product':69,331 'profil':367 'provis':262,332,428,513,700,1147,1272,1296,1365,1489,1621,1707,1756,1893 'purchas':1625 'queri':269 'quickship':319 'rang':1001,1503 'rate':55,104,145 'rather':1684 'read':217,230,1104,1186 'record':1246,1266,1314,1320 'recordtyp':318,553,1002 'recreat':793,1197,1609,1642,1858,1879 'refer':187 'references/api-details.md':218,219,236,246,390,391,560,561,757,758,851,852,1085,1086,1110,1120,1983,1984 'regioninform':1003 'report':1887,1912,1916,1937,1941 'reportid':1931,1957 'request':1406 'requir':97,283,342,432,445,531,615,718,738,805,832,908,964,1023,1082,1137,1586,1845 'requirementgroupid':730,824 'reserv':320,510,548,593,611,623,631,1647,1666,1671 'resourc':135,516,656,661,703,791,950,955,1009,1014,1150,1195,1208,1213,1252,1257,1275,1299,1345,1350,1368,1412,1417,1431,1436,1450,1455,1469,1474,1492,1544,1549,1607,1640,1653,1658,1692,1710,1732,1737,1759,1803,1808,1856,1877,1896 'respons':196,206,243,248,308,412,473,582,643,682,777,854,877,935,989,1048,1091,1117,1122,1976 'response-schema':242,247,1116,1121 'response.areacode':881 'response.comments':882 'response.countrycode':883 'response.customerreference':884 'response.id':875,879 'response.status':880 'retri':106,123,147 'retriev':590,1004,1161,1379,1504,1530,1554,1694,1770,1813,1907 'return':274 'rule':189 'schema':244,249,1092,1118,1123,1977 'sdk':1079,1132 'search':252,257,266 'section':235,245,1109,1119 'see':1982 'select':336 'servic':1245,1265,1313,1319 'setup':15 'share':726,820 'shown':43,212 'singl':1556,1589 'skill':216 'skill-telnyx-numbers-go' 'source-team-telnyx' 'space':169 'specif':1222 'startingnumb':1502 'state':597,891,1171,1232,1325,1391,1519,1574,1783,1828,1921,1947 'status':423,425,537,544,690,1969 'step':333,506 'still':434 'string':349,361,374,448,550,554,618,731,746,811,825,840,911 'style':292,973,1032 'sub':1795,1815,1821,1841,1849,1863,1869,1884,1909,1934 'subnumberorderid':1838,1860,1881 'success':540 'support':482 'switch':89 'task':251,489,520,707,1068,1154,1279,1303,1372,1496,1714,1763,1900 'telnyx':2,5,31,193 'telnyx-numbers-go':1 'telnyx.advancedordernewparams':764 'telnyx.advancedorderparam':766,866 'telnyx.advancedorderupdaterequirementgroupparams':864 'telnyx.availablephonenumberblocklistparams':979 'telnyx.availablephonenumberlistparams':78,298 'telnyx.commentlistparams':1038 'telnyx.error':84 'telnyx.newclient':28 'telnyx.numberordernewparams':397 'telnyx.numberordernewparamsphonenumber':399 'telnyx.numberreservationnewparams':567 'telnyx.numberreservationnewparamsphonenumber':569 'toll':724,818 'top':1690 'top-level':1689 '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' 'trigger':1674 'type':282,341,444,530,614,717,804,907,963,1022,1963 'updat':599,785,893,1173,1234,1327,1393,1521,1576,1585,1627,1785,1830,1839,1923,1949,1970 'updatedat':1060 'use':174,188,224,484,1065,1084,1100,1135 'uuid':350,362,375,449,551,619,732,812,826,912 'v':305,408,469,578,639,679,773,873,931,986,1045 'valid':58,94,139 'var':82 'variat':501 'verifi':1286 'webhook':199,1097,1959,1980 'whether':427 'within':1559,1592 'without':792,1196,1608,1641,1857,1878 'workflow':1683 'wrapper':309,683,990,1049 'write':221 'yes':347,450,536,620,813,913","prices":[{"id":"988c51c9-0d0f-4154-ada9-5e89350d5ef6","listingId":"9012af10-4de9-4832-a75b-2e3528683f12","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:07:13.360Z"}],"sources":[{"listingId":"9012af10-4de9-4832-a75b-2e3528683f12","source":"github","sourceId":"team-telnyx/ai/telnyx-numbers-go","sourceUrl":"https://github.com/team-telnyx/ai/tree/main/skills/telnyx-numbers-go","isPrimary":false,"firstSeenAt":"2026-04-18T22:07:13.360Z","lastSeenAt":"2026-04-22T06:54:43.249Z"}],"details":{"listingId":"9012af10-4de9-4832-a75b-2e3528683f12","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"team-telnyx","slug":"telnyx-numbers-go","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":"157c33f99fbd05e19578ce365d3413c9b0fb4486","skill_md_path":"skills/telnyx-numbers-go/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/team-telnyx/ai/tree/main/skills/telnyx-numbers-go"},"layout":"multi","source":"github","category":"ai","frontmatter":{"name":"telnyx-numbers-go","description":">-"},"skills_sh_url":"https://skills.sh/team-telnyx/ai/telnyx-numbers-go"},"updatedAt":"2026-04-22T06:54:43.249Z"}}