MCD - API Design Associate (RAML 1.0)


Note: Beginning June 1, 2020, this non-proctored certification exam became available as a free quiz. Existing certifications remain valid for their full 2 year period.

MuleSoft Certified Developer - API Design Associate (RAML 1.0)A MuleSoft Certified Developer – API Design Associate should be able to create well-designed, modular API definitions using RAML 1.0 and Anypoint Platform. The MCD – API Design Associate (RAML 1.0) exam validates that an API designer has the required knowledge and skills to:

  • Translate design requirements into API resources and methods.
  • Use RAML to define API resources, methods, parameters, and responses.
  • Model data in APIs using data types.
  • Minimize repetition in API definitions using resource types and traits.
  • Modularize APIs using libraries, overlays, and extensions.
  • Specify API security schemes.
  • Version APIs.
  • Document and test APIs and make them discoverable.

A downloadable datasheet for the exam can be found here.


  • Format: Multiple-choice, open book, unproctored
  • Length: 47 questions
  • Language: English


This exam can no longer be purchased.


The certification expires two years from the date of passing.


The best preparation for the exam is to take the instructor-led Anypoint Platform: API Design course. Candidates should be familiar with all of the content in the course and be able to apply the concepts in actual projects.


The exam validates that the candidate can perform the following tasks.

Note: API:DES is the acronym for the instructor-led Anypoint Platform: API Design course.

Expand all  

  • Describe the common web API formats including SOAP, RPC, and REST
  • Describe REST API architecture
  • List the rules for retaining REST principles in APIs
  • Describe design-first approach for REST APIs
  • API:DES Module 1
  • Identify different categories and actions for a REST API
  • Convert categories to resources
  • Select HTTP methods to support the actions on the categories
  • API:DES Module 2
  • Describe the API development lifecycle
  • Explain MuleSoft's API-led connectivity approach
  • Describe the API design lifecycle with Anypoint Platform
  • API:DES Module 3
  • Use RAML 1.0 to create API definitions
  • Define resources and methods in RAML API definitions
  • Specify URI parameters for necessary resource methods
  • API:DES Module 4
  • Describe response structure in HTTP methods
  • Use status codes in HTTP responses
  • Add error handling and caching information to HTTP responses
  • Select and specify the types of content returned in HTTP responses
  • API:DES Module 5
  • Add documentation and description nodes to RAML definitions
  • Use the mocking service to create API endpoints
  • Use the API Console to test API endpoints
  • API:DES Module 6
  • Create API Portals for learning about and testing APIs
  • Customize API Portals with themes
  • Publish API definitions to the Anypoint Exchange for discovery
  • Gather feedback from API consumers
  • API:DES Module 7
  • Create datatypes and their properties for resources
  • Create examples for datatypes
  • Include datatypes and examples in resource methods
  • Create scenarios in API Notebook to manipulate data
  • API:DES Module 8
  • Create and reference resource types patterns for reusability
  • Use traits to modularize methods
  • API:DES Module 9
  • Use libraries for greater API composability
  • Use overlays to internationalize resources
  • Use extensions to promote portability to test APIs in multiple environments
  • API:DES Module 10
  • Define API security requirements
  • Use security schemes to apply resource and method level policies
  • Define custom security schemes for APIs
  • Apply an OAuth2.0 external provider policy to resource methods
  • API:DES Module 11
  • Describe hypermedia
  • Simplify API discoverability using hypermedia
  • Use hypermedia to enhance API responses
  • Modify API definitions to generate state-specific client responses in resource methods
  • API:DES Module 12
  • Explain when and when not to version APIs
  • Describe the methods for versioning APIs
  • Document changes in new API versions using shared API Portals
  • Deprecate older versions of APIs
  • API:DES Module 13

More information

For more information, visit the Certification Help Center.

Get certified!

  • Confirm mastery of concepts
  • Achieve industry recognition
  • Differentiate yourself in the marketplace

Register for an exam