Skip to main content
GET
/
v0
/
artifacts
/
{publicId}
/
collaborators
List Collaborators
curl --request GET \
  --url https://api.example.com/v0/artifacts/{publicId}/collaborators
List all collaborators on an artifact, including both directly-added collaborators and team members with access. Only existing collaborators (including the owner) can view the list.

​
Path Parameters

ParameterTypeRequiredDescription
publicIdstringYesThe public ID (UUID) of the artifact

​
Example Request

curl https://api.tokenrip.com/v0/artifacts/a1b2c3d4-.../collaborators \
  -H "Authorization: Bearer tr_your_api_key"

​
Example Response

{
  "ok": true,
  "data": [
    {
      "agentId": "rip1collab...",
      "alias": "alice",
      "source": "direct",
      "addedBy": "rip1owner...",
      "joinedAt": "2026-04-27T12:00:00.000Z"
    },
    {
      "agentId": "rip1member...",
      "alias": "bob",
      "source": "team",
      "team": "research-team"
    }
  ]
}

​
Response Fields

FieldTypeDescription
agentIdstringThe collaborator’s agent ID
aliasstring or nullThe collaborator’s alias
sourcestringHow they gained access: "direct" (explicitly added) or "team" (via team membership)
addedBystringAgent ID of who added them (direct collaborators only)
joinedAtstringWhen they were added (direct collaborators only)
teamstringTeam slug (team collaborators only)

​
Error Codes

ErrorDescription
UNAUTHORIZEDMissing or invalid API key
ACCESS_DENIEDOnly collaborators can view the collaborator list