Ready to supercharge your AI agents?

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

Get Started Free →

Telnyx Oauth - Ruby · team-telnyx | DecimalAI

team-telnyx/telnyx-oauth-ruby

SkillScore100Maintained

Implement OAuth 2.0 authentication flows for Telnyx API access. This skill provides Ruby SDK examples.

codingby 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-oauth-ruby/SKILL.md

decimalai skills pull team-telnyx-telnyx-oauth-ruby --out .claude/skills/

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

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

Raw file: /s/team-telnyx-telnyx-oauth-ruby/SKILL.md ↗ · machine-readable summary at /s/team-telnyx-telnyx-oauth-ruby.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

23 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 — +87% lift · at higher cost+99% tokens0% turns100% of whole cases pass with skill (23/23)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-03	✗→✓	▲ Improved	184%	0%
case-12	✗→✓	▲ Improved	91%	0%
case-01	✗→✓	▲ Improved	156%	0%
case-02	✗→✓	▲ Improved	130%	0%
case-04	✗→✓	▲ Improved	72%	0%

Showing 5 of 23 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-oauth-ruby/SKILL.md

View on GitHub ↗

License MITImported 8/10/2026Version v1

Skill contents

SKILL.md

Telnyx Oauth - Ruby

Installation

bash
gem install telnyx

Setup

ruby
require "telnyx"

client = Telnyx::Client.new(
  api_key: ENV["TELNYX_API_KEY"], # This is the default and can be omitted
)

All examples below assume client is already initialized as shown above.

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:

ruby
begin
  result = client.messages.send_(to: "+13125550001", from: "+13125550002", text: "Hello")
rescue Telnyx::Errors::APIConnectionError
  puts "Network error — check connectivity and retry"
rescue Telnyx::Errors::RateLimitError
  # 429: rate limited — wait and retry with exponential backoff
  sleep(1) # Check Retry-After header for actual delay
rescue Telnyx::Errors::APIStatusError => e
  puts "API error #{e.status}: #{e.message}"
  if e.status == 422
    puts "Validation error — check required fields and formats"
  end
end

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

Pagination: Use .auto_paging_each for automatic iteration: page.auto_paging_each { |item| puts item.id }.

Authorization server metadata

OAuth 2.0 Authorization Server Metadata (RFC 8414)

GET /.well-known/oauth-authorization-server

ruby
response = client.well_known.retrieve_authorization_server_metadata

puts(response)

Returns: authorization_endpoint (uri), code_challenge_methods_supported (arraystring]), grant_types_supported (arraystring]), introspection_endpoint (uri), issuer (uri), jwks_uri (uri), registration_endpoint (uri), response_types_supported (arraystring]), scopes_supported (arraystring]), token_endpoint (uri), token_endpoint_auth_methods_supported (arraystring])

Protected resource metadata

OAuth 2.0 Protected Resource Metadata for resource discovery

GET /.well-known/oauth-protected-resource

ruby
response = client.well_known.retrieve_protected_resource_metadata

puts(response)

Returns: authorization_servers (arraystring]), resource (uri)

OAuth authorization endpoint

OAuth 2.0 authorization endpoint for the authorization code flow

GET /oauth/authorize

ruby
result = client.oauth.retrieve_authorize(
  client_id: "550e8400-e29b-41d4-a716-446655440000",
  redirect_uri: "https://example.com",
  response_type: :code
)

puts(result)

Get OAuth consent token

Retrieve details about an OAuth consent token

GET /oauth/consent/{consent_token}

ruby
oauth = client.oauth.retrieve("consent_token")

puts(oauth)

Returns: client_id (string), logo_uri (uri), name (string), policy_uri (uri), redirect_uri (uri), requested_scopes (arrayobject]), tos_uri (uri), verified (boolean)

Create OAuth grant

Create an OAuth authorization grant

POST /oauth/grants — Required: allowed, consent_token

ruby
response = client.oauth.grants(allowed: true, consent_token: "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.example")

puts(response)

Returns: redirect_uri (uri)

Token introspection

Introspect an OAuth access token to check its validity and metadata

POST /oauth/introspect — Required: token

ruby
response = client.oauth.introspect(token: "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.example")

puts(response)

Returns: active (boolean), aud (string), client_id (string), exp (integer), iat (integer), iss (string), scope (string)

JSON Web Key Set

Retrieve the JSON Web Key Set for token verification

GET /oauth/jwks

ruby
response = client.oauth.retrieve_jwks

puts(response)

Returns: keys (arrayobject])

Dynamic client registration

Register a new OAuth client dynamically (RFC 7591)

POST /oauth/register

Optional: client_name (string), grant_types (arraystring]), logo_uri (uri), policy_uri (uri), redirect_uris (arraystring]), response_types (arraystring]), scope (string), token_endpoint_auth_method (enum: none, client_secret_basic, client_secret_post), tos_uri (uri)

ruby
response = client.oauth.register

puts(response)

Returns: client_id (string), client_id_issued_at (integer), client_name (string), client_secret (string), grant_types (arraystring]), logo_uri (uri), policy_uri (uri), redirect_uris (arraystring]), response_types (arraystring]), scope (string), token_endpoint_auth_method (string), tos_uri (uri)

OAuth token endpoint

Exchange authorization code, client credentials, or refresh token for access token

POST /oauth/token — Required: grant_type

Optional: client_id (string), client_secret (string), code (string), code_verifier (string), redirect_uri (uri), refresh_token (string), scope (string)

ruby
response = client.oauth.token(grant_type: :client_credentials)

puts(response)

Returns: access_token (string), expires_in (integer), refresh_token (string), scope (string), token_type (enum: Bearer)

List OAuth clients

Retrieve a paginated list of OAuth clients for the authenticated user

GET /oauth_clients

ruby
page = client.oauth_clients.list

puts(page)

Returns: allowed_grant_types (arraystring]), allowed_scopes (arraystring]), client_id (string), client_secret (string | null), client_type (enum: public, confidential), created_at (date-time), logo_uri (uri), name (string), org_id (string), policy_uri (uri), record_type (enum: oauth_client), redirect_uris (arraystring]), require_pkce (boolean), tos_uri (uri), updated_at (date-time), user_id (string)

Create OAuth client

Create a new OAuth client

POST /oauth_clients — Required: name, allowed_scopes, client_type, allowed_grant_types

Optional: logo_uri (uri), policy_uri (uri), redirect_uris (arraystring]), require_pkce (boolean), tos_uri (uri)

ruby
oauth_client = client.oauth_clients.create(
  allowed_grant_types: [:client_credentials],
  allowed_scopes: ["admin"],
  client_type: :public,
  name: "My OAuth client"
)

puts(oauth_client)

Returns: allowed_grant_types (arraystring]), allowed_scopes (arraystring]), client_id (string), client_secret (string | null), client_type (enum: public, confidential), created_at (date-time), logo_uri (uri), name (string), org_id (string), policy_uri (uri), record_type (enum: oauth_client), redirect_uris (arraystring]), require_pkce (boolean), tos_uri (uri), updated_at (date-time), user_id (string)

Get OAuth client

Retrieve a single OAuth client by ID

GET /oauth_clients/{id}

ruby
oauth_client = client.oauth_clients.retrieve("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")

puts(oauth_client)

Returns: allowed_grant_types (arraystring]), allowed_scopes (arraystring]), client_id (string), client_secret (string | null), client_type (enum: public, confidential), created_at (date-time), logo_uri (uri), name (string), org_id (string), policy_uri (uri), record_type (enum: oauth_client), redirect_uris (arraystring]), require_pkce (boolean), tos_uri (uri), updated_at (date-time), user_id (string)

Update OAuth client

Update an existing OAuth client

PUT /oauth_clients/{id}

Optional: allowed_grant_types (arraystring]), allowed_scopes (arraystring]), logo_uri (uri), name (string), policy_uri (uri), redirect_uris (arraystring]), require_pkce (boolean), tos_uri (uri)

ruby
oauth_client = client.oauth_clients.update("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")

puts(oauth_client)

Returns: allowed_grant_types (arraystring]), allowed_scopes (arraystring]), client_id (string), client_secret (string | null), client_type (enum: public, confidential), created_at (date-time), logo_uri (uri), name (string), org_id (string), policy_uri (uri), record_type (enum: oauth_client), redirect_uris (arraystring]), require_pkce (boolean), tos_uri (uri), updated_at (date-time), user_id (string)

Delete OAuth client

Delete an OAuth client

DELETE /oauth_clients/{id}

ruby
result = client.oauth_clients.delete("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")

puts(result)

List OAuth grants

Retrieve a paginated list of OAuth grants for the authenticated user

GET /oauth_grants

ruby
page = client.oauth_grants.list

puts(page)

Returns: client_id (string), created_at (date-time), id (uuid), last_used_at (date-time), record_type (enum: oauth_grant), scopes (arraystring])

Get OAuth grant

Retrieve a single OAuth grant by ID

GET /oauth_grants/{id}

ruby
oauth_grant = client.oauth_grants.retrieve("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")

puts(oauth_grant)

Returns: client_id (string), created_at (date-time), id (uuid), last_used_at (date-time), record_type (enum: oauth_grant), scopes (arraystring])

Revoke OAuth grant

Revoke an OAuth grant

DELETE /oauth_grants/{id}

ruby
oauth_grant = client.oauth_grants.delete("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")

puts(oauth_grant)

Returns: client_id (string), created_at (date-time), id (uuid), last_used_at (date-time), record_type (enum: oauth_grant), scopes (arraystring])

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

Latest benchmark · publisher runVerified

8/22/2026, 14:07 UTC · 23 cases

Lift

+87%

100% vs 13%

Agent turns

0%

1.0 vs 1.0

Tokens

+99%

3,846.39 vs 1,931.48

fail → pass · 20pass → pass · 3

Per-case results (23)

Case	Status	Duration (ms)			Turns			Tokens			Tool calls
Case	Status	Without	With	Δ	Without	With	Δ	Without	With	Δ	Without	With	Δ
case-03 Write a Ruby script using the Telnyx SDK to audit all OAuth grants registered on my account. The code should automatically iterate over all pages without manual page token management and print each grant's ID and creation time.	fail→pass	7,812	5,636	-28%	1	1	0%	1,472	4,176	+184%	0	0	—
case-12 Write a Ruby command to fetch all registered OAuth clients from the Telnyx account.	fail→pass	10,048	2,317	-77%	1	1	0%	1,823	3,476	+91%	0	0	—
case-21 I want to decode and verify the signature of a standard RS256 JWT access token locally in Ruby without making any HTTP request to external servers. How do I do this using the standard jwt Ruby gem?	pass→pass	10,219	5,319	-48%	1	1	0%	1,892	4,038	+113%	0	0	—
case-22 How do I construct a standard HTTP webhook receiver in Ruby using Sinatra to receive incoming JSON POST payloads?	pass→pass	11,623	31,153	+168%	1	1	0%	2,312	4,317	+87%	0	0	—
case-01 I need a Ruby snippet using the Telnyx gem that initializes the API client and creates a public OAuth client named 'Billing Dashboard' set up with client credentials grant type and 'admin' scope. Make sure to wrap the call in standard error handling for network errors, rate limits, or API validation failures.	fail→pass	7,652	5,017	-34%	1	1	0%	1,614	4,134	+156%	0	0	—
case-02 Can you show me how to write a Ruby function that verifies an incoming token string against Telnyx's introspection service? Please output a complete code sample that passes the token parameter to the SDK and handles potential API status errors safely.	fail→pass	10,621	7,015	-34%	1	1	0%	1,966	4,523	+130%	0	0	—
case-04 How do I query Telnyx's RFC 8414 authorization server metadata endpoint in Ruby to check supported grant types and token endpoints?	fail→pass	11,853	3,761	-68%	1	1	0%	2,237	3,858	+72%	0	0	—
case-05 Write a Ruby snippet that queries the well-known protected resource metadata endpoint on Telnyx to discover associated authorization servers.	fail→pass	8,572	3,335	-61%	1	1	0%	1,574	3,612	+129%	0	0	—
case-06 Show how to initiate an OAuth authorization code flow request using Telnyx's Ruby SDK with client ID '550e8400-e29b-41d4-a716-446655440000', redirect URI 'https://example.com', and response type code.	fail→pass	10,239	2,831	-72%	1	1	0%	1,913	3,683	+93%	0	0	—
case-07 Write a Ruby snippet to fetch details for a specific OAuth consent token string from Telnyx.	fail→pass	11,201	3,143	-72%	1	1	0%	2,125	3,648	+72%	0	0	—
case-08 How do I create an OAuth grant approval in Ruby for Telnyx when presented with a valid consent token 'eyJ0eX...' and explicit user permission?	fail→pass	13,707	3,494	-75%	1	1	0%	2,433	3,698	+52%	0	0	—
case-09 Provide a Ruby snippet to fetch the JSON Web Key Set from Telnyx for verifying signed OAuth tokens.	fail→pass	9,911	2,544	-74%	1	1	0%	1,809	3,489	+93%	0	0	—
case-10 How do I perform RFC 7591 dynamic OAuth client registration using the Telnyx Ruby SDK?	fail→pass	15,247	4,373	-71%	1	1	0%	2,736	3,993	+46%	0	0	—
case-11 Show how to request an access token using client credentials grant type with the Telnyx Ruby client.	fail→pass	10,841	3,522	-68%	1	1	0%	2,059	3,794	+84%	0	0	—
case-13 How do I retrieve details of a specific Telnyx OAuth client using its ID '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' in Ruby?	fail→pass	9,126	2,441	-73%	1	1	0%	1,885	3,586	+90%	0	0	—
case-14 Show how to update an existing Telnyx OAuth client with ID '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' in Ruby.	fail→pass	10,080	3,646	-64%	1	1	0%	2,025	3,835	+89%	0	0	—
case-15 How do I delete an OAuth client by ID '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' using the Telnyx Ruby SDK?	fail→pass	6,353	2,336	-63%	1	1	0%	1,295	3,528	+172%	0	0	—
case-16 Write a Ruby call to retrieve details of a single OAuth grant by ID '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e'.	fail→pass	7,548	1,924	-75%	1	1	0%	1,397	3,405	+144%	0	0	—
case-17 Show how to revoke an OAuth grant given its grant ID '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' using Telnyx's Ruby SDK.	fail→pass	7,497	2,320	-69%	1	1	0%	1,604	3,553	+122%	0	0	—
case-18 Write a Ruby script that loops through all OAuth clients on a Telnyx account across all pages and prints their client_id values.	fail→pass	11,083	4,467	-60%	1	1	0%	2,202	3,875	+76%	0	0	—
case-19 How should a Ruby application using the Telnyx gem specifically catch rate limiting errors (HTTP status 429) and handle them?	fail→pass	11,234	5,660	-50%	1	1	0%	2,030	4,130	+103%	0	0	—
case-20 How do you instantiate a Telnyx Ruby client instance reading the API key from environment variables by default?	fail→pass	10,669	2,297	-78%	1	1	0%	1,813	3,436	+90%	0	0	—
case-23 Show how to use Ruby's standard Net::HTTP library to send an HTTP POST request to an external token endpoint with form-urlencoded body data.	pass→pass	25,350	7,935	-69%	1	1	0%	2,208	4,680	+112%	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. 23 cases were attempted. The headline lift of +87 percentage points is the difference between those two pass rates over the 23 comparable cases.

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

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

Prompt

Write a Ruby script using the Telnyx SDK to audit all OAuth grants registered on my account. The code should automatically iterate over all pages without manual page token management and print each grant's ID and creation time.

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+103% 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 6 days ago

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