> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/infrastructure-as-code-management/iacm-api-reference/module-registry/create-module-example.md).

# Create module example

Endpoint to upload README and Terraform source files for a single example directory of a module version

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"module-registry","description":"The module-registry service is a private registry for Terraform/Opentofu modules"}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/modules/{name}/{system}/{version}/examples":{"post":{"tags":["module-registry"],"summary":"Create module example","description":"Endpoint to upload README and Terraform source files for a single example directory of a module version","operationId":"module-registry#post-module-example","parameters":[{"name":"scope_org","in":"query","description":"org name","allowEmptyValue":true,"schema":{"type":"string","description":"org name"}},{"name":"scope_project","in":"query","description":"project name","allowEmptyValue":true,"schema":{"type":"string","description":"project name"}},{"name":"path","in":"query","description":"relative path under the module root; must be \"examples\" or begin with \"examples/\" (e.g. \"examples/eks-auto-mode\")","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"relative path under the module root; must be \"examples\" or begin with \"examples/\" (e.g. \"examples/eks-auto-mode\")","pattern":"^[a-zA-Z0-9_-][a-zA-Z0-9._/-]*$","minLength":1,"maxLength":1024}},{"name":"name","in":"path","description":"module name","required":true,"schema":{"type":"string","description":"module name"}},{"name":"system","in":"path","description":"system name","required":true,"schema":{"type":"string","description":"system name"}},{"name":"version","in":"path","description":"version of the module","required":true,"schema":{"type":"string","description":"version of the module"}},{"name":"Harness-Account","in":"header","description":"account name","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"account name"}},{"name":"Content-Type","in":"header","description":"Content-Type header (multipart/form-data with boundary)","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Content-Type header (multipart/form-data with boundary)"}},{"name":"Content-Length","in":"header","description":"Size in bytes of the multipart body","allowEmptyValue":true,"schema":{"type":"integer","description":"Size in bytes of the multipart body","format":"int64"}}],"responses":{"201":{"description":"Created response."},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/RegistryError"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/RegistryError"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/RegistryError"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/RegistryError"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/RegistryError"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/RegistryError"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/RegistryError"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/RegistryError"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/RegistryError"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/RegistryError"}}}}}}}},"components":{"schemas":{"RegistryError":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```