dotnet-calling-endpoints

Guides calling operations on APIMatic-generated .NET SDKs with correct signatures and response handling.

Updated Jun 9, 2026
One-click install
npx skills add https://github.com/apimatic/plugin-marketplace --skill dotnet-calling-endpoints-apimatic
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dotnet-calling-endpoints
Source: https://github.com/apimatic/plugin-marketplace/tree/main/plugins/maxio-sdk/skills/dotnet-calling-endpoints
Command: npx skills add https://github.com/apimatic/plugin-marketplace --skill dotnet-calling-endpoints-apimatic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers integrating an APIMatic-generated .NET SDK often guess operation names, parameter order, and return types, producing calls that fail to compile or send wrong requests. This Skill grounds every call in the SDK's contract sheet so the first call to any endpoint is written correctly. ## Core Features & Use Cases - Method Signature Conventions: Explains the fixed parameter order (non-defaulted params, defaulted params, CancellationToken last) and why named arguments are required for list/search endpoints with many optional parameters. - Request and Response Shapes: Covers building immutable record request bodies with object-initializer syntax and reading the five response envelope variants (nested resource, direct resource, array, nested array, empty). - Use Case: When writing a C# call to a payments list endpoint, load this Skill to copy the exact parameter names from the signature, pass them as named arguments, and correctly iterate the returned IReadOnlyList of items. ## Quick Start Load this skill before writing the first call to an SDK operation so the agent reads the operation's real signature and return type from the contract sheet.

Frequently Asked Questions about dotnet-calling-endpoints

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I call an endpoint on an APIMatic .NET SDK?▼

Operations are async methods grouped under a controller property, called as client.{ApiGroup}.{Operation}(...), or directly on the client if ungrouped. Take the exact operation name and signature from the contract sheet rather than guessing from naming patterns.

How do I pass optional parameters to a .NET SDK list endpoint?▼

Use named arguments, since list operations have many optional parameters in fixed positional order and leading nullable params often lack C# defaults. Named arguments are order-independent and let omitted optionals fall through to null or their defaults.

What return types do APIMatic .NET SDK operations have?▼

Return types vary per operation: an object nesting the resource, the resource directly, an IReadOnlyList array, an object nesting an array, or a non-generic Task for empty responses. Check each method's return type to know whether to unwrap or iterate.

Does the .NET SDK support cancellation tokens?▼

Yes, every operation takes a CancellationToken as its last parameter, passed as ct:. Use the per-request cancellation pattern from the configuration-resilience guidance to bound individual calls with timeouts.

Why does my SDK call throw instead of returning an error?▼

Non-2xx responses throw SdkException<TError> rather than being signalled by the return value. Wrap calls in try/catch per the error-handling guidance, or use the optional {Operation}Result variant returning ApiResult<TResponse, TError> when generated.