Namespaces
Create a namespace portal link
Creates a reusable hosted portal link without a Samva account.
POST
Creates a reusable hosted portal link without a Samva account. Only organization-wide callers may mint links. The token appears once in the returned URL fragment; Samva stores only its hash. expiresIn is seconds, defaults to 7 days, and cannot exceed 30 days.
apiKeyheader
x-api-key<token>id*stringMatch
^ns_[0-9a-hjkmnp-tv-z]{16,24}$application/json- body
redirectUrl?|nullmetadata?|nullexpiresIn?|nullCreatedNamespacePortalLink
application/json- response
id*NamespacePortalLinkIdMatch
^npl_[0-9a-hjkmnp-tv-z]{16,24}$organizationId*OrganizationIdMatch
^org_[0-9a-hjkmnp-tv-z]{16,24}$namespaceId*NamespaceIdMatch
^ns_[0-9a-hjkmnp-tv-z]{16,24}$createdBy*UserIdMatch
^user_[0-9a-hjkmnp-tv-z]{16,24}$expiresAt*stringrevokedAt*string|nullredirectUrl*string|nullmetadata*createdAt*stringurl*stringimport { createClient } from "samva";
const samva = createClient({ apiKey: process.env.SAMVA_API_KEY! });
const result = await samva.namespaces.createPortalLink({
"id": "example"
});Example Response
{
"id": "string",
"organizationId": "string",
"namespaceId": "string",
"createdBy": "string",
"expiresAt": "string",
"revokedAt": "string",
"redirectUrl": "string",
"metadata": {
"property1": "string",
"property2": "string"
},
"createdAt": "string",
"url": "string"
}