Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Telnyx Messaging Hosted - curl · team-telnyx | DecimalAI

team-telnyx/telnyx-messaging-hosted-curl

SkillScore100Maintained

Set up hosted SMS numbers, toll-free verification, and RCS messaging. Use when migrating numbers or enabling rich messaging features. This skill provides REST API (curl) examples.

industryby team-telnyx

Links this skill to your agents and keeps it current with the author’s updates.

Automatic

Coding pack

1 · One-time — install the CLI (docs ↗)

pip install decimalai

2 · Get the skill — writes .claude/skills/team-telnyx-telnyx-messaging-hosted-curl/SKILL.md

decimalai skills pull team-telnyx-telnyx-messaging-hosted-curl --out .claude/skills/

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/team-telnyx-telnyx-messaging-hosted-curl/SKILL.md https://app.decimal.ai/s/team-telnyx-telnyx-messaging-hosted-curl/SKILL.md

Raw file: /s/team-telnyx-telnyx-messaging-hosted-curl/SKILL.md ↗ · machine-readable summary at /s/team-telnyx-telnyx-messaging-hosted-curl.json ↗

In productionGlobal

how this skill behaves on real traffic · last 30 days

No production data for this skill yet — usage numbers appear here once agents start running it.

Anonymized aggregate across every org using this skill — proof from real production use, not a demo.

Does this skill help? · Benchmark: with vs. withoutsign in to run this on your agents

26 test cases from the publisher’s eval.yaml · each run twice on gemini-3.6-flash — with the skill injected, then without · last run 7d ago

Yes — +69% lift · at higher cost+488% tokens0% turns100% of whole cases pass with skill (26/26)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-09	✗→✓	▲ Improved	620%	0%
case-10	✗→✓	▲ Improved	1080%	0%
case-01	✗→✓	▲ Improved	421%	0%
case-02	✗→✓	▲ Improved	418%	0%
case-03	✗→✓	▲ Improved	332%	0%

Showing 5 of 26 cases

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/3/2026

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

team-telnyx / ai

skills/telnyx-messaging-hosted-curl/SKILL.md

View on GitHub ↗

License MITImported 8/10/2026Version v1

Skill contents

SKILL.md

Telnyx Messaging Hosted - curl

Installation

text
# curl is pre-installed on macOS, Linux, and Windows 10+

Setup

bash
export TELNYX_API_KEY="YOUR_API_KEY_HERE"

All examples below use $TELNYX_API_KEY for authentication.

Error Handling

All API calls can fail with network errors, rate limits (429), validation errors (422), or authentication errors (401). Always handle errors in production code:

bash
# Check HTTP status code in response
response=$(curl -s -w "\n%{http_code}" \
  -X POST "https://api.telnyx.com/v2/messages" \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to": "+13125550001", "from": "+13125550002", "text": "Hello"}')

http_code=$(echo "$response" | tail -1)
body=$(echo "$response" | sed '$d')

case $http_code in
  2*) echo "Success: $body" ;;
  422) echo "Validation error — check required fields and formats" ;;
  429) echo "Rate limited — retry after delay"; sleep 1 ;;
  401) echo "Authentication failed — check TELNYX_API_KEY" ;;
  *)   echo "Error $http_code: $body" ;;
esac

Common error codes: 401 invalid API key, 403 insufficient permissions, 404 resource not found, 422 validation error (check field formats), 429 rate limited (retry with exponential backoff).

Important Notes

Phone numbers must be in E.164 format (e.g., +13125550001). Include the + prefix and country code. No spaces, dashes, or parentheses.
Pagination: List endpoints return paginated results. Use page[number] and page[size] query parameters to navigate pages. Check meta.total_pages in the response.

Send an RCS message

POST /messages/rcs — Required: agent_id, to, messaging_profile_id, agent_message

Optional: mms_fallback (object), sms_fallback (object), type (enum: RCS), webhook_url (url)

bash
curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "agent_id": "Agent007",
  "to": "+13125551234",
  "messaging_profile_id": "550e8400-e29b-41d4-a716-446655440000",
  "agent_message": {}
}' \
  "https://api.telnyx.com/v2/messages/rcs"

Returns: body (object), direction (string), encoding (string), from (object), id (string), messaging_profile_id (string), organization_id (string), received_at (date-time), record_type (string), to (arrayobject]), type (string), wait_seconds (float)

Generate RCS deeplink

Generate a deeplink URL that can be used to start an RCS conversation with a specific agent.

GET /messages/rcs/deeplinks/{agent_id}

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/messages/rcs/deeplinks/{agent_id}?phone_number=%2B18445550001&body=hello%20world"

Returns: url (string)

List all RCS agents

GET /messaging/rcs/agents

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/messaging/rcs/agents"

Returns: agent_id (string), agent_name (string), created_at (date-time), enabled (boolean), profile_id (uuid), updated_at (date-time), user_id (string), webhook_failover_url (url), webhook_url (url)

Retrieve an RCS agent

GET /messaging/rcs/agents/{id}

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/messaging/rcs/agents/550e8400-e29b-41d4-a716-446655440000"

Modify an RCS agent

PATCH /messaging/rcs/agents/{id}

Optional: profile_id (uuid), webhook_failover_url (url), webhook_url (url)

bash
curl \
  -X PATCH \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  "https://api.telnyx.com/v2/messaging/rcs/agents/550e8400-e29b-41d4-a716-446655440000"

Check RCS capabilities (batch)

POST /messaging/rcs/bulk_capabilities — Required: agent_id, phone_numbers

bash
curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "agent_id": "TestAgent",
  "phone_numbers": [
    "+13125551234"
  ]
}' \
  "https://api.telnyx.com/v2/messaging/rcs/bulk_capabilities"

Returns: agent_id (string), agent_name (string), features (arraystring]), phone_number (string), record_type (enum: rcs.capabilities)

Check RCS capabilities

GET /messaging/rcs/capabilities/{agent_id}/{phone_number}

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/messaging/rcs/capabilities/{agent_id}/+13125550001"

Returns: agent_id (string), agent_name (string), features (arraystring]), phone_number (string), record_type (enum: rcs.capabilities)

Add RCS test number

Adds a test phone number to an RCS agent for testing purposes.

PUT /messaging/rcs/test_number_invite/{id}/{phone_number}

bash
curl \
  -X PUT \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  "https://api.telnyx.com/v2/messaging/rcs/test_number_invite/550e8400-e29b-41d4-a716-446655440000/+13125550001"

Returns: agent_id (string), phone_number (string), record_type (enum: rcs.test_number_invite), status (string)

List messaging hosted number orders

GET /messaging_hosted_number_orders

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/messaging_hosted_number_orders"

Returns: id (uuid), messaging_profile_id (string | null), phone_numbers (arrayobject]), record_type (string), status (enum: carrier_rejected, compliance_review_failed, deleted, failed, incomplete_documentation, incorrect_billing_information, ineligible_carrier, loa_file_invalid, loa_file_successful, pending, provisioning, successful)

Create a messaging hosted number order

POST /messaging_hosted_number_orders

Optional: messaging_profile_id (string), phone_numbers (arraystring])

bash
curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  "https://api.telnyx.com/v2/messaging_hosted_number_orders"

Check hosted messaging eligibility

POST /messaging_hosted_number_orders/eligibility_numbers_check — Required: phone_numbers

bash
curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "phone_numbers": [
    "+13125550001"
  ]
}' \
  "https://api.telnyx.com/v2/messaging_hosted_number_orders/eligibility_numbers_check"

Returns: phone_numbers (arrayobject])

Retrieve a messaging hosted number order

GET /messaging_hosted_number_orders/{id}

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/messaging_hosted_number_orders/550e8400-e29b-41d4-a716-446655440000"

Delete a messaging hosted number order

Delete a messaging hosted number order and all associated phone numbers.

DELETE /messaging_hosted_number_orders/{id}

bash
curl \
  -X DELETE \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  "https://api.telnyx.com/v2/messaging_hosted_number_orders/550e8400-e29b-41d4-a716-446655440000"

Upload hosted number document

POST /messaging_hosted_number_orders/{id}/actions/file_upload

bash
curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -F "loa=@/path/to/file" \
  -F "bill=@/path/to/file" \
  "https://api.telnyx.com/v2/messaging_hosted_number_orders/550e8400-e29b-41d4-a716-446655440000/actions/file_upload"

Validate hosted number codes

Validate the verification codes sent to the numbers of the hosted order. The verification codes must be created in the verification codes endpoint.

POST /messaging_hosted_number_orders/{id}/validation_codes — Required: verification_codes

bash
curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "verification_codes": [
    {}
  ]
}' \
  "https://api.telnyx.com/v2/messaging_hosted_number_orders/550e8400-e29b-41d4-a716-446655440000/validation_codes"

Returns: order_id (uuid), phone_numbers (arrayobject])

Create hosted number verification codes

Create verification codes to validate numbers of the hosted order. The verification codes will be sent to the numbers of the hosted order.

POST /messaging_hosted_number_orders/{id}/verification_codes — Required: phone_numbers, verification_method

bash
curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "phone_numbers": [
    "+13125550001"
  ],
  "verification_method": "sms"
}' \
  "https://api.telnyx.com/v2/messaging_hosted_number_orders/550e8400-e29b-41d4-a716-446655440000/verification_codes"

Returns: error (string), phone_number (string), type (enum: sms, call), verification_code_id (uuid)

Delete a messaging hosted number

DELETE /messaging_hosted_numbers/{id}

bash
curl \
  -X DELETE \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  "https://api.telnyx.com/v2/messaging_hosted_numbers/550e8400-e29b-41d4-a716-446655440000"

List Verification Requests

Get a list of previously-submitted tollfree verification requests

GET /messaging_tollfree/verification/requests

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/messaging_tollfree/verification/requests"

Returns: records (arrayobject]), total_records (integer)

Submit Verification Request

Submit a new tollfree verification request

POST /messaging_tollfree/verification/requests — Required: businessName, corporateWebsite, businessAddr1, businessCity, businessState, businessZip, businessContactFirstName, businessContactLastName, businessContactEmail, businessContactPhone, messageVolume, phoneNumbers, useCase, useCaseSummary, productionMessageContent, optInWorkflow, optInWorkflowImageURLs, additionalInformation

Optional: ageGatedContent (boolean), businessAddr2 (string), businessRegistrationCountry (string | null), businessRegistrationNumber (string | null), businessRegistrationType (string | null), campaignVerifyAuthorizationToken (string | null), doingBusinessAs (string | null), entityType (object), helpMessageResponse (string | null), isvReseller (string | null), optInConfirmationResponse (string | null), optInKeywords (string | null), privacyPolicyURL (string | null), termsAndConditionURL (string | null), webhookUrl (string)

bash
curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "businessName": "Telnyx LLC",
  "corporateWebsite": "http://example.com",
  "businessAddr1": "600 Congress Avenue",
  "businessCity": "Austin",
  "businessState": "Texas",
  "businessZip": "78701",
  "businessContactFirstName": "John",
  "businessContactLastName": "Doe",
  "businessContactEmail": "email@example.com",
  "businessContactPhone": "+18005550100",
  "messageVolume": "100,000",
  "phoneNumbers": [
    {
      "phoneNumber": "+18773554398"
    },
    {
      "phoneNumber": "+18773554399"
    }
  ],
  "useCase": "2FA",
  "useCaseSummary": "This is a use case where Telnyx sends out 2FA codes to portal users to verify their identity in order to sign into the portal",
  "productionMessageContent": "Your Telnyx OTP is XXXX",
  "optInWorkflow": "User signs into the Telnyx portal, enters a number and is prompted to select whether they want to use 2FA verification for security purposes. If they've opted in a confirmation message is sent out to the handset",
  "optInWorkflowImageURLs": [
    {
      "url": "https://telnyx.com/sign-up"
    },
    {
      "url": "https://telnyx.com/company/data-privacy"
    }
  ],
  "additionalInformation": "Additional context for this request."
}' \
  "https://api.telnyx.com/v2/messaging_tollfree/verification/requests"

Returns: additionalInformation (string), ageGatedContent (boolean), businessAddr1 (string), businessAddr2 (string), businessCity (string), businessContactEmail (string), businessContactFirstName (string), businessContactLastName (string), businessContactPhone (string), businessName (string), businessRegistrationCountry (string), businessRegistrationNumber (string), businessRegistrationType (string), businessState (string), businessZip (string), campaignVerifyAuthorizationToken (string | null), corporateWebsite (string), doingBusinessAs (string), entityType (object), helpMessageResponse (string), id (uuid), isvReseller (string), messageVolume (object), optInConfirmationResponse (string), optInKeywords (string), optInWorkflow (string), optInWorkflowImageURLs (arrayobject]), phoneNumbers (arrayobject]), privacyPolicyURL (string), productionMessageContent (string), termsAndConditionURL (string), useCase (object), useCaseSummary (string), verificationRequestId (string), verificationStatus (object), webhookUrl (string)

Get Verification Request

Get a single verification request by its ID.

GET /messaging_tollfree/verification/requests/{id}

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/messaging_tollfree/verification/requests/550e8400-e29b-41d4-a716-446655440000"

Returns: additionalInformation (string), ageGatedContent (boolean), businessAddr1 (string), businessAddr2 (string), businessCity (string), businessContactEmail (string), businessContactFirstName (string), businessContactLastName (string), businessContactPhone (string), businessName (string), businessRegistrationCountry (string), businessRegistrationNumber (string), businessRegistrationType (string), businessState (string), businessZip (string), campaignVerifyAuthorizationToken (string | null), corporateWebsite (string), createdAt (date-time), doingBusinessAs (string), entityType (object), helpMessageResponse (string), id (uuid), isvReseller (string), messageVolume (object), optInConfirmationResponse (string), optInKeywords (string), optInWorkflow (string), optInWorkflowImageURLs (arrayobject]), phoneNumbers (arrayobject]), privacyPolicyURL (string), productionMessageContent (string), reason (string), termsAndConditionURL (string), updatedAt (date-time), useCase (object), useCaseSummary (string), verificationStatus (object), webhookUrl (string)

Update Verification Request

Update an existing tollfree verification request. This is particularly useful when there are pending customer actions to be taken.

PATCH /messaging_tollfree/verification/requests/{id} — Required: businessName, corporateWebsite, businessAddr1, businessCity, businessState, businessZip, businessContactFirstName, businessContactLastName, businessContactEmail, businessContactPhone, messageVolume, phoneNumbers, useCase, useCaseSummary, productionMessageContent, optInWorkflow, optInWorkflowImageURLs, additionalInformation

bash
curl \
  -X PATCH \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "businessName": "Telnyx LLC",
  "corporateWebsite": "http://example.com",
  "businessAddr1": "600 Congress Avenue",
  "businessCity": "Austin",
  "businessState": "Texas",
  "businessZip": "78701",
  "businessContactFirstName": "John",
  "businessContactLastName": "Doe",
  "businessContactEmail": "email@example.com",
  "businessContactPhone": "+18005550100",
  "messageVolume": "100,000",
  "phoneNumbers": [
    {
      "phoneNumber": "+18773554398"
    },
    {
      "phoneNumber": "+18773554399"
    }
  ],
  "useCase": "2FA",
  "useCaseSummary": "This is a use case where Telnyx sends out 2FA codes to portal users to verify their identity in order to sign into the portal",
  "productionMessageContent": "Your Telnyx OTP is XXXX",
  "optInWorkflow": "User signs into the Telnyx portal, enters a number and is prompted to select whether they want to use 2FA verification for security purposes. If they've opted in a confirmation message is sent out to the handset",
  "optInWorkflowImageURLs": [
    {
      "url": "https://telnyx.com/sign-up"
    },
    {
      "url": "https://telnyx.com/company/data-privacy"
    }
  ],
  "additionalInformation": "Additional context for this request."
}' \
  "https://api.telnyx.com/v2/messaging_tollfree/verification/requests/550e8400-e29b-41d4-a716-446655440000"

Delete Verification Request

Delete a verification request

A request may only be deleted when when the request is in the "rejected" state. HTTP 200: request successfully deleted

HTTP 400: request exists but can't be deleted (i.e. not rejected)
HTTP 404: request unknown or already deleted

DELETE /messaging_tollfree/verification/requests/{id}

bash
curl \
  -X DELETE \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  "https://api.telnyx.com/v2/messaging_tollfree/verification/requests/550e8400-e29b-41d4-a716-446655440000"

Get Verification Request Status History

Get the history of status changes for a verification request. Returns a paginated list of historical status changes including the reason for each change and when it occurred.

GET /messaging_tollfree/verification/requests/{id}/status_history

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/messaging_tollfree/verification/requests/550e8400-e29b-41d4-a716-446655440000/status_history"

Returns: records (arrayobject]), total_records (integer)

List messaging URL domains

GET /messaging_url_domains

bash
curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/messaging_url_domains"

Returns: id (string), record_type (string), url_domain (string), use_case (string)

Want to see if team-telnyx/telnyx-messaging-hosted-curl would activate on your phrasing? Try it before you install — no LLM call, no signup.

Latest benchmark · publisher runVerified

8/22/2026, 09:17 UTC · 26 cases

Lift

+69%

100% vs 31%

Agent turns

1.0 vs 1.0

Tokens

+488%

7,619.12 vs 1,295.96

fail → pass · 18pass → pass · 8

Per-case results (26)

Case	Status	Duration (ms)			Turns			Tokens			Tool calls
Case	Status	Without	With	Δ	Without	With	Δ	Without	With	Δ	Without	With	Δ
case-09 Provide a curl snippet to list all RCS agents registered under my Telnyx account. Should I use /v2/rcs/agents or /v2/messaging/rcs/agents?	fail→pass	5,518	2,820	-49%	1	1	0%	1,045	7,522	+620%	0	0	—
case-10 I need to retrieve details for a specific Telnyx RCS agent with ID '550e8400-e29b-41d4-a716-446655440000'. Give me the exact curl command.	fail→pass	3,078	2,324	-24%	1	1	0%	627	7,401	+1080%	0	0	—
case-01 Can you give me a curl snippet to check RCS capabilities for a list of phone numbers under agent ID 'Agent_Sales'? Send the request to Telnyx using the API key environment variable, testing numbers like +13125551234 and +13125555678, expecting back a capability response for each number.	fail→pass	7,078	2,846	-60%	1	1	0%	1,450	7,559	+421%	0	0	—
case-02 I need a curl command to upload supporting documents (a letter of authorization at /docs/loa.pdf and a utility bill at /docs/bill.pdf) to my Telnyx hosted number order with ID '550e8400-e29b-41d4-a716-446655440000'. Please format the request using multipart form data and standard API key authorization header.	fail→pass	7,296	3,873	-47%	1	1	0%	1,499	7,772	+418%	0	0	—
case-03 Write a curl request to trigger SMS verification codes for a hosted messaging order '550e8400-e29b-41d4-a716-446655440000' targeting phone number '+13125550001'. The output should return the generated code ID and status structure.	fail→pass	8,579	4,029	-53%	1	1	0%	1,811	7,824	+332%	0	0	—
case-04 Provide a curl command to initiate an outbound phone call to +13125550001 from +13125550002 using Telnyx Call Control API.	pass→pass	4,202	6,102	+45%	1	1	0%	802	8,117	+912%	0	0	—
case-05 Write a curl command to create a new messaging profile named 'Production Profile' on Telnyx.	pass→pass	3,212	4,151	+29%	1	1	0%	583	7,751	+1230%	0	0	—
case-06 Give me a curl request to search for available tollfree phone numbers in national destination code 800 via Telnyx API.	pass→pass	7,997	5,253	-34%	1	1	0%	1,490	7,897	+430%	0	0	—
case-07 I want to send an RCS message to recipient +13125551234 using agent 'Agent007' and messaging profile ID '550e8400-e29b-41d4-a716-446655440000'. Many platforms use /v2/rcs/messages or /v2/messages with type=rcs, but I need the exact Telnyx endpoint path and payload structure for sending RCS.	fail→pass	13,817	4,803	-65%	1	1	0%	2,691	8,013	+198%	0	0	—
case-08 Generate a curl command to get a Telnyx RCS deeplink URL for agent 'Agent_Support' so users can start an RCS chat. I want to prefill phone number +18445550001 and body text 'hello world'. Be careful with query param encoding.	fail→pass	13,754	3,174	-77%	1	1	0%	3,039	7,598	+150%	0	0	—
case-11 Construct a curl command to update the webhook URL of an RCS agent '550e8400-e29b-41d4-a716-446655440000' on Telnyx. Many endpoints use PUT for full updates, but what HTTP method and path does Telnyx require for modifying an RCS agent?	fail→pass	7,395	3,672	-50%	1	1	0%	1,526	7,775	+410%	0	0	—
case-12 Write a curl request to check RCS capabilities for a single phone number '+13125550001' with agent ID 'Agent_Test'. Some developers try POSTing to a search route, but I want the GET endpoint that includes both agent ID and phone number in the URL path.	fail→pass	6,392	2,768	-57%	1	1	0%	1,227	7,492	+511%	0	0	—
case-13 How do I add phone number '+13125550001' as an RCS test number for agent ID '550e8400-e29b-41d4-a716-446655440000' using curl on Telnyx? Some endpoints use POST to /test_numbers, but please use the exact endpoint path and HTTP verb specified for test number invite.	fail→pass	8,984	4,123	-54%	1	1	0%	1,984	7,934	+300%	0	0	—
case-14 Show me the curl command to fetch all messaging hosted number orders on Telnyx.	pass→pass	5,116	2,617	-49%	1	1	0%	923	7,457	+708%	0	0	—
case-15 I want to place a new order for messaging hosted numbers using curl on Telnyx. What is the endpoint URL for creating a messaging hosted number order?	pass→pass	4,122	2,427	-41%	1	1	0%	796	7,418	+832%	0	0	—
case-16 Write a curl command to check if phone number '+13125550001' is eligible for hosted messaging on Telnyx before ordering.	fail→pass	5,955	2,303	-61%	1	1	0%	1,156	7,411	+541%	0	0	—
case-17 Construct a curl command to check the status of hosted number order ID '550e8400-e29b-41d4-a716-446655440000' on Telnyx.	fail→pass	3,118	2,422	-22%	1	1	0%	610	7,424	+1117%	0	0	—
case-18 Give me a curl command to delete a messaging hosted number order with ID '550e8400-e29b-41d4-a716-446655440000' on Telnyx.	pass→pass	3,131	2,021	-35%	1	1	0%	613	7,375	+1103%	0	0	—
case-19 I need a curl request to submit received verification codes to validate a hosted number order '550e8400-e29b-41d4-a716-446655440000' on Telnyx. What path and parameter payload key should I use?	fail→pass	6,428	3,538	-45%	1	1	0%	1,264	7,725	+511%	0	0	—
case-20 How do I remove an individual messaging hosted number with resource ID '550e8400-e29b-41d4-a716-446655440000' from Telnyx via curl?	pass→pass	5,857	2,855	-51%	1	1	0%	1,141	7,547	+561%	0	0	—
case-21 Write a curl request to list existing tollfree verification requests on Telnyx.	fail→pass	5,082	2,140	-58%	1	1	0%	866	7,377	+752%	0	0	—
case-22 Show me how to use curl to retrieve the status change history for a tollfree verification request with ID '550e8400-e29b-41d4-a716-446655440000'.	fail→pass	11,023	3,006	-73%	1	1	0%	1,994	7,552	+279%	0	0	—
case-23 Provide a curl command to list all messaging URL domains configured on Telnyx.	pass→pass	4,157	1,918	-54%	1	1	0%	719	7,302	+916%	0	0	—
case-24 I want to delete a rejected tollfree verification request with ID '550e8400-e29b-41d4-a716-446655440000' on Telnyx using curl. What endpoint should I call?	fail→pass	4,365	3,005	-31%	1	1	0%	847	7,590	+796%	0	0	—
case-25 Write a curl snippet to submit a new tollfree verification request on Telnyx for business 'Telnyx LLC'. What endpoint path and method should be used?	fail→pass	7,015	3,968	-43%	1	1	0%	1,414	7,779	+450%	0	0	—
case-26 What curl command fetches details for a single tollfree verification request with ID '550e8400-e29b-41d4-a716-446655440000'?	fail→pass	7,944	12,540	+58%	1	1	0%	1,578	7,485	+374%	0	0	—

These cases were also screened by the skill’s intent / safety pass.See the Trust review ↗Reproduce this benchmark in Colab ↗

How this skill was measured

DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 26 cases were attempted. The headline lift of +69 percentage points is the difference between those two pass rates over the 26 comparable cases.

Model measured: gemini-3.6-flash
Graded by: gemini-3.6-flash
Grading method: judged
Verification: verified
Pass rate without the skill: 30.8%
Pass rate with the skill: 100%
Cases attempted: 26
Cases counted toward lift: 26
Cases that regressed: 0
Skill version measured: v1
Run completed: 8/22/2026, 09:17 UTC

Measured example — same prompt, with vs. without the skill · from the benchmark run · case case-09

Prompt

Provide a curl snippet to list all RCS agents registered under my Telnyx account. Should I use /v2/rcs/agents or /v2/messaging/rcs/agents?

Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.

Show both answers

SkillScore blends 4 signals1 of 4 complete

BenchmarkPass rate WITH skill on a verified run100

Live evalNeeds ≥20 evaluated traces in 30 days

AI ratingNeeds ≥10 rated traces

AdoptionNeeds ≥10 serves across ≥2 orgs in 30 days

Efficiency · separate axis (at equal correctness)+0% turns+761% tokens

Shown for transparency; not credited unless a verified run shows no correctness regression.

Backed by 1 of 4 signals — each added signal makes the score more robust.

Verified on gemini-3.6-flash · re-tested 7 days ago

Other measured skills in the registry, with their headline benchmark lift.