Memos unofficial
POST/api/v1/memos/{memo}/shares

Create a memo share link

Creates a share link that grants read-only access to a memo through an opaque bearer token. The authenticated user must be the memo creator or an instance administrator; set expireTime to limit how long the link works.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 3 body fields
memostringrequired
The identifier of the memo to create a share link for.

A memo share access grant, optionally configured with an expiration time.

namestringoptional
The resource name of the share. Format: memos/{memo}/shares/{share} The {share} segment is the opaque token used in the share URL.
createTimestringoptional
Output only. When this share link was created.
expireTimestringoptional
Optional. When set, the share link stops working after this time. If unset, the link never expires.

2 status codes
200Returns the created share resource, including its resource name, creation time, and optional expiration time.
namestringoptional
The resource name of the share. Format: memos/{memo}/shares/{share} The {share} segment is the opaque token used in the share URL.
createTimestringoptional
Output only. When this share link was created.
expireTimestringoptional
Optional. When set, the share link stops working after this time. If unset, the link never expires.
defaultDefault error response
codeintegeroptional
The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
messagestringoptional
A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
detailsarray<object>optional
A list of messages that carry the error details. There is a common set of message types for APIs to use.

Error handling

The memo path parameter must identify a memo that the authenticated user created or administers. If supplied, expireTime must be an ISO 8601 date-time; createTime is output-only.