Light mode version of Land Your Home
V1Me

Put My Status

PUT
/v1/me/status

Replaces the status. Omit message and expiresAt to clear them.

Required variables:

  • baseUrl
  • apiKey (needs profile:write)
  • userToken

Authorization

bearerAuth userTokenAuth
AuthorizationBearer <token>

Partner API key (lyh_...): identifies the calling partner, its scopes and rate limit.

In: header

X-User-Token<token>

The user's OAuth 2.1 access token, issued by Land Your Home's OAuth server to this partner's OAuth client. Requests run as this user.

In: header

Response Body

application/json

application/json

application/json

curl -X PUT "https://example.com/v1/me/status"
{  "data": {    "status": "busy",    "message": "In a meeting",    "expiresAt": "2026-11-13T17:00:00+00:00",    "updatedAt": "2026-10-03T09:00:00.000000+00:00"  }}