Skip to main content

Sharing API

Manage user-to-user sharing permissions.

Endpoints​

POST /sharing​

POST Create a user-to-user sharing permission.

curl -X POST "https://api.ofself.ai/api/v1/sharing" \
  -H "Authorization: Bearer your-jwt-token" \
  -H "Content-Type: application/json" \
  -d '{
    "shared_with_user_id": "user-uuid",
    "scope": "specific_tags",
    "tag_ids": ["tag-uuid-1", "tag-uuid-2"],
    "can_read": true,
    "can_write": false,
    "can_delete": false,
    "can_share": false,
    "expires_at": "2026-12-31T00:00:00Z"
  }'

Scopes

  • all: share everything
  • specific_tags: share nodes that have these tags (and their relationships)
  • specific_nodes: share only selected nodes
  • graph: reserved / optional (implementation-specific)

GET /sharing/outgoing​

GET List shares you've granted to other users.

curl -X GET "https://api.ofself.ai/api/v1/sharing/outgoing?limit=20&offset=0" \
  -H "Authorization: Bearer your-jwt-token"

GET /sharing/incoming​

GET List shares granted to you by other users.

curl -X GET "https://api.ofself.ai/api/v1/sharing/incoming?limit=20&offset=0" \
  -H "Authorization: Bearer your-jwt-token"

GET /sharing/:share_id​

GET Get share details.

DELETE /sharing/:share_id​

DELETE Revoke a share.

curl -X DELETE "https://api.ofself.ai/api/v1/sharing/share_abc" \
  -H "Authorization: Bearer your-jwt-token"

Following is built on sharing permissions:

  • Accepting a follow request creates a read-only sharing permission.
  • Public profiles auto-create read-only sharing on follow.

See Follows API.