Overview
PUT/follows/{userId}follows

Follow a user (idempotent — one-way, no permission semantics)

Creates the caller→user follow edge. A follow is a subscription, not a grant: it needs no consent and carries no permission weight. Idempotent — repeating the call returns the existing edge (200) instead of creating a second row.

Auth: bearerAuth — calls run as the authenticated user.

Parameters
  • userIdpathstring
Responses
200

The already-existing follow

  • idstring
  • ecosystemIdstring
  • followerIdstring
  • followeeIdstring
  • createdAtstring
Example
{
  "id": "string",
  "ecosystemId": "string",
  "followerId": "string",
  "followeeId": "string",
  "createdAt": "string"
}
201

The created follow

  • idstring
  • ecosystemIdstring
  • followerIdstring
  • followeeIdstring
  • createdAtstring
Example
{
  "id": "string",
  "ecosystemId": "string",
  "followerId": "string",
  "followeeId": "string",
  "createdAt": "string"
}
400

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
401

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
404

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
409

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
Code examples
cURL
curl -X PUT "https://api.agenticdeveloperhub.com/follows/{userId}" \
  -H "Authorization: Bearer YOUR_TOKEN"
JavaScript
const res = await fetch("https://api.agenticdeveloperhub.com/follows/{userId}", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  },
});
const data = await res.json();