# Create Prototype

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Create Prototype"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/api/v1/workspaces/{workspace_name}/shared_prototypes"}
  context={"endpoint"}
>
  
</MethodEndpoint>

Creates a link to a pipeline prototype you can then share with others to try out.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"description":"Type the name of the workspace.","in":"path","name":"workspace_name","required":true,"schema":{"description":"Type the name of the workspace.","title":"Workspace Name","type":"string"}}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"content":{"application/json":{"schema":{"properties":{"brand_color":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Specify a hexadecimal color code to represent the branding of the shared prototype.","title":"Brand Color"},"brand_logo":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Provide a base64 encoded string of the brand logo image.","title":"Brand Logo"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Explain how you expect the users to use this pipeline. Users who visit the shared prototype will see this text. For more information on how to set the right expectations regarding your pipeline, see [Guidelines for Onboarding Your Users](https://docs.cloud.deepset.ai/docs/guidelines-for-onboarding-your-users).","title":"Description"},"expiration_date":{"description":"The date after which the generated link will expire and become invalid. The expiration date must be within 60 days from the current date.","format":"date-time","title":"Expiration date","type":"string"},"file_upload_enabled":{"default":false,"description":"Set `True` if you want your users to be able to upload files in the shared prototype.","title":"File upload enabled","type":"boolean"},"login_required":{"default":false,"description":"Select whether users need to log in to access the shared prototype.","title":"Login required","type":"boolean"},"pipeline_names":{"description":"The names of the pipelines which you want to share.","items":{"type":"string"},"minItems":1,"title":"Pipeline names","type":"array"},"runtime_params_enabled":{"default":false,"description":"Set `True` if you want your users to be able to use runtime parameters in the shared prototype.","title":"Runtime parameters enabled","type":"boolean"},"show_files":{"default":false,"description":"Select `True` if you want your users to be able to view the pipeline files.","title":"Show files","type":"boolean"},"show_metadata_filters":{"default":false,"description":"Select `True` if you want your users to be able to filter the documents by metadata.","title":"Show metadata filters","type":"boolean"}},"required":["expiration_date","pipeline_names"],"title":"PostSharedPrototype","type":"object"}}},"required":true}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"201":{"content":{"application/json":{"schema":{"properties":{"brand_color":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Specify a hexadecimal color code to represent the branding of the shared prototype.","title":"Brand Color"},"brand_logo":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Provide a base64 encoded string of the brand logo image.","title":"Brand Logo"},"created_by_id":{"description":"Unique ID of the user who created the shared prototype.","format":"uuid","title":"Created by ID","type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Explain how you expect the users to use this pipeline. Users who visit the shared prototype will see this text. For more information on how to set the right expectations regarding your pipeline, see [Guidelines for Onboarding Your Users](https://docs.cloud.deepset.ai/docs/guidelines-for-onboarding-your-users).","title":"Description"},"expiration_date":{"description":"The date after which the generated link will expire and become invalid. The expiration date must be within 60 days from the current date.","format":"date-time","title":"Expiration date","type":"string"},"file_upload_enabled":{"default":false,"description":"Set `True` if you want your users to be able to upload files in the shared prototype.","title":"File upload enabled","type":"boolean"},"is_revoked":{"description":"If a prototype is revoked, it's no longer accessible with the link.","title":"Is revoked","type":"boolean"},"link":{"description":"The generated link to the shared pipelines.","title":"Link","type":"string"},"login_required":{"default":false,"description":"Select whether users need to log in to access the shared prototype.","title":"Login required","type":"boolean"},"pipeline_names":{"description":"The names of the pipelines which you want to share.","items":{"type":"string"},"title":"Pipeline names","type":"array"},"runtime_params_enabled":{"default":false,"description":"Set `True` if you want your users to be able to use runtime parameters in the shared prototype.","title":"Runtime parameters enabled","type":"boolean"},"shared_pipelines":{"description":"The names of the pipelines which this prototype shares.","items":{"properties":{"name":{"description":"Name of the pipeline.","title":"Pipeline Name","type":"string"}},"required":["name"],"title":"PipelineName","type":"object"},"title":"Pipeline names","type":"array"},"shared_prototype_id":{"description":"The ID of the shared prototype","format":"uuid","title":"Shared Prototype ID","type":"string"},"show_files":{"default":false,"description":"Select `True` if you want your users to be able to view the pipeline files.","title":"Show files","type":"boolean"},"show_metadata_filters":{"default":false,"description":"Select `True` if you want your users to be able to filter the documents by metadata.","title":"Show metadata filters","type":"boolean"}},"required":["expiration_date","shared_prototype_id","created_by_id","link","shared_pipelines","is_revoked","pipeline_names"],"title":"SharedPrototype","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"ctx":{"title":"Context","type":"object"},"input":{"title":"Input"},"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"}}},"description":"Validation Error"}}}
>
  
</StatusCodes>