ApiShare documents
Get pending share requests for an organization
Returns all pending share requests grouped by recipient for the given organization.
Only shares with status WAITING_FOR_ADMIN_DECISION are included.
The caller's organization must match the requested organizationId — a 403 error is returned otherwise.
If a sender or recipient user cannot be found in IAM, a 404 is returned.
Access restricted to roles:
- admin
- producer-admin
Authorization
bearer AuthorizationBearer <token>
In: header
Path Parameters
organizationId*string
UUID of the organization to fetch pending share requests for
Format
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://dev.sweetconnect.io/api/storage/v1/shares/a1b2c3d4-5678-90ab-cdef-1234567890ab/pending-requests"{
"data": [
{
"recipientId": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
"shares": [
{
"shareId": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
"documentId": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
"documentName": "Technical Specification v2.pdf",
"senderEmail": "john.doe@example.com",
"senderName": "John Doe",
"recipientEmail": "jane.smith@example.com",
"recipientName": "Jane Smith",
"createdAt": "2024-01-15T10:30:00.000Z"
}
]
}
]
}{
"errors": [
{
"errorCode": "BadRequest",
"message": "The request payload is invalid.",
"extension": {}
}
]
}{
"errors": [
{
"errorCode": "Unauthorized",
"message": "Authentication is required to access this resource.",
"extension": {}
}
]
}{
"errors": [
{
"errorCode": "NoPermission",
"message": "You do not have permission to access this resource.",
"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": {}
}
]
}