read:self

Reads the account being acted as, as X describes it. It takes no target, so use it to find that account's numeric id, its follower counts, or to check that the connection to X is still good.

The id is worth keeping: several of X's endpoints are addressed by numeric id rather than by handle, and this is the way to learn your own without guessing.

It is not the same question as whoami

okaybot_whoami is free and is about the agent: its name, its cap, what it has spent today. This is a call to X about the X account, and it is charged.

Fields

profile which account. Optional when the agent has one
reason Required over MCP. One short sentence, in the agent's own words, for the person

What comes back

The same user object read:user returns, for the account you are already acting as.

{ "status": "done",
  "ref": "W6ZFQ70K",
  "message": "",
  "data": {
    "data": {
      "id": "1400000000000000001",
      "name": "Playground User",
      "username": "playground_user",
      "created_at": "2024-09-08T14:18:21.362Z",
      "description": "Default playground user for testing API endpoints.",
      "location": "San Francisco, CA",
      "profile_image_url": "https://pbs.twimg.com/profile_images/.../normal.png",
      "protected": false,
      "verified": false,
      "verified_type": "none",
      "public_metrics": {
        "followers_count": 18, "following_count": 23, "tweet_count": 67,
        "listed_count": 10, "like_count": 109, "media_count": 16
      }
    }
  } }