---
title: "Create Sharable Entity"
method: POST
path: "/api/svc-registry/sharable-entities"
tags: ["svc-registry", "svc-registry"]
---

# Create Sharable Entity

`POST /api/svc-registry/sharable-entities`

Link a new ``sharable_entity`` to the caller's registered module instance.

## Request body

- CreateSharableEntityRequest — Payload for ``POST /api/svc-registry/sharable-entities``. ``module`` must be one of the calling app's registered authorization modules. ``resourceId`` is the app-defined identifier — it lives in the ``sharable_entity:<scope>/<app>/<module>/<resource>`` FGA object, so it must be a single path segment.
  - `resourceId` string, required
  - `module` string, required

## Response `201`

Successful Response

- SharableEntityResponse — Response body for sharable-entity creation / removal. Returns the resolved FGA identifiers so callers can audit exactly which tuple was written without re-deriving the path themselves.
  - `applicationId` string, required
  - `module` string, required
  - `resourceId` string, required
  - `scopeKind` string, required
  - `scopeId` string, required
  - `objectId` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/gocrisp/apis/crisp-app-dock.md) · [All operations](https://skmtc.dev/gocrisp/apis/crisp-app-dock/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gocrisp/crisp-app-dock/revisions/e56bd3c1a9db/schema)