Actors & Repos
Actor endpoints resolve Tangled handles and DIDs, fetching profile and repo
data from the actor’s PDS. Repo sub-resource endpoints proxy live data
from the actor’s assigned knot host.
GET /actors/{handle}
Tangled actor profile with optional Bluesky social data.
Resolves handle to DID, fetches sh.tangled.actor.profile from the actor's PDS. If the profile record has bluesky:true, Bluesky display name and avatar are also returned.
Path parameters
| Name | Type | Description |
|---|
handle |
string |
Tangled handle or DID. |
GET /actors/{handle}/repos
List all sh.tangled.repo records for an actor.
Path parameters
| Name | Type | Description |
|---|
handle |
string |
Tangled handle or DID. |
GET /actors/{handle}/repos/{repo}
Repo record with resolved knot host and AT URI.
Path parameters
| Name | Type | Description |
|---|
handle |
string |
Tangled handle or DID. |
repo |
string |
Repository name. |
GET /actors/{handle}/repos/{repo}/tree
Directory tree for a ref, proxied from the actor's knot.
Path parameters
| Name | Type | Description |
|---|
handle |
string |
Tangled handle or DID. |
repo |
string |
Repository name. |
Query parameters
| Name | Type | Required | Description |
|---|
ref |
string |
— |
Branch, tag, or commit SHA. Defaults to default branch. |
path |
string |
— |
Subdirectory path within the tree. |
GET /actors/{handle}/repos/{repo}/blob
File contents at a path and ref, proxied from the actor's knot.
Path parameters
| Name | Type | Description |
|---|
handle |
string |
Tangled handle or DID. |
repo |
string |
Repository name. |
Query parameters
| Name | Type | Required | Description |
|---|
ref |
string |
— |
Branch, tag, or commit SHA. |
path |
string |
yes |
File path within the repository. |
GET /actors/{handle}/repos/{repo}/log
Commit log for a ref, proxied from the actor's knot (raw bytes).
Path parameters
| Name | Type | Description |
|---|
handle |
string |
Tangled handle or DID. |
repo |
string |
Repository name. |
Query parameters
| Name | Type | Required | Description |
|---|
ref |
string |
— |
Branch, tag, or commit SHA. |
path |
string |
— |
Limit log to commits touching this path. |
limit |
int |
— |
Max commits to return. |
cursor |
string |
— |
Pagination cursor from a previous response. |
GET /actors/{handle}/repos/{repo}/branches
Branch list for a repo, proxied from the actor's knot (raw bytes).
Path parameters
| Name | Type | Description |
|---|
handle |
string |
Tangled handle or DID. |
repo |
string |
Repository name. |
Query parameters
| Name | Type | Required | Description |
|---|
limit |
int |
— |
Max branches to return. |
cursor |
string |
— |
Pagination cursor. |
GET /actors/{handle}/repos/{repo}/default-branch
Default branch name for a repo, proxied from the actor's knot.
Path parameters
| Name | Type | Description |
|---|
handle |
string |
Tangled handle or DID. |
repo |
string |
Repository name. |
GET /actors/{handle}/repos/{repo}/languages
Language breakdown for a repo at a ref, proxied from the actor's knot.
Path parameters
| Name | Type | Description |
|---|
handle |
string |
Tangled handle or DID. |
repo |
string |
Repository name. |
Query parameters
| Name | Type | Required | Description |
|---|
ref |
string |
— |
Branch, tag, or commit SHA. |
GET /actors/{handle}/repos/{repo}/tags
Tag list for a repo, proxied from the actor's knot (raw bytes).
Path parameters
| Name | Type | Description |
|---|
handle |
string |
Tangled handle or DID. |
repo |
string |
Repository name. |
GET /actors/{handle}/repos/{repo}/diff
Diff for a ref, proxied from the actor's knot (raw bytes).
Path parameters
| Name | Type | Description |
|---|
handle |
string |
Tangled handle or DID. |
repo |
string |
Repository name. |
Query parameters
| Name | Type | Required | Description |
|---|
ref |
string |
— |
Commit SHA or branch to diff. |
GET /actors/{handle}/repos/{repo}/compare
Comparison between two refs, proxied from the actor's knot (raw bytes).
Path parameters
| Name | Type | Description |
|---|
handle |
string |
Tangled handle or DID. |
repo |
string |
Repository name. |
Query parameters
| Name | Type | Required | Description |
|---|
from |
string |
yes |
Base ref (branch, tag, or SHA). |
to |
string |
yes |
Head ref (branch, tag, or SHA). |
GET /actors/{handle}/repos/{repo}/issues
Issues scoped to a repo, pre-joined with state (open/closed).
Path parameters
| Name | Type | Description |
|---|
handle |
string |
Tangled handle or DID. |
repo |
string |
Repository name. |
GET /actors/{handle}/repos/{repo}/pulls
Pull requests targeting a repo, pre-joined with status (open/closed/merged).
Path parameters
| Name | Type | Description |
|---|
handle |
string |
Tangled handle or DID. |
repo |
string |
Repository name. |
GET /actors/{handle}/issues
All issues authored by an actor, pre-joined with state.
Path parameters
| Name | Type | Description |
|---|
handle |
string |
Tangled handle or DID. |
GET /actors/{handle}/pulls
All pull requests authored by an actor, pre-joined with status.
Path parameters
| Name | Type | Description |
|---|
handle |
string |
Tangled handle or DID. |
GET /actors/{handle}/following
sh.tangled.graph.follow records for an actor.
Path parameters
| Name | Type | Description |
|---|
handle |
string |
Tangled handle or DID. |
GET /actors/{handle}/strings
sh.tangled.string records posted by an actor.
Path parameters
| Name | Type | Description |
|---|
handle |
string |
Tangled handle or DID. |