ApiShare documents
Get document shares for a user
Returns all pending document shares for the given user ID.
This is a public endpoint — no authentication is required.
The user is identified by their recipient ID (UUID). If no recipient with that ID exists, a 404 is returned.
If the recipient's share status is not WAITING_FOR_ADMIN_DECISION, an empty array is returned rather than an error — this is intentional behavior indicating the share workflow is in a different state.
Each item in the response describes a single shared document, including the document name, the sender's display name and email, and the timestamp the share was created.
Access restricted to roles:
Path Parameters
userId*string
UUID of the recipient user whose pending shares should be fetched
Format
uuidResponse Body
application/json
application/json
application/json
application/json
curl -X GET "https://dev.sweetconnect.io/api/storage/v1/shares/state/a1b2c3d4-5678-90ab-cdef-1234567890ab"{
"data": {
"documentId": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
"documentName": "Technical Specification v2.pdf",
"senderUserName": "John Doe",
"senderUserEmail": "john.doe@example.com",
"createdAt": "2024-01-15T10:30:00.000Z"
}
}{
"errors": [
{
"errorCode": "BadRequest",
"message": "The request payload is invalid.",
"extension": {}
}
]
}{
"errors": [
{
"errorCode": "NotFound",
"message": "The requested resource was not found.",
"extension": {}
}
]
}{
"errors": [
{
"errorCode": "InternalServerError",
"message": "An unexpected error occurred. See logs for further details or create a support ticket.",
"extension": {}
}
]
}