We're excited to announce that the OpenAPI specification for the Autodesk Platform Services (APS) Secure Service Account (SSA) API is now available in YAML format on our official GitHub repository.
This is the next step in our ongoing effort to make APS APIs more accessible, tooling-friendly, and easier to integrate—building on the OpenAPI specs we published earlier and the SSA SDKs released in beta for .NET and TypeScript.
What is SSA?
The Secure Service Account (SSA) API SSA allows applications to securely authenticate using secure service accounts—without requiring interactive user sign-in. It enables you to:
- Create a simple and secure server-to-server mechanism to automate existing three-legged access token workflows.
- Create and manage service accounts and RSA key pairs.
- Exchange a secure JWT for a user-context three-legged access token.
What's in the YAML Spec?
The SSA OpenAPI spec follows the OpenAPI 3.x standard and covers the full surface area of the SSA API, including:
- Service account management — create, list, retrieve, update, and delete service accounts
- Key management — generate and rotate RSA key pairs associated with a service account
- Token exchange — exchange a signed JWT assertion for a three-legged access token scoped to a specific user
The spec defines all request/response schemas, authentication requirements, error codes, and parameter constraints in a machine-readable YAML format.
Why This Matters
Having a YAML spec for the SSA API unlocks a range of workflows:
Auto-generate client code. Use tools like the OpenAPI Generator to scaffold a typed SSA client in the language of your choice—Python, Java, Go, Ruby, and more—without writing boilerplate from scratch.
Explore the API interactively. Import the spec directly into Postman or Insomnia to generate a full collection of SSA requests, complete with schema validation and example payloads.
Integrate with AI and low-code platforms. OpenAPI specs are the standard input format for AI agents, Power Automate connectors, and other automation platforms—making it straightforward to wire SSA into broader workflows.
Validate early. Use the spec to validate your request and response payloads at development time, catching integration issues before they reach production.
Where to Find It
The SSA OpenAPI spec is available in our official GitHub repository alongside specs for other APS APIs:
https://github.com/autodesk-platform-services/aps-sdk-openapi
If you're already using the SSA beta SDKs for .NET or TypeScript, the YAML spec is the canonical source of truth that those SDKs are generated from.