Shared with me show

GET https://app.sulus.ai/api/v1/kb/shared-with-me/{article}

Open a document shared with the current user

Authentication

Send a bearer token created on your dashboard's Developer page:

Authorization: Bearer <YOUR_API_KEY>

Path parameters

article string Required

The document.

Validation: the document's UUID

Stored in knowledge_articles.id

Errors

Status	Meaning	Body
`404`	Document not found, or it does not belong to that library	`{"message":"No query results for model [App\\Models\\KnowledgeArticle] <id>."}`
`403`	Not shared with the caller (and they cannot otherwise view it)	`{"message":"This action is unauthorized."}`
`401`	Missing or invalid bearer token
`403`	Feature knowledge_docs not enabled for the account

Notes

Also resolves for the document's owner/editors themselves (viewing their own document through this URL), not only for share recipients.

curl --request GET \
  --url https://app.sulus.ai/api/v1/kb/shared-with-me/{article} \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

import requests

url = "https://app.sulus.ai/api/v1/kb/shared-with-me/{article}"
headers = {"Authorization": "Bearer <YOUR_API_KEY>"}

response = requests.get(url, headers=headers)
print(response.json())

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	url := "https://app.sulus.ai/api/v1/kb/shared-with-me/{article}"
	req, _ := http.NewRequest("GET", url, nil)
	req.Header.Add("Authorization", "Bearer <YOUR_API_KEY>")
	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}

Response 200

{
    "data": {
        "id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
        "knowledge_base_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "title": "Return Policy",
        "content": "<h2>Returns</h2><p>Items can be returned within 30 days of purchase with a receipt.</p>",
        "status": "published",
        "updated_at": "2026-07-30T14:35:19.000000Z",
        "can_view": true,
        "can_edit": false,
        "shared_by": {
            "id": 42,
            "name": "Jane Cooper",
            "email": "[email protected]"
        },
        "knowledge_base": {
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "My Library"
        }
    }
}

{
    "data": {
        "id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
        "knowledge_base_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "title": "Return Policy",
        "content": "<h2>Returns</h2><p>Items can be returned within 30 days of purchase with a receipt.</p>",
        "status": "published",
        "updated_at": "2026-07-30T14:35:19.000000Z",
        "can_view": true,
        "can_edit": false,
        "shared_by": {
            "id": 42,
            "name": "Jane Cooper",
            "email": "[email protected]"
        },
        "knowledge_base": {
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "My Library"
        }
    }
}