# Focus · Mastodon API

> Typed Focus mode operations for Mastodon accounts, generated from the Mastodon focus module (same behaviour as the generic /accounts/{accountId}/focus routes).

Base URL: `https://api.socialit.com/v1`. Authenticate with `Authorization: Bearer <API key or OAuth token>`.

## Mastodon: List Posts

`GET /accounts/{accountId}/mastodon/statuses`

Own statuses (GET /api/v1/accounts/:id/statuses). Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `read` · MCP tool: `mastodon-statuses-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)
- `account_id` (string): Defaults to the connected account
- `only_media` (boolean)
- `exclude_replies` (boolean)
- `exclude_reblogs` (boolean)
- `pinned` (boolean)
- `tagged` (string)
- `exclude_direct` (boolean): Mastodon 4.6+

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "https://example.com",
      "url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "edited_at": "2026-10-13T09:00:00.000Z",
      "text": "string",
      "content": "string",
      "spoiler_text": "string",
      "sensitive": true,
      "visibility": "public",
      "language": "en",
      "in_reply_to_id": "string",
      "in_reply_to_account_id": "string",
      "replies_count": 1,
      "reblogs_count": 1,
      "favourites_count": 1,
      "quotes_count": 1,
      "author": "string",
      "author_name": "string",
      "media_attachments": [
        {
          "id": "string",
          "type": "image",
          "url": "https://example.com",
          "preview_url": "https://example.com",
          "remote_url": "https://example.com",
          "description": "string"
        }
      ],
      "poll": {
        "id": "string",
        "expires_at": "2026-10-13T09:00:00.000Z",
        "expired": true,
        "multiple": true,
        "votes_count": 1,
        "voters_count": 1
      },
      "favourited": true,
      "reblogged": true,
      "bookmarked": true,
      "muted": true,
      "pinned": true,
      "is_reblog": true,
      "quote": {
        "state": "string",
        "quoted_status": {}
      },
      "quote_approval": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Create a Posts item

`POST /accounts/{accountId}/mastodon/statuses`

Publish (media, poll, CW, quote, schedule, thread). Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `write` · MCP tool: `mastodon-statuses-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `status` (string): Plain text; URLs count as 23 characters
- `visibility` (string; one of public, unlisted, private, direct)
- `spoiler_text` (string)
- `sensitive` (boolean)
- `language` (string): ISO 639-1
- `media` (array of string): Socialit media ids (uploaded to the instance on publish)
- `media_ids` (array of string): Already-uploaded Mastodon media ids
- `alt_texts` (array of string): Alt text per media item, by index
- `poll` (object)
  - `poll.options` (array of string; ≥ 2 items)
  - `poll.expires_in` (integer)
  - `poll.multiple` (boolean)
  - `poll.hide_totals` (boolean)
- `in_reply_to_id` (string)
- `quoted_status_id` (string): Mastodon 4.5+
- `quote_approval_policy` (string; one of public, followers, nobody)
- `scheduled_at` (string (date-time)): ≥ 5 minutes ahead → ScheduledStatus
- `thread` (array of string): Follow-up replies posted as a self-thread

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en"
  }'
```

Response 201:

```json
{
  "id": "string",
  "uri": "https://example.com",
  "url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "edited_at": "2026-10-13T09:00:00.000Z",
  "text": "string",
  "content": "string",
  "spoiler_text": "string",
  "sensitive": true,
  "visibility": "public",
  "language": "en",
  "in_reply_to_id": "string",
  "in_reply_to_account_id": "string",
  "replies_count": 1,
  "reblogs_count": 1,
  "favourites_count": 1,
  "quotes_count": 1,
  "author": "string",
  "author_name": "string",
  "media_attachments": [
    {
      "id": "string",
      "type": "image",
      "url": "https://example.com",
      "preview_url": "https://example.com",
      "remote_url": "https://example.com",
      "description": "string",
      "blurhash": "string",
      "meta": {}
    }
  ],
  "poll": {
    "id": "string",
    "expires_at": "2026-10-13T09:00:00.000Z",
    "expired": true,
    "multiple": true,
    "votes_count": 1,
    "voters_count": 1,
    "voted": true,
    "own_votes": [
      1
    ],
    "options": [
      {
        "title": "string",
        "votes_count": 1
      }
    ]
  },
  "favourited": true,
  "reblogged": true,
  "bookmarked": true,
  "muted": true,
  "pinned": true,
  "is_reblog": true,
  "quote": {
    "state": "string",
    "quoted_status": {}
  },
  "quote_approval": {}
}
```

## Mastodon: Get a Posts item

`GET /accounts/{accountId}/mastodon/statuses/{itemId}`

Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `read` · MCP tool: `mastodon-statuses-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "uri": "https://example.com",
  "url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "edited_at": "2026-10-13T09:00:00.000Z",
  "text": "string",
  "content": "string",
  "spoiler_text": "string",
  "sensitive": true,
  "visibility": "public",
  "language": "en",
  "in_reply_to_id": "string",
  "in_reply_to_account_id": "string",
  "replies_count": 1,
  "reblogs_count": 1,
  "favourites_count": 1,
  "quotes_count": 1,
  "author": "string",
  "author_name": "string",
  "media_attachments": [
    {
      "id": "string",
      "type": "image",
      "url": "https://example.com",
      "preview_url": "https://example.com",
      "remote_url": "https://example.com",
      "description": "string",
      "blurhash": "string",
      "meta": {}
    }
  ],
  "poll": {
    "id": "string",
    "expires_at": "2026-10-13T09:00:00.000Z",
    "expired": true,
    "multiple": true,
    "votes_count": 1,
    "voters_count": 1,
    "voted": true,
    "own_votes": [
      1
    ],
    "options": [
      {
        "title": "string",
        "votes_count": 1
      }
    ]
  },
  "favourited": true,
  "reblogged": true,
  "bookmarked": true,
  "muted": true,
  "pinned": true,
  "is_reblog": true,
  "quote": {
    "state": "string",
    "quoted_status": {}
  },
  "quote_approval": {}
}
```

## Mastodon: Update a Posts item

`PATCH /accounts/{accountId}/mastodon/statuses/{itemId}`

Edit (PUT /api/v1/statuses/:id); visibility cannot change. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `write` · MCP tool: `mastodon-statuses-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `status` (string)
- `spoiler_text` (string)
- `sensitive` (boolean)
- `language` (string)
- `media_ids` (array of string): Final list of attachment ids (omit to keep)
- `media` (array of string): New Socialit media to upload and append
- `media_attributes` (array of object)
  - `media_attributes[].id` (string)
  - `media_attributes[].description` (string)
  - `media_attributes[].focus` (string): "x,y"
- `poll` (object | null)
  - `poll.options` (array of string)
  - `poll.expires_in` (integer)
  - `poll.multiple` (boolean)
  - `poll.hide_totals` (boolean)
- `quote_approval_policy` (string; one of public, followers, nobody)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en",
    "media_ids": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "id": "string",
  "uri": "https://example.com",
  "url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "edited_at": "2026-10-13T09:00:00.000Z",
  "text": "string",
  "content": "string",
  "spoiler_text": "string",
  "sensitive": true,
  "visibility": "public",
  "language": "en",
  "in_reply_to_id": "string",
  "in_reply_to_account_id": "string",
  "replies_count": 1,
  "reblogs_count": 1,
  "favourites_count": 1,
  "quotes_count": 1,
  "author": "string",
  "author_name": "string",
  "media_attachments": [
    {
      "id": "string",
      "type": "image",
      "url": "https://example.com",
      "preview_url": "https://example.com",
      "remote_url": "https://example.com",
      "description": "string",
      "blurhash": "string",
      "meta": {}
    }
  ],
  "poll": {
    "id": "string",
    "expires_at": "2026-10-13T09:00:00.000Z",
    "expired": true,
    "multiple": true,
    "votes_count": 1,
    "voters_count": 1,
    "voted": true,
    "own_votes": [
      1
    ],
    "options": [
      {
        "title": "string",
        "votes_count": 1
      }
    ]
  },
  "favourited": true,
  "reblogged": true,
  "bookmarked": true,
  "muted": true,
  "pinned": true,
  "is_reblog": true,
  "quote": {
    "state": "string",
    "quoted_status": {}
  },
  "quote_approval": {}
}
```

## Mastodon: Delete a Posts item

`DELETE /accounts/{accountId}/mastodon/statuses/{itemId}`

Delete (and its media). Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `write` · MCP tool: `mastodon-statuses-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: Pin to profile (Posts)

`POST /accounts/{accountId}/mastodon/statuses/{itemId}/pin`

Pin to profile. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:accounts. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `write` · MCP tool: `mastodon-statuses-pin`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/pin" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unpin (Posts)

`POST /accounts/{accountId}/mastodon/statuses/{itemId}/unpin`

Unpin. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:accounts. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `write` · MCP tool: `mastodon-statuses-unpin`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/unpin" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Boost (Posts)

`POST /accounts/{accountId}/mastodon/statuses/{itemId}/boost`

Boost. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `write` · MCP tool: `mastodon-statuses-boost`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `visibility` (string; one of public, unlisted, private)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/boost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "visibility": "public"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Undo boost (Posts)

`POST /accounts/{accountId}/mastodon/statuses/{itemId}/unboost`

Undo boost. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `write` · MCP tool: `mastodon-statuses-unboost`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/unboost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Favourite (Posts)

`POST /accounts/{accountId}/mastodon/statuses/{itemId}/favourite`

Favourite. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:favourites. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `write` · MCP tool: `mastodon-statuses-favourite`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/favourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unfavourite (Posts)

`POST /accounts/{accountId}/mastodon/statuses/{itemId}/unfavourite`

Unfavourite. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:favourites. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `write` · MCP tool: `mastodon-statuses-unfavourite`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/unfavourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Bookmark (Posts)

`POST /accounts/{accountId}/mastodon/statuses/{itemId}/bookmark`

Bookmark. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `write` · MCP tool: `mastodon-statuses-bookmark`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Remove bookmark (Posts)

`POST /accounts/{accountId}/mastodon/statuses/{itemId}/unbookmark`

Remove bookmark. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `write` · MCP tool: `mastodon-statuses-unbookmark`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/unbookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Mute conversation (Posts)

`POST /accounts/{accountId}/mastodon/statuses/{itemId}/mute`

Mute conversation. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:mutes. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `write` · MCP tool: `mastodon-statuses-mute`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/mute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unmute conversation (Posts)

`POST /accounts/{accountId}/mastodon/statuses/{itemId}/unmute`

Unmute conversation. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:mutes. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `write` · MCP tool: `mastodon-statuses-unmute`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/unmute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Reply / continue thread (Posts)

`POST /accounts/{accountId}/mastodon/statuses/{itemId}/reply`

Reply / continue thread. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `write` · MCP tool: `mastodon-statuses-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `status` (string): Plain text; URLs count as 23 characters
- `visibility` (string; one of public, unlisted, private, direct)
- `spoiler_text` (string)
- `sensitive` (boolean)
- `language` (string): ISO 639-1
- `media` (array of string): Socialit media ids (uploaded to the instance on publish)
- `media_ids` (array of string): Already-uploaded Mastodon media ids
- `alt_texts` (array of string): Alt text per media item, by index
- `poll` (object)
  - `poll.options` (array of string; ≥ 2 items)
  - `poll.expires_in` (integer)
  - `poll.multiple` (boolean)
  - `poll.hide_totals` (boolean)
- `in_reply_to_id` (string)
- `quoted_status_id` (string): Mastodon 4.5+
- `quote_approval_policy` (string; one of public, followers, nobody)
- `scheduled_at` (string (date-time)): ≥ 5 minutes ahead → ScheduledStatus
- `thread` (array of string): Follow-up replies posted as a self-thread

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Translate (Posts)

`POST /accounts/{accountId}/mastodon/statuses/{itemId}/translate`

Translate. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `write` · MCP tool: `mastodon-statuses-translate`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `lang` (string): Target ISO 639-1 (default: user locale)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/translate" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "lang": "string"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Edit history (Posts)

`POST /accounts/{accountId}/mastodon/statuses/{itemId}/history`

Edit history. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `write` · MCP tool: `mastodon-statuses-history`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/history" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Source text (Posts)

`POST /accounts/{accountId}/mastodon/statuses/{itemId}/source`

Source text. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `write` · MCP tool: `mastodon-statuses-source`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/source" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Thread (Posts)

`POST /accounts/{accountId}/mastodon/statuses/{itemId}/context`

Thread. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `write` · MCP tool: `mastodon-statuses-context`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/context" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Delete & redraft (Posts)

`POST /accounts/{accountId}/mastodon/statuses/{itemId}/redraft`

Deletes the status (keeping media) and re-posts it with optional changes. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Destructive. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `write` · MCP tool: `mastodon-statuses-redraft`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `status` (string)
- `spoiler_text` (string)
- `visibility` (string; one of public, unlisted, private, direct)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/redraft" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "spoiler_text": "string",
    "visibility": "public"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Favourited by (Posts)

`POST /accounts/{accountId}/mastodon/statuses/{itemId}/favourited-by`

Favourited by. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `write` · MCP tool: `mastodon-statuses-favourited-by`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/favourited-by" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "cursor": "string",
    "limit": 20
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Boosted by (Posts)

`POST /accounts/{accountId}/mastodon/statuses/{itemId}/reblogged-by`

Boosted by. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `write` · MCP tool: `mastodon-statuses-reblogged-by`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/reblogged-by" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "cursor": "string",
    "limit": 20
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Quotes of this post (Posts)

`POST /accounts/{accountId}/mastodon/statuses/{itemId}/quotes`

Quotes of this post. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `write` · MCP tool: `mastodon-statuses-quotes`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/quotes" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "cursor": "string",
    "limit": 20
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Revoke a quote (Posts)

`POST /accounts/{accountId}/mastodon/statuses/{itemId}/revoke-quote`

Revoke a quote. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Destructive. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `write` · MCP tool: `mastodon-statuses-revoke-quote`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `quoting_status_id` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/revoke-quote" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "quoting_status_id": "string"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Who can quote (Posts)

`POST /accounts/{accountId}/mastodon/statuses/{itemId}/interaction-policy`

Who can quote. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.

Access: `write` · MCP tool: `mastodon-statuses-interaction-policy`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `quote_approval_policy` (string; required; one of public, followers, nobody)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/interaction-policy" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "quote_approval_policy": "public"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Scheduled posts

`GET /accounts/{accountId}/mastodon/scheduled-statuses`

Statuses scheduled natively on the instance (from any client). Content is fixed; only the date can change. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/scheduled_statuses/ Generic route: /v1/accounts/{accountId}/focus/scheduled-statuses.

Access: `read` · MCP tool: `mastodon-scheduled-statuses-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/scheduled-statuses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "scheduled_at": "2026-10-13T09:00:00.000Z",
      "text": "string",
      "visibility": "public",
      "spoiler_text": "string",
      "media_count": 1,
      "poll_options": [
        "string"
      ],
      "params": {},
      "media_attachments": [
        {
          "id": "string",
          "type": "image",
          "url": "https://example.com",
          "preview_url": "https://example.com",
          "remote_url": "https://example.com",
          "description": "string"
        }
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Create a Scheduled posts item

`POST /accounts/{accountId}/mastodon/scheduled-statuses`

Schedule natively (≥ 5 min ahead, max 300 pending / 25 per day). Statuses scheduled natively on the instance (from any client). Content is fixed; only the date can change. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/scheduled_statuses/ Generic route: /v1/accounts/{accountId}/focus/scheduled-statuses.

Access: `write` · MCP tool: `mastodon-scheduled-statuses-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `status` (string): Plain text; URLs count as 23 characters
- `visibility` (string; one of public, unlisted, private, direct)
- `spoiler_text` (string)
- `sensitive` (boolean)
- `language` (string): ISO 639-1
- `media` (array of string): Socialit media ids (uploaded to the instance on publish)
- `media_ids` (array of string): Already-uploaded Mastodon media ids
- `alt_texts` (array of string): Alt text per media item, by index
- `poll` (object)
  - `poll.options` (array of string; ≥ 2 items)
  - `poll.expires_in` (integer)
  - `poll.multiple` (boolean)
  - `poll.hide_totals` (boolean)
- `in_reply_to_id` (string)
- `quoted_status_id` (string): Mastodon 4.5+
- `quote_approval_policy` (string; one of public, followers, nobody)
- `scheduled_at` (string (date-time); required): ≥ 5 minutes ahead → ScheduledStatus
- `thread` (array of string): Follow-up replies posted as a self-thread

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/scheduled-statuses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "scheduled_at": "2026-10-13T09:00:00.000Z"
  }'
```

Response 201:

```json
{
  "id": "string",
  "scheduled_at": "2026-10-13T09:00:00.000Z",
  "text": "string",
  "visibility": "public",
  "spoiler_text": "string",
  "media_count": 1,
  "poll_options": [
    "string"
  ],
  "params": {},
  "media_attachments": [
    {
      "id": "string",
      "type": "image",
      "url": "https://example.com",
      "preview_url": "https://example.com",
      "remote_url": "https://example.com",
      "description": "string",
      "blurhash": "string",
      "meta": {}
    }
  ]
}
```

## Mastodon: Get a Scheduled posts item

`GET /accounts/{accountId}/mastodon/scheduled-statuses/{itemId}`

Statuses scheduled natively on the instance (from any client). Content is fixed; only the date can change. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/scheduled_statuses/ Generic route: /v1/accounts/{accountId}/focus/scheduled-statuses.

Access: `read` · MCP tool: `mastodon-scheduled-statuses-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/scheduled-statuses/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "scheduled_at": "2026-10-13T09:00:00.000Z",
  "text": "string",
  "visibility": "public",
  "spoiler_text": "string",
  "media_count": 1,
  "poll_options": [
    "string"
  ],
  "params": {},
  "media_attachments": [
    {
      "id": "string",
      "type": "image",
      "url": "https://example.com",
      "preview_url": "https://example.com",
      "remote_url": "https://example.com",
      "description": "string",
      "blurhash": "string",
      "meta": {}
    }
  ]
}
```

## Mastodon: Update a Scheduled posts item

`PATCH /accounts/{accountId}/mastodon/scheduled-statuses/{itemId}`

Reschedule. Statuses scheduled natively on the instance (from any client). Content is fixed; only the date can change. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/scheduled_statuses/ Generic route: /v1/accounts/{accountId}/focus/scheduled-statuses.

Access: `write` · MCP tool: `mastodon-scheduled-statuses-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `scheduled_at` (string (date-time); required)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/scheduled-statuses/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scheduled_at": "2026-10-13T09:00:00.000Z"
  }'
```

Response 200:

```json
{
  "id": "string",
  "scheduled_at": "2026-10-13T09:00:00.000Z",
  "text": "string",
  "visibility": "public",
  "spoiler_text": "string",
  "media_count": 1,
  "poll_options": [
    "string"
  ],
  "params": {},
  "media_attachments": [
    {
      "id": "string",
      "type": "image",
      "url": "https://example.com",
      "preview_url": "https://example.com",
      "remote_url": "https://example.com",
      "description": "string",
      "blurhash": "string",
      "meta": {}
    }
  ]
}
```

## Mastodon: Delete a Scheduled posts item

`DELETE /accounts/{accountId}/mastodon/scheduled-statuses/{itemId}`

Statuses scheduled natively on the instance (from any client). Content is fixed; only the date can change. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/scheduled_statuses/ Generic route: /v1/accounts/{accountId}/focus/scheduled-statuses.

Access: `write` · MCP tool: `mastodon-scheduled-statuses-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/scheduled-statuses/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: List Polls

`GET /accounts/{accountId}/mastodon/polls`

Own statuses that carry a poll. Your polls and their results; vote in any poll. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/polls/ Generic route: /v1/accounts/{accountId}/focus/polls.

Access: `read` · MCP tool: `mastodon-polls-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/polls" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "expires_at": "2026-10-13T09:00:00.000Z",
      "expired": true,
      "multiple": true,
      "votes_count": 1,
      "voters_count": 1,
      "voted": true,
      "own_votes": [
        1
      ],
      "options": [
        {
          "title": "string",
          "votes_count": 1
        }
      ],
      "status_id": "string",
      "question": "string",
      "created_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Get a Polls item

`GET /accounts/{accountId}/mastodon/polls/{itemId}`

Your polls and their results; vote in any poll. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/polls/ Generic route: /v1/accounts/{accountId}/focus/polls.

Access: `read` · MCP tool: `mastodon-polls-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/polls/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "expires_at": "2026-10-13T09:00:00.000Z",
  "expired": true,
  "multiple": true,
  "votes_count": 1,
  "voters_count": 1,
  "voted": true,
  "own_votes": [
    1
  ],
  "options": [
    {
      "title": "string",
      "votes_count": 1
    }
  ],
  "status_id": "string",
  "question": "string",
  "created_at": "2026-10-13T09:00:00.000Z"
}
```

## Mastodon: Vote (Polls)

`POST /accounts/{accountId}/mastodon/polls/{itemId}/vote`

Vote. Your polls and their results; vote in any poll. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/polls/ Generic route: /v1/accounts/{accountId}/focus/polls.

Access: `write` · MCP tool: `mastodon-polls-vote`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `choices` (array of integer; required; ≥ 1 items)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/polls/ITEM_ID/vote" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "choices": [
      0
    ]
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Get a Media item

`GET /accounts/{accountId}/mastodon/media/{itemId}`

Upload media, edit alt text / focal point before attaching, delete unattached uploads (unattached media is purged after 1 day). Requires scopes: write:media. Network docs: https://docs.joinmastodon.org/methods/media/ Generic route: /v1/accounts/{accountId}/focus/media.

Access: `read` · MCP tool: `mastodon-media-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/media/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "type": "image",
  "url": "https://example.com",
  "preview_url": "https://example.com",
  "remote_url": "https://example.com",
  "description": "string",
  "blurhash": "string",
  "meta": {}
}
```

## Mastodon: Update a Media item

`PATCH /accounts/{accountId}/mastodon/media/{itemId}`

Alt text / focal point (only before attaching; afterwards edit the status media_attributes). Upload media, edit alt text / focal point before attaching, delete unattached uploads (unattached media is purged after 1 day). Requires scopes: write:media. Network docs: https://docs.joinmastodon.org/methods/media/ Generic route: /v1/accounts/{accountId}/focus/media.

Access: `write` · MCP tool: `mastodon-media-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `description` (string)
- `focus` (string)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/media/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "string",
    "focus": "string"
  }'
```

Response 200:

```json
{
  "id": "string",
  "type": "image",
  "url": "https://example.com",
  "preview_url": "https://example.com",
  "remote_url": "https://example.com",
  "description": "string",
  "blurhash": "string",
  "meta": {}
}
```

## Mastodon: Delete a Media item

`DELETE /accounts/{accountId}/mastodon/media/{itemId}`

Delete unattached media (4.4+). Upload media, edit alt text / focal point before attaching, delete unattached uploads (unattached media is purged after 1 day). Requires scopes: write:media. Network docs: https://docs.joinmastodon.org/methods/media/ Generic route: /v1/accounts/{accountId}/focus/media.

Access: `write` · MCP tool: `mastodon-media-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/media/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: Create a Media item

`POST /accounts/{accountId}/mastodon/media`

POST /api/v2/media (waits for processing). Upload media, edit alt text / focal point before attaching, delete unattached uploads (unattached media is purged after 1 day). Requires scopes: write:media. Network docs: https://docs.joinmastodon.org/methods/media/ Generic route: /v1/accounts/{accountId}/focus/media.

Access: `write` · MCP tool: `mastodon-media-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `media` (string): Socialit media id
- `url` (string (uri)): Or a public URL
- `description` (string)
- `focus` (string): "x,y" in -1.0..1.0
- `thumbnail` (string): Custom thumbnail (video/audio)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/media" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "media": "string",
    "url": "https://example.com",
    "description": "string",
    "focus": "string",
    "thumbnail": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "type": "image",
  "url": "https://example.com",
  "preview_url": "https://example.com",
  "remote_url": "https://example.com",
  "description": "string",
  "blurhash": "string",
  "meta": {}
}
```

## Mastodon: List Pinned posts

`GET /accounts/{accountId}/mastodon/pinned-statuses`

Statuses pinned to your profile (max configuration.accounts.max_pinned_statuses, default 5). Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/#pin Generic route: /v1/accounts/{accountId}/focus/pinned-statuses.

Access: `read` · MCP tool: `mastodon-pinned-statuses-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/pinned-statuses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "https://example.com",
      "url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "edited_at": "2026-10-13T09:00:00.000Z",
      "text": "string",
      "content": "string",
      "spoiler_text": "string",
      "sensitive": true,
      "visibility": "public",
      "language": "en",
      "in_reply_to_id": "string",
      "in_reply_to_account_id": "string",
      "replies_count": 1,
      "reblogs_count": 1,
      "favourites_count": 1,
      "quotes_count": 1,
      "author": "string",
      "author_name": "string",
      "media_attachments": [
        {
          "id": "string",
          "type": "image",
          "url": "https://example.com",
          "preview_url": "https://example.com",
          "remote_url": "https://example.com",
          "description": "string"
        }
      ],
      "poll": {
        "id": "string",
        "expires_at": "2026-10-13T09:00:00.000Z",
        "expired": true,
        "multiple": true,
        "votes_count": 1,
        "voters_count": 1
      },
      "favourited": true,
      "reblogged": true,
      "bookmarked": true,
      "muted": true,
      "pinned": true,
      "is_reblog": true,
      "quote": {
        "state": "string",
        "quoted_status": {}
      },
      "quote_approval": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Create a Pinned posts item

`POST /accounts/{accountId}/mastodon/pinned-statuses`

Statuses pinned to your profile (max configuration.accounts.max_pinned_statuses, default 5). Requires scopes: read:statuses, write:accounts. Network docs: https://docs.joinmastodon.org/methods/statuses/#pin Generic route: /v1/accounts/{accountId}/focus/pinned-statuses.

Access: `write` · MCP tool: `mastodon-pinned-statuses-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `status_id` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/pinned-statuses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status_id": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "uri": "https://example.com",
  "url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "edited_at": "2026-10-13T09:00:00.000Z",
  "text": "string",
  "content": "string",
  "spoiler_text": "string",
  "sensitive": true,
  "visibility": "public",
  "language": "en",
  "in_reply_to_id": "string",
  "in_reply_to_account_id": "string",
  "replies_count": 1,
  "reblogs_count": 1,
  "favourites_count": 1,
  "quotes_count": 1,
  "author": "string",
  "author_name": "string",
  "media_attachments": [
    {
      "id": "string",
      "type": "image",
      "url": "https://example.com",
      "preview_url": "https://example.com",
      "remote_url": "https://example.com",
      "description": "string",
      "blurhash": "string",
      "meta": {}
    }
  ],
  "poll": {
    "id": "string",
    "expires_at": "2026-10-13T09:00:00.000Z",
    "expired": true,
    "multiple": true,
    "votes_count": 1,
    "voters_count": 1,
    "voted": true,
    "own_votes": [
      1
    ],
    "options": [
      {
        "title": "string",
        "votes_count": 1
      }
    ]
  },
  "favourited": true,
  "reblogged": true,
  "bookmarked": true,
  "muted": true,
  "pinned": true,
  "is_reblog": true,
  "quote": {
    "state": "string",
    "quoted_status": {}
  },
  "quote_approval": {}
}
```

## Mastodon: Delete a Pinned posts item

`DELETE /accounts/{accountId}/mastodon/pinned-statuses/{itemId}`

Statuses pinned to your profile (max configuration.accounts.max_pinned_statuses, default 5). Requires scopes: read:statuses, write:accounts. Network docs: https://docs.joinmastodon.org/methods/statuses/#pin Generic route: /v1/accounts/{accountId}/focus/pinned-statuses.

Access: `write` · MCP tool: `mastodon-pinned-statuses-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/pinned-statuses/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: List Notifications

`GET /accounts/{accountId}/mastodon/notifications`

All notifications (mentions, boosts, favourites, follows, quotes, polls, moderation…). Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/ Generic route: /v1/accounts/{accountId}/focus/notifications.

Access: `read` · MCP tool: `mastodon-notifications-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)
- `types` (array of string)
- `exclude_types` (array of string)
- `account_id` (string)
- `include_filtered` (boolean): Include notifications filtered by the notification policy (4.3+)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notifications" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "type": "mention",
      "created_at": "2026-10-13T09:00:00.000Z",
      "group_key": "string",
      "author": "string",
      "author_name": "string",
      "text": "string",
      "status_id": "string",
      "visibility": "string",
      "filtered": true,
      "account": {
        "id": "string",
        "acct": "string"
      },
      "status": {
        "id": "string"
      },
      "report": {},
      "moderation_warning": {},
      "event": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Get a Notifications item

`GET /accounts/{accountId}/mastodon/notifications/{itemId}`

All notifications (mentions, boosts, favourites, follows, quotes, polls, moderation…). Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/ Generic route: /v1/accounts/{accountId}/focus/notifications.

Access: `read` · MCP tool: `mastodon-notifications-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notifications/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "type": "mention",
  "created_at": "2026-10-13T09:00:00.000Z",
  "group_key": "string",
  "author": "string",
  "author_name": "string",
  "text": "string",
  "status_id": "string",
  "visibility": "string",
  "filtered": true,
  "account": {
    "id": "string",
    "acct": "string",
    "username": "string",
    "display_name": "string",
    "url": "https://example.com",
    "avatar": "string",
    "header": "string",
    "note": "string",
    "note_text": "string",
    "locked": true,
    "bot": true,
    "group": true,
    "discoverable": true,
    "indexable": true,
    "followers_count": 1,
    "following_count": 1,
    "statuses_count": 1,
    "created_at": "2026-10-13T09:00:00.000Z",
    "last_status_at": "2026-10-13",
    "fields": [
      {
        "name": "string",
        "value": "string",
        "verified_at": "2026-10-13T09:00:00.000Z"
      }
    ],
    "moved": {},
    "suspended": true,
    "limited": true
  },
  "status": {
    "id": "string",
    "uri": "https://example.com",
    "url": "https://example.com",
    "created_at": "2026-10-13T09:00:00.000Z",
    "edited_at": "2026-10-13T09:00:00.000Z",
    "text": "string",
    "content": "string",
    "spoiler_text": "string",
    "sensitive": true,
    "visibility": "public",
    "language": "en",
    "in_reply_to_id": "string",
    "in_reply_to_account_id": "string",
    "replies_count": 1,
    "reblogs_count": 1,
    "favourites_count": 1,
    "quotes_count": 1,
    "author": "string",
    "author_name": "string",
    "media_attachments": [
      {
        "id": "string",
        "type": "image",
        "url": "https://example.com",
        "preview_url": "https://example.com",
        "remote_url": "https://example.com",
        "description": "string"
      }
    ],
    "poll": {
      "id": "string",
      "expires_at": "2026-10-13T09:00:00.000Z",
      "expired": true,
      "multiple": true,
      "votes_count": 1,
      "voters_count": 1,
      "voted": true,
      "own_votes": [
        1
      ],
      "options": [
        {
          "title": "string",
          "votes_count": 1
        }
      ]
    },
    "favourited": true,
    "reblogged": true,
    "bookmarked": true,
    "muted": true,
    "pinned": true,
    "is_reblog": true,
    "quote": {
      "state": "string",
      "quoted_status": {}
    },
    "quote_approval": {}
  },
  "report": {},
  "moderation_warning": {},
  "event": {}
}
```

## Mastodon: Dismiss (Notifications)

`POST /accounts/{accountId}/mastodon/notifications/{itemId}/dismiss`

Dismiss. All notifications (mentions, boosts, favourites, follows, quotes, polls, moderation…). Requires scopes: read:notifications, write:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/ Generic route: /v1/accounts/{accountId}/focus/notifications.

Access: `write` · MCP tool: `mastodon-notifications-dismiss`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notifications/ITEM_ID/dismiss" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Clear all (Notifications)

`POST /accounts/{accountId}/mastodon/notifications/clear`

Clear all. All notifications (mentions, boosts, favourites, follows, quotes, polls, moderation…). Destructive. Requires scopes: read:notifications, write:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/ Generic route: /v1/accounts/{accountId}/focus/notifications.

Access: `write` · MCP tool: `mastodon-notifications-clear`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notifications/clear" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unread count (Notifications)

`POST /accounts/{accountId}/mastodon/notifications/unread-count`

Unread count. All notifications (mentions, boosts, favourites, follows, quotes, polls, moderation…). Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/ Generic route: /v1/accounts/{accountId}/focus/notifications.

Access: `write` · MCP tool: `mastodon-notifications-unread-count`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notifications/unread-count" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Reply (Notifications)

`POST /accounts/{accountId}/mastodon/notifications/{itemId}/reply`

Reply. All notifications (mentions, boosts, favourites, follows, quotes, polls, moderation…). Requires scopes: read:notifications, write:statuses. Network docs: https://docs.joinmastodon.org/methods/notifications/ Generic route: /v1/accounts/{accountId}/focus/notifications.

Access: `write` · MCP tool: `mastodon-notifications-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `status` (string): Plain text; URLs count as 23 characters
- `visibility` (string; one of public, unlisted, private, direct)
- `spoiler_text` (string)
- `sensitive` (boolean)
- `language` (string): ISO 639-1
- `media` (array of string): Socialit media ids (uploaded to the instance on publish)
- `media_ids` (array of string): Already-uploaded Mastodon media ids
- `alt_texts` (array of string): Alt text per media item, by index
- `poll` (object)
  - `poll.options` (array of string; ≥ 2 items)
  - `poll.expires_in` (integer)
  - `poll.multiple` (boolean)
  - `poll.hide_totals` (boolean)
- `in_reply_to_id` (string)
- `quoted_status_id` (string): Mastodon 4.5+
- `quote_approval_policy` (string; one of public, followers, nobody)
- `scheduled_at` (string (date-time)): ≥ 5 minutes ahead → ScheduledStatus
- `thread` (array of string): Follow-up replies posted as a self-thread

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notifications/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Grouped notifications

`GET /accounts/{accountId}/mastodon/grouped-notifications`

Notifications grouped like the Mastodon web UI ("Alice and 12 others favourited…"). Mastodon 4.3+. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/grouped_notifications/ Generic route: /v1/accounts/{accountId}/focus/grouped-notifications.

Access: `read` · MCP tool: `mastodon-grouped-notifications-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)
- `types` (array of string)
- `exclude_types` (array of string)
- `grouped_types` (array of string)
- `account_id` (string)
- `include_filtered` (boolean)
- `expand_accounts` (string; one of full, partial_avatars)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/grouped-notifications" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "group_key": "string",
      "type": "mention",
      "notifications_count": 1,
      "most_recent_notification_id": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "author": "string",
      "text": "string",
      "accounts": [
        {
          "id": "string",
          "acct": "string"
        }
      ],
      "status": {
        "id": "string"
      },
      "sample_account_ids": [
        "string"
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Get a Grouped notifications item

`GET /accounts/{accountId}/mastodon/grouped-notifications/{itemId}`

Notifications grouped like the Mastodon web UI ("Alice and 12 others favourited…"). Mastodon 4.3+. Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/grouped_notifications/ Generic route: /v1/accounts/{accountId}/focus/grouped-notifications.

Access: `read` · MCP tool: `mastodon-grouped-notifications-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/grouped-notifications/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "group_key": "string",
  "type": "mention",
  "notifications_count": 1,
  "most_recent_notification_id": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "author": "string",
  "text": "string",
  "accounts": [
    {
      "id": "string",
      "acct": "string",
      "username": "string",
      "display_name": "string",
      "url": "https://example.com",
      "avatar": "string",
      "header": "string",
      "note": "string",
      "note_text": "string",
      "locked": true,
      "bot": true,
      "group": true,
      "discoverable": true,
      "indexable": true,
      "followers_count": 1,
      "following_count": 1,
      "statuses_count": 1,
      "created_at": "2026-10-13T09:00:00.000Z",
      "last_status_at": "2026-10-13",
      "fields": [
        {
          "name": "string",
          "value": "string",
          "verified_at": "2026-10-13T09:00:00.000Z"
        }
      ],
      "moved": {},
      "suspended": true,
      "limited": true
    }
  ],
  "status": {
    "id": "string",
    "uri": "https://example.com",
    "url": "https://example.com",
    "created_at": "2026-10-13T09:00:00.000Z",
    "edited_at": "2026-10-13T09:00:00.000Z",
    "text": "string",
    "content": "string",
    "spoiler_text": "string",
    "sensitive": true,
    "visibility": "public",
    "language": "en",
    "in_reply_to_id": "string",
    "in_reply_to_account_id": "string",
    "replies_count": 1,
    "reblogs_count": 1,
    "favourites_count": 1,
    "quotes_count": 1,
    "author": "string",
    "author_name": "string",
    "media_attachments": [
      {
        "id": "string",
        "type": "image",
        "url": "https://example.com",
        "preview_url": "https://example.com",
        "remote_url": "https://example.com",
        "description": "string"
      }
    ],
    "poll": {
      "id": "string",
      "expires_at": "2026-10-13T09:00:00.000Z",
      "expired": true,
      "multiple": true,
      "votes_count": 1,
      "voters_count": 1,
      "voted": true,
      "own_votes": [
        1
      ],
      "options": [
        {
          "title": "string",
          "votes_count": 1
        }
      ]
    },
    "favourited": true,
    "reblogged": true,
    "bookmarked": true,
    "muted": true,
    "pinned": true,
    "is_reblog": true,
    "quote": {
      "state": "string",
      "quoted_status": {}
    },
    "quote_approval": {}
  },
  "sample_account_ids": [
    "string"
  ]
}
```

## Mastodon: Dismiss group (Grouped notifications)

`POST /accounts/{accountId}/mastodon/grouped-notifications/{itemId}/dismiss`

Dismiss group. Notifications grouped like the Mastodon web UI ("Alice and 12 others favourited…"). Mastodon 4.3+. Requires scopes: read:notifications, write:notifications. Network docs: https://docs.joinmastodon.org/methods/grouped_notifications/ Generic route: /v1/accounts/{accountId}/focus/grouped-notifications.

Access: `write` · MCP tool: `mastodon-grouped-notifications-dismiss`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/grouped-notifications/ITEM_ID/dismiss" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Accounts in group (Grouped notifications)

`POST /accounts/{accountId}/mastodon/grouped-notifications/{itemId}/accounts`

Accounts in group. Notifications grouped like the Mastodon web UI ("Alice and 12 others favourited…"). Mastodon 4.3+. Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/grouped_notifications/ Generic route: /v1/accounts/{accountId}/focus/grouped-notifications.

Access: `write` · MCP tool: `mastodon-grouped-notifications-accounts`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/grouped-notifications/ITEM_ID/accounts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unread count (Grouped notifications)

`POST /accounts/{accountId}/mastodon/grouped-notifications/unread-count`

Unread count. Notifications grouped like the Mastodon web UI ("Alice and 12 others favourited…"). Mastodon 4.3+. Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/grouped_notifications/ Generic route: /v1/accounts/{accountId}/focus/grouped-notifications.

Access: `write` · MCP tool: `mastodon-grouped-notifications-unread-count`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/grouped-notifications/unread-count" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Get Notification filtering

`GET /accounts/{accountId}/mastodon/notification-policy`

Filter or drop notifications from people you don’t follow, new accounts, private mentions, moderated accounts (4.3+). Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-policy Generic route: /v1/accounts/{accountId}/focus/notification-policy.

Access: `read` · MCP tool: `mastodon-notification-policy-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notification-policy" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "for_not_following": "accept",
  "for_not_followers": "accept",
  "for_new_accounts": "accept",
  "for_private_mentions": "accept",
  "for_limited_accounts": "accept",
  "summary": {
    "pending_requests_count": 1,
    "pending_notifications_count": 1
  }
}
```

## Mastodon: Update Notification filtering

`PATCH /accounts/{accountId}/mastodon/notification-policy`

Filter or drop notifications from people you don’t follow, new accounts, private mentions, moderated accounts (4.3+). Requires scopes: read:notifications, write:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-policy Generic route: /v1/accounts/{accountId}/focus/notification-policy.

Access: `write` · MCP tool: `mastodon-notification-policy-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `for_not_following` (string; one of accept, filter, drop)
- `for_not_followers` (string; one of accept, filter, drop)
- `for_new_accounts` (string; one of accept, filter, drop)
- `for_private_mentions` (string; one of accept, filter, drop)
- `for_limited_accounts` (string; one of accept, filter, drop)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notification-policy" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "for_not_following": "accept",
    "for_not_followers": "accept",
    "for_new_accounts": "accept",
    "for_private_mentions": "accept",
    "for_limited_accounts": "accept"
  }'
```

Response 200:

```json
{
  "for_not_following": "accept",
  "for_not_followers": "accept",
  "for_new_accounts": "accept",
  "for_private_mentions": "accept",
  "for_limited_accounts": "accept",
  "summary": {
    "pending_requests_count": 1,
    "pending_notifications_count": 1
  }
}
```

## Mastodon: List Message requests

`GET /accounts/{accountId}/mastodon/notification-requests`

Notifications held back by your filtering policy (mentions and DMs from strangers). Accept to move them into the inbox. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-requests Generic route: /v1/accounts/{accountId}/focus/notification-requests.

Access: `read` · MCP tool: `mastodon-notification-requests-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notification-requests" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z",
      "notifications_count": "string",
      "author": "string",
      "text": "string",
      "account": {
        "id": "string",
        "acct": "string"
      },
      "last_status": {
        "id": "string"
      }
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Get a Message requests item

`GET /accounts/{accountId}/mastodon/notification-requests/{itemId}`

Notifications held back by your filtering policy (mentions and DMs from strangers). Accept to move them into the inbox. Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-requests Generic route: /v1/accounts/{accountId}/focus/notification-requests.

Access: `read` · MCP tool: `mastodon-notification-requests-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notification-requests/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "notifications_count": "string",
  "author": "string",
  "text": "string",
  "account": {
    "id": "string",
    "acct": "string",
    "username": "string",
    "display_name": "string",
    "url": "https://example.com",
    "avatar": "string",
    "header": "string",
    "note": "string",
    "note_text": "string",
    "locked": true,
    "bot": true,
    "group": true,
    "discoverable": true,
    "indexable": true,
    "followers_count": 1,
    "following_count": 1,
    "statuses_count": 1,
    "created_at": "2026-10-13T09:00:00.000Z",
    "last_status_at": "2026-10-13",
    "fields": [
      {
        "name": "string",
        "value": "string",
        "verified_at": "2026-10-13T09:00:00.000Z"
      }
    ],
    "moved": {},
    "suspended": true,
    "limited": true
  },
  "last_status": {
    "id": "string",
    "uri": "https://example.com",
    "url": "https://example.com",
    "created_at": "2026-10-13T09:00:00.000Z",
    "edited_at": "2026-10-13T09:00:00.000Z",
    "text": "string",
    "content": "string",
    "spoiler_text": "string",
    "sensitive": true,
    "visibility": "public",
    "language": "en",
    "in_reply_to_id": "string",
    "in_reply_to_account_id": "string",
    "replies_count": 1,
    "reblogs_count": 1,
    "favourites_count": 1,
    "quotes_count": 1,
    "author": "string",
    "author_name": "string",
    "media_attachments": [
      {
        "id": "string",
        "type": "image",
        "url": "https://example.com",
        "preview_url": "https://example.com",
        "remote_url": "https://example.com",
        "description": "string"
      }
    ],
    "poll": {
      "id": "string",
      "expires_at": "2026-10-13T09:00:00.000Z",
      "expired": true,
      "multiple": true,
      "votes_count": 1,
      "voters_count": 1,
      "voted": true,
      "own_votes": [
        1
      ],
      "options": [
        {
          "title": "string",
          "votes_count": 1
        }
      ]
    },
    "favourited": true,
    "reblogged": true,
    "bookmarked": true,
    "muted": true,
    "pinned": true,
    "is_reblog": true,
    "quote": {
      "state": "string",
      "quoted_status": {}
    },
    "quote_approval": {}
  }
}
```

## Mastodon: Accept (Message requests)

`POST /accounts/{accountId}/mastodon/notification-requests/{itemId}/accept`

Accept. Notifications held back by your filtering policy (mentions and DMs from strangers). Accept to move them into the inbox. Requires scopes: read:notifications, write:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-requests Generic route: /v1/accounts/{accountId}/focus/notification-requests.

Access: `write` · MCP tool: `mastodon-notification-requests-accept`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notification-requests/ITEM_ID/accept" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Dismiss (Message requests)

`POST /accounts/{accountId}/mastodon/notification-requests/{itemId}/dismiss`

Dismiss. Notifications held back by your filtering policy (mentions and DMs from strangers). Accept to move them into the inbox. Destructive. Requires scopes: read:notifications, write:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-requests Generic route: /v1/accounts/{accountId}/focus/notification-requests.

Access: `write` · MCP tool: `mastodon-notification-requests-dismiss`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notification-requests/ITEM_ID/dismiss" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Accept selected (Message requests)

`POST /accounts/{accountId}/mastodon/notification-requests/accept-many`

Accept selected. Notifications held back by your filtering policy (mentions and DMs from strangers). Accept to move them into the inbox. Requires scopes: read:notifications, write:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-requests Generic route: /v1/accounts/{accountId}/focus/notification-requests.

Access: `write` · MCP tool: `mastodon-notification-requests-accept-many`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `ids` (array of string; required; ≥ 1 items)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notification-requests/accept-many" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Dismiss selected (Message requests)

`POST /accounts/{accountId}/mastodon/notification-requests/dismiss-many`

Dismiss selected. Notifications held back by your filtering policy (mentions and DMs from strangers). Accept to move them into the inbox. Destructive. Requires scopes: read:notifications, write:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-requests Generic route: /v1/accounts/{accountId}/focus/notification-requests.

Access: `write` · MCP tool: `mastodon-notification-requests-dismiss-many`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `ids` (array of string; required; ≥ 1 items)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notification-requests/dismiss-many" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Merge status (Message requests)

`POST /accounts/{accountId}/mastodon/notification-requests/merged`

Merge status. Notifications held back by your filtering policy (mentions and DMs from strangers). Accept to move them into the inbox. Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-requests Generic route: /v1/accounts/{accountId}/focus/notification-requests.

Access: `write` · MCP tool: `mastodon-notification-requests-merged`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notification-requests/merged" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Direct messages

`GET /accounts/{accountId}/mastodon/conversations`

Private mentions grouped into conversations. Replies @mention every participant. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/conversations/ Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: `read` · MCP tool: `mastodon-conversations-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/conversations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "updated_at": "2026-10-13T09:00:00.000Z",
      "unread": true,
      "unread_count": 1,
      "last_message": "string",
      "last_status_id": "string",
      "participants": [
        {
          "id": "string",
          "name": "string",
          "username": "string",
          "avatar_url": "https://example.com",
          "url": "https://example.com"
        }
      ],
      "messages": [
        {
          "id": "string",
          "text": "string",
          "direction": "in",
          "sent_at": "2026-10-13T09:00:00.000Z",
          "from_id": "string",
          "from_username": "string"
        }
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Create a Direct messages item

`POST /accounts/{accountId}/mastodon/conversations`

Start a DM (visibility=direct). Private mentions grouped into conversations. Replies @mention every participant. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/conversations/ Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: `write` · MCP tool: `mastodon-conversations-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `to` (array of string; required; ≥ 1 items)
- `text` (string)
- `media` (array of string)
- `spoiler_text` (string)
- `sensitive` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/conversations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "to": [
      "+15551234567"
    ],
    "text": "string",
    "media": [
      "string"
    ],
    "spoiler_text": "string",
    "sensitive": true
  }'
```

Response 201:

```json
{
  "id": "string",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "unread": true,
  "unread_count": 1,
  "last_message": "string",
  "last_status_id": "string",
  "participants": [
    {
      "id": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com",
      "url": "https://example.com"
    }
  ],
  "messages": [
    {
      "id": "string",
      "text": "string",
      "direction": "in",
      "sent_at": "2026-10-13T09:00:00.000Z",
      "from_id": "string",
      "from_username": "string",
      "attachments": [
        {}
      ]
    }
  ]
}
```

## Mastodon: Get a Direct messages item

`GET /accounts/{accountId}/mastodon/conversations/{itemId}`

Conversation + its direct messages. Private mentions grouped into conversations. Replies @mention every participant. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/conversations/ Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: `read` · MCP tool: `mastodon-conversations-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/conversations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "unread": true,
  "unread_count": 1,
  "last_message": "string",
  "last_status_id": "string",
  "participants": [
    {
      "id": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com",
      "url": "https://example.com"
    }
  ],
  "messages": [
    {
      "id": "string",
      "text": "string",
      "direction": "in",
      "sent_at": "2026-10-13T09:00:00.000Z",
      "from_id": "string",
      "from_username": "string",
      "attachments": [
        {}
      ]
    }
  ]
}
```

## Mastodon: Delete a Direct messages item

`DELETE /accounts/{accountId}/mastodon/conversations/{itemId}`

Private mentions grouped into conversations. Replies @mention every participant. Requires scopes: read:statuses, write:conversations. Network docs: https://docs.joinmastodon.org/methods/conversations/ Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: `write` · MCP tool: `mastodon-conversations-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/conversations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: Mark as read (Direct messages)

`POST /accounts/{accountId}/mastodon/conversations/{itemId}/read`

Mark as read. Private mentions grouped into conversations. Replies @mention every participant. Requires scopes: read:statuses, write:conversations. Network docs: https://docs.joinmastodon.org/methods/conversations/ Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: `write` · MCP tool: `mastodon-conversations-read`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/conversations/ITEM_ID/read" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Reply (Direct messages)

`POST /accounts/{accountId}/mastodon/conversations/{itemId}/reply`

Reply. Private mentions grouped into conversations. Replies @mention every participant. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/conversations/ Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: `write` · MCP tool: `mastodon-conversations-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `text` (string)
- `media` (array of string)
- `spoiler_text` (string)
- `sensitive` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/conversations/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      "string"
    ],
    "spoiler_text": "string",
    "sensitive": true
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Comments

`GET /accounts/{accountId}/mastodon/comments`

Replies to your posts (thread context + reply mentions, including filtered ones). Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:statuses, read:notifications. Network docs: https://docs.joinmastodon.org/methods/statuses/#context Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `read` · MCP tool: `mastodon-comments-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `post_id` (string): Replies to one post; omit for recent replies across your posts
- `recent_posts` (integer; ≤ 40): How many recent own posts to scan when post_id is omitted
- `limit` (integer; ≤ 200)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/comments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "author": "string",
      "author_name": "string",
      "author_avatar": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "like_count": 1,
      "reply_count": 1,
      "share_count": 1,
      "parent_id": "string",
      "post_id": "string",
      "visibility": "string",
      "liked": true,
      "is_own": true,
      "spoiler_text": "string",
      "url": "https://example.com",
      "attachments": [
        {}
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Get a Comments item

`GET /accounts/{accountId}/mastodon/comments/{itemId}`

Replies to your posts (thread context + reply mentions, including filtered ones). Requires scopes: read:statuses, read:notifications. Network docs: https://docs.joinmastodon.org/methods/statuses/#context Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `read` · MCP tool: `mastodon-comments-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/comments/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "text": "string",
  "author": "string",
  "author_name": "string",
  "author_avatar": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "like_count": 1,
  "reply_count": 1,
  "share_count": 1,
  "parent_id": "string",
  "post_id": "string",
  "visibility": "string",
  "liked": true,
  "is_own": true,
  "spoiler_text": "string",
  "url": "https://example.com",
  "attachments": [
    {}
  ]
}
```

## Mastodon: Delete a Comments item

`DELETE /accounts/{accountId}/mastodon/comments/{itemId}`

Delete your own reply (others’ replies cannot be deleted). Replies to your posts (thread context + reply mentions, including filtered ones). Requires scopes: read:statuses, read:notifications, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/#context Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `write` · MCP tool: `mastodon-comments-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/comments/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: Reply (Comments)

`POST /accounts/{accountId}/mastodon/comments/{itemId}/reply`

Reply. Replies to your posts (thread context + reply mentions, including filtered ones). Requires scopes: read:statuses, read:notifications, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/#context Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `write` · MCP tool: `mastodon-comments-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `text` (string; required)
- `visibility` (string; one of public, unlisted, private, direct)
- `mention_all` (boolean)
- `media` (array of string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/comments/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "visibility": "public",
    "mention_all": true,
    "media": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Favourite (Comments)

`POST /accounts/{accountId}/mastodon/comments/{itemId}/like`

Favourite. Replies to your posts (thread context + reply mentions, including filtered ones). Requires scopes: read:statuses, read:notifications, write:favourites. Network docs: https://docs.joinmastodon.org/methods/statuses/#context Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `write` · MCP tool: `mastodon-comments-like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/comments/ITEM_ID/like" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unfavourite (Comments)

`POST /accounts/{accountId}/mastodon/comments/{itemId}/unlike`

Unfavourite. Replies to your posts (thread context + reply mentions, including filtered ones). Requires scopes: read:statuses, read:notifications, write:favourites. Network docs: https://docs.joinmastodon.org/methods/statuses/#context Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `write` · MCP tool: `mastodon-comments-unlike`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/comments/ITEM_ID/unlike" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Mute thread (Comments)

`POST /accounts/{accountId}/mastodon/comments/{itemId}/mute-thread`

Mute thread. Replies to your posts (thread context + reply mentions, including filtered ones). Requires scopes: read:statuses, read:notifications, write:mutes. Network docs: https://docs.joinmastodon.org/methods/statuses/#context Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `write` · MCP tool: `mastodon-comments-mute-thread`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/comments/ITEM_ID/mute-thread" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Followers

`GET /accounts/{accountId}/mastodon/followers`

Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/accounts/#followers Generic route: /v1/accounts/{accountId}/focus/followers.

Access: `read` · MCP tool: `mastodon-followers-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)
- `account_id` (string): Defaults to the connected account

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/followers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "acct": "string",
      "username": "string",
      "display_name": "string",
      "url": "https://example.com",
      "avatar": "string",
      "header": "string",
      "note": "string",
      "note_text": "string",
      "locked": true,
      "bot": true,
      "group": true,
      "discoverable": true,
      "indexable": true,
      "followers_count": 1,
      "following_count": 1,
      "statuses_count": 1,
      "created_at": "2026-10-13T09:00:00.000Z",
      "last_status_at": "2026-10-13",
      "fields": [
        {
          "name": "string",
          "value": "string",
          "verified_at": "2026-10-13T09:00:00.000Z"
        }
      ],
      "moved": {},
      "suspended": true,
      "limited": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Remove from followers (Followers)

`POST /accounts/{accountId}/mastodon/followers/{itemId}/remove-from-followers`

Remove from followers. Destructive. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#followers Generic route: /v1/accounts/{accountId}/focus/followers.

Access: `write` · MCP tool: `mastodon-followers-remove-from-followers`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/followers/ITEM_ID/remove-from-followers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Follow (Followers)

`POST /accounts/{accountId}/mastodon/followers/{itemId}/follow`

Follow. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#followers Generic route: /v1/accounts/{accountId}/focus/followers.

Access: `write` · MCP tool: `mastodon-followers-follow`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `reblogs` (boolean)
- `notify` (boolean)
- `languages` (array of string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/followers/ITEM_ID/follow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reblogs": true,
    "notify": true,
    "languages": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Block (Followers)

`POST /accounts/{accountId}/mastodon/followers/{itemId}/block`

Block. Destructive. Requires scopes: write:blocks. Network docs: https://docs.joinmastodon.org/methods/accounts/#followers Generic route: /v1/accounts/{accountId}/focus/followers.

Access: `write` · MCP tool: `mastodon-followers-block`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/followers/ITEM_ID/block" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Following

`GET /accounts/{accountId}/mastodon/following`

Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/accounts/#following Generic route: /v1/accounts/{accountId}/focus/following.

Access: `read` · MCP tool: `mastodon-following-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)
- `account_id` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/following" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "acct": "string",
      "username": "string",
      "display_name": "string",
      "url": "https://example.com",
      "avatar": "string",
      "header": "string",
      "note": "string",
      "note_text": "string",
      "locked": true,
      "bot": true,
      "group": true,
      "discoverable": true,
      "indexable": true,
      "followers_count": 1,
      "following_count": 1,
      "statuses_count": 1,
      "created_at": "2026-10-13T09:00:00.000Z",
      "last_status_at": "2026-10-13",
      "fields": [
        {
          "name": "string",
          "value": "string",
          "verified_at": "2026-10-13T09:00:00.000Z"
        }
      ],
      "moved": {},
      "suspended": true,
      "limited": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Create a Following item

`POST /accounts/{accountId}/mastodon/following`

Follow an account by id or @user@domain (400 follows / 24 h). Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#following Generic route: /v1/accounts/{accountId}/focus/following.

Access: `write` · MCP tool: `mastodon-following-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `account_id` (string)
- `acct` (string): @user@domain
- `reblogs` (boolean)
- `notify` (boolean)
- `languages` (array of string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/following" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "string",
    "acct": "string",
    "reblogs": true,
    "notify": true,
    "languages": [
      "string"
    ]
  }'
```

Response 201:

```json
{
  "id": "string",
  "acct": "string",
  "username": "string",
  "display_name": "string",
  "url": "https://example.com",
  "avatar": "string",
  "header": "string",
  "note": "string",
  "note_text": "string",
  "locked": true,
  "bot": true,
  "group": true,
  "discoverable": true,
  "indexable": true,
  "followers_count": 1,
  "following_count": 1,
  "statuses_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "last_status_at": "2026-10-13",
  "fields": [
    {
      "name": "string",
      "value": "string",
      "verified_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "moved": {},
  "suspended": true,
  "limited": true
}
```

## Mastodon: Delete a Following item

`DELETE /accounts/{accountId}/mastodon/following/{itemId}`

Unfollow. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#following Generic route: /v1/accounts/{accountId}/focus/following.

Access: `write` · MCP tool: `mastodon-following-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/following/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: Notify on new posts (Following)

`POST /accounts/{accountId}/mastodon/following/{itemId}/notify`

Notify on new posts. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#following Generic route: /v1/accounts/{accountId}/focus/following.

Access: `write` · MCP tool: `mastodon-following-notify`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `notify` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/following/ITEM_ID/notify" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "notify": true
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Mute (Following)

`POST /accounts/{accountId}/mastodon/following/{itemId}/mute`

Mute. Requires scopes: write:mutes. Network docs: https://docs.joinmastodon.org/methods/accounts/#following Generic route: /v1/accounts/{accountId}/focus/following.

Access: `write` · MCP tool: `mastodon-following-mute`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `notifications` (boolean)
- `duration` (integer): Seconds; 0 = indefinite

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/following/ITEM_ID/mute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "notifications": true,
    "duration": 0
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Follow requests

`GET /accounts/{accountId}/mastodon/follow-requests`

Pending requests to follow your locked account. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:follows. Network docs: https://docs.joinmastodon.org/methods/follow_requests/ Generic route: /v1/accounts/{accountId}/focus/follow-requests.

Access: `read` · MCP tool: `mastodon-follow-requests-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/follow-requests" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "acct": "string",
      "username": "string",
      "display_name": "string",
      "url": "https://example.com",
      "avatar": "string",
      "header": "string",
      "note": "string",
      "note_text": "string",
      "locked": true,
      "bot": true,
      "group": true,
      "discoverable": true,
      "indexable": true,
      "followers_count": 1,
      "following_count": 1,
      "statuses_count": 1,
      "created_at": "2026-10-13T09:00:00.000Z",
      "last_status_at": "2026-10-13",
      "fields": [
        {
          "name": "string",
          "value": "string",
          "verified_at": "2026-10-13T09:00:00.000Z"
        }
      ],
      "moved": {},
      "suspended": true,
      "limited": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Accept (Follow requests)

`POST /accounts/{accountId}/mastodon/follow-requests/{itemId}/authorize`

Accept. Pending requests to follow your locked account. Requires scopes: read:follows, write:follows. Network docs: https://docs.joinmastodon.org/methods/follow_requests/ Generic route: /v1/accounts/{accountId}/focus/follow-requests.

Access: `write` · MCP tool: `mastodon-follow-requests-authorize`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/follow-requests/ITEM_ID/authorize" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Reject (Follow requests)

`POST /accounts/{accountId}/mastodon/follow-requests/{itemId}/reject`

Reject. Pending requests to follow your locked account. Destructive. Requires scopes: read:follows, write:follows. Network docs: https://docs.joinmastodon.org/methods/follow_requests/ Generic route: /v1/accounts/{accountId}/focus/follow-requests.

Access: `write` · MCP tool: `mastodon-follow-requests-reject`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/follow-requests/ITEM_ID/reject" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Relationships

`GET /accounts/{accountId}/mastodon/relationships`

Follow / block / mute state with given accounts. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: /v1/accounts/{accountId}/focus/relationships.

Access: `read` · MCP tool: `mastodon-relationships-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `ids` (array of string; required; ≥ 1 items)
- `with_suspended` (boolean)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/relationships?ids=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "following": true,
      "showing_reblogs": true,
      "notifying": true,
      "languages": [
        "string"
      ],
      "followed_by": true,
      "blocking": true,
      "blocked_by": true,
      "muting": true,
      "muting_notifications": true,
      "muting_expires_at": "2026-10-13T09:00:00.000Z",
      "requested": true,
      "requested_by": true,
      "domain_blocking": true,
      "endorsed": true,
      "note": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Follow (Relationships)

`POST /accounts/{accountId}/mastodon/relationships/{itemId}/follow`

Follow. Follow / block / mute state with given accounts. Requires scopes: read:follows, write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: /v1/accounts/{accountId}/focus/relationships.

Access: `write` · MCP tool: `mastodon-relationships-follow`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `reblogs` (boolean)
- `notify` (boolean)
- `languages` (array of string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/relationships/ITEM_ID/follow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reblogs": true,
    "notify": true,
    "languages": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unfollow (Relationships)

`POST /accounts/{accountId}/mastodon/relationships/{itemId}/unfollow`

Unfollow. Follow / block / mute state with given accounts. Requires scopes: read:follows, write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: /v1/accounts/{accountId}/focus/relationships.

Access: `write` · MCP tool: `mastodon-relationships-unfollow`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/relationships/ITEM_ID/unfollow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Remove from followers (Relationships)

`POST /accounts/{accountId}/mastodon/relationships/{itemId}/remove-from-followers`

Remove from followers. Follow / block / mute state with given accounts. Destructive. Requires scopes: read:follows, write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: /v1/accounts/{accountId}/focus/relationships.

Access: `write` · MCP tool: `mastodon-relationships-remove-from-followers`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/relationships/ITEM_ID/remove-from-followers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Block (Relationships)

`POST /accounts/{accountId}/mastodon/relationships/{itemId}/block`

Block. Follow / block / mute state with given accounts. Destructive. Requires scopes: read:follows, write:blocks. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: /v1/accounts/{accountId}/focus/relationships.

Access: `write` · MCP tool: `mastodon-relationships-block`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/relationships/ITEM_ID/block" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unblock (Relationships)

`POST /accounts/{accountId}/mastodon/relationships/{itemId}/unblock`

Unblock. Follow / block / mute state with given accounts. Requires scopes: read:follows, write:blocks. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: /v1/accounts/{accountId}/focus/relationships.

Access: `write` · MCP tool: `mastodon-relationships-unblock`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/relationships/ITEM_ID/unblock" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Mute (Relationships)

`POST /accounts/{accountId}/mastodon/relationships/{itemId}/mute`

Mute. Follow / block / mute state with given accounts. Requires scopes: read:follows, write:mutes. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: /v1/accounts/{accountId}/focus/relationships.

Access: `write` · MCP tool: `mastodon-relationships-mute`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `notifications` (boolean)
- `duration` (integer): Seconds; 0 = indefinite

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/relationships/ITEM_ID/mute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "notifications": true,
    "duration": 0
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unmute (Relationships)

`POST /accounts/{accountId}/mastodon/relationships/{itemId}/unmute`

Unmute. Follow / block / mute state with given accounts. Requires scopes: read:follows, write:mutes. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: /v1/accounts/{accountId}/focus/relationships.

Access: `write` · MCP tool: `mastodon-relationships-unmute`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/relationships/ITEM_ID/unmute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Private note (Relationships)

`POST /accounts/{accountId}/mastodon/relationships/{itemId}/note`

Private note. Follow / block / mute state with given accounts. Requires scopes: read:follows, write:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: /v1/accounts/{accountId}/focus/relationships.

Access: `write` · MCP tool: `mastodon-relationships-note`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `comment` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/relationships/ITEM_ID/note" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "comment": "string"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Familiar followers

`GET /accounts/{accountId}/mastodon/familiar-followers`

Accounts you follow that also follow the given accounts. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#familiar_followers Generic route: /v1/accounts/{accountId}/focus/familiar-followers.

Access: `read` · MCP tool: `mastodon-familiar-followers-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `ids` (array of string; required; ≥ 1 items)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/familiar-followers?ids=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "count": 1,
      "accounts": [
        {
          "id": "string",
          "acct": "string"
        }
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: List People

`GET /accounts/{accountId}/mastodon/accounts`

Account search (GET /api/v1/accounts/search). Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.

Access: `read` · MCP tool: `mastodon-accounts-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `q` (string; required)
- `resolve` (boolean): WebFinger-resolve remote handles
- `following` (boolean)
- `limit` (integer; ≤ 80)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts?q=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "acct": "string",
      "username": "string",
      "display_name": "string",
      "url": "https://example.com",
      "avatar": "string",
      "header": "string",
      "note": "string",
      "note_text": "string",
      "locked": true,
      "bot": true,
      "group": true,
      "discoverable": true,
      "indexable": true,
      "followers_count": 1,
      "following_count": 1,
      "statuses_count": 1,
      "created_at": "2026-10-13T09:00:00.000Z",
      "last_status_at": "2026-10-13",
      "fields": [
        {
          "name": "string",
          "value": "string",
          "verified_at": "2026-10-13T09:00:00.000Z"
        }
      ],
      "moved": {},
      "suspended": true,
      "limited": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Get a People item

`GET /accounts/{accountId}/mastodon/accounts/{itemId}`

Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.

Access: `read` · MCP tool: `mastodon-accounts-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "acct": "string",
  "username": "string",
  "display_name": "string",
  "url": "https://example.com",
  "avatar": "string",
  "header": "string",
  "note": "string",
  "note_text": "string",
  "locked": true,
  "bot": true,
  "group": true,
  "discoverable": true,
  "indexable": true,
  "followers_count": 1,
  "following_count": 1,
  "statuses_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "last_status_at": "2026-10-13",
  "fields": [
    {
      "name": "string",
      "value": "string",
      "verified_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "moved": {},
  "suspended": true,
  "limited": true
}
```

## Mastodon: Look up handle (People)

`POST /accounts/{accountId}/mastodon/accounts/lookup`

Look up handle. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.

Access: `write` · MCP tool: `mastodon-accounts-lookup`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `acct` (string; required): user or user@domain

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/lookup" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "acct": "string"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Posts (People)

`POST /accounts/{accountId}/mastodon/accounts/{itemId}/statuses`

Posts. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.

Access: `write` · MCP tool: `mastodon-accounts-statuses`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)
- `only_media` (boolean)
- `exclude_replies` (boolean)
- `exclude_reblogs` (boolean)
- `pinned` (boolean)
- `tagged` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/statuses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "cursor": "string",
    "limit": 20,
    "only_media": true,
    "exclude_replies": true,
    "exclude_reblogs": true
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Lists containing (People)

`POST /accounts/{accountId}/mastodon/accounts/{itemId}/lists`

Lists containing. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, read:lists. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.

Access: `write` · MCP tool: `mastodon-accounts-lists`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/lists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Featured hashtags (People)

`POST /accounts/{accountId}/mastodon/accounts/{itemId}/featured-tags`

Featured hashtags. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.

Access: `write` · MCP tool: `mastodon-accounts-featured-tags`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/featured-tags" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Featured accounts (People)

`POST /accounts/{accountId}/mastodon/accounts/{itemId}/endorsements`

Featured accounts. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.

Access: `write` · MCP tool: `mastodon-accounts-endorsements`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/endorsements" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "cursor": "string",
    "limit": 20
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Follow (People)

`POST /accounts/{accountId}/mastodon/accounts/{itemId}/follow`

Follow. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.

Access: `write` · MCP tool: `mastodon-accounts-follow`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `reblogs` (boolean)
- `notify` (boolean)
- `languages` (array of string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/follow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reblogs": true,
    "notify": true,
    "languages": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unfollow (People)

`POST /accounts/{accountId}/mastodon/accounts/{itemId}/unfollow`

Unfollow. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.

Access: `write` · MCP tool: `mastodon-accounts-unfollow`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/unfollow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Remove from followers (People)

`POST /accounts/{accountId}/mastodon/accounts/{itemId}/remove-from-followers`

Remove from followers. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Destructive. Requires scopes: read:accounts, write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.

Access: `write` · MCP tool: `mastodon-accounts-remove-from-followers`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/remove-from-followers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Block (People)

`POST /accounts/{accountId}/mastodon/accounts/{itemId}/block`

Block. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Destructive. Requires scopes: read:accounts, write:blocks. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.

Access: `write` · MCP tool: `mastodon-accounts-block`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/block" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unblock (People)

`POST /accounts/{accountId}/mastodon/accounts/{itemId}/unblock`

Unblock. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, write:blocks. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.

Access: `write` · MCP tool: `mastodon-accounts-unblock`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/unblock" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Mute (People)

`POST /accounts/{accountId}/mastodon/accounts/{itemId}/mute`

Mute. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, write:mutes. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.

Access: `write` · MCP tool: `mastodon-accounts-mute`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `notifications` (boolean)
- `duration` (integer): Seconds; 0 = indefinite

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/mute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "notifications": true,
    "duration": 0
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unmute (People)

`POST /accounts/{accountId}/mastodon/accounts/{itemId}/unmute`

Unmute. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, write:mutes. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.

Access: `write` · MCP tool: `mastodon-accounts-unmute`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/unmute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Feature on profile (People)

`POST /accounts/{accountId}/mastodon/accounts/{itemId}/endorse`

Feature on profile. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.

Access: `write` · MCP tool: `mastodon-accounts-endorse`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/endorse" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unfeature (People)

`POST /accounts/{accountId}/mastodon/accounts/{itemId}/unendorse`

Unfeature. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.

Access: `write` · MCP tool: `mastodon-accounts-unendorse`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/unendorse" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Private note (People)

`POST /accounts/{accountId}/mastodon/accounts/{itemId}/note`

Private note. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.

Access: `write` · MCP tool: `mastodon-accounts-note`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `comment` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/note" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "comment": "string"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Lists

`GET /accounts/{accountId}/mastodon/lists`

Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: /v1/accounts/{accountId}/focus/lists.

Access: `read` · MCP tool: `mastodon-lists-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/lists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "title": "string",
      "replies_policy": "followed",
      "exclusive": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Create a Lists item

`POST /accounts/{accountId}/mastodon/lists`

Requires scopes: read:lists, write:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: /v1/accounts/{accountId}/focus/lists.

Access: `write` · MCP tool: `mastodon-lists-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `title` (string; required)
- `replies_policy` (string; one of followed, list, none)
- `exclusive` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/lists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "replies_policy": "followed",
    "exclusive": true
  }'
```

Response 201:

```json
{
  "id": "string",
  "title": "string",
  "replies_policy": "followed",
  "exclusive": true
}
```

## Mastodon: Get a Lists item

`GET /accounts/{accountId}/mastodon/lists/{itemId}`

Requires scopes: read:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: /v1/accounts/{accountId}/focus/lists.

Access: `read` · MCP tool: `mastodon-lists-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/lists/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "replies_policy": "followed",
  "exclusive": true
}
```

## Mastodon: Update a Lists item

`PATCH /accounts/{accountId}/mastodon/lists/{itemId}`

Requires scopes: read:lists, write:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: /v1/accounts/{accountId}/focus/lists.

Access: `write` · MCP tool: `mastodon-lists-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `title` (string)
- `replies_policy` (string; one of followed, list, none)
- `exclusive` (boolean)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/lists/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "replies_policy": "followed",
    "exclusive": true
  }'
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "replies_policy": "followed",
  "exclusive": true
}
```

## Mastodon: Delete a Lists item

`DELETE /accounts/{accountId}/mastodon/lists/{itemId}`

Requires scopes: read:lists, write:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: /v1/accounts/{accountId}/focus/lists.

Access: `write` · MCP tool: `mastodon-lists-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/lists/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: List timeline (Lists)

`POST /accounts/{accountId}/mastodon/lists/{itemId}/timeline`

List timeline. Requires scopes: read:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: /v1/accounts/{accountId}/focus/lists.

Access: `write` · MCP tool: `mastodon-lists-timeline`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/lists/ITEM_ID/timeline" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "cursor": "string",
    "limit": 20
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Members (Lists)

`POST /accounts/{accountId}/mastodon/lists/{itemId}/members`

Members. Requires scopes: read:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: /v1/accounts/{accountId}/focus/lists.

Access: `write` · MCP tool: `mastodon-lists-members`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/lists/ITEM_ID/members" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "cursor": "string",
    "limit": 20
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Add accounts (Lists)

`POST /accounts/{accountId}/mastodon/lists/{itemId}/add-accounts`

Add accounts. Requires scopes: read:lists, write:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: /v1/accounts/{accountId}/focus/lists.

Access: `write` · MCP tool: `mastodon-lists-add-accounts`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `account_ids` (array of string; required; ≥ 1 items)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/lists/ITEM_ID/add-accounts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_ids": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Remove accounts (Lists)

`POST /accounts/{accountId}/mastodon/lists/{itemId}/remove-accounts`

Remove accounts. Requires scopes: read:lists, write:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: /v1/accounts/{accountId}/focus/lists.

Access: `write` · MCP tool: `mastodon-lists-remove-accounts`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `account_ids` (array of string; required; ≥ 1 items)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/lists/ITEM_ID/remove-accounts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_ids": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List List members

`GET /accounts/{accountId}/mastodon/list-members`

Accounts in a list (you must follow an account before adding it). Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:lists. Network docs: https://docs.joinmastodon.org/methods/lists/#accounts Generic route: /v1/accounts/{accountId}/focus/list-members.

Access: `read` · MCP tool: `mastodon-list-members-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)
- `list_id` (string; required)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/list-members?list_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "acct": "string",
      "username": "string",
      "display_name": "string",
      "url": "https://example.com",
      "avatar": "string",
      "header": "string",
      "note": "string",
      "note_text": "string",
      "locked": true,
      "bot": true,
      "group": true,
      "discoverable": true,
      "indexable": true,
      "followers_count": 1,
      "following_count": 1,
      "statuses_count": 1,
      "created_at": "2026-10-13T09:00:00.000Z",
      "last_status_at": "2026-10-13",
      "fields": [
        {
          "name": "string",
          "value": "string",
          "verified_at": "2026-10-13T09:00:00.000Z"
        }
      ],
      "moved": {},
      "suspended": true,
      "limited": true,
      "account_id": "string",
      "list_id": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Create a List members item

`POST /accounts/{accountId}/mastodon/list-members`

Accounts in a list (you must follow an account before adding it). Requires scopes: read:lists, write:lists. Network docs: https://docs.joinmastodon.org/methods/lists/#accounts Generic route: /v1/accounts/{accountId}/focus/list-members.

Access: `write` · MCP tool: `mastodon-list-members-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `list_id` (string; required)
- `account_ids` (array of string; required; ≥ 1 items)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/list-members" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "list_id": "string",
    "account_ids": [
      "string"
    ]
  }'
```

Response 201:

```json
{
  "id": "string",
  "acct": "string",
  "username": "string",
  "display_name": "string",
  "url": "https://example.com",
  "avatar": "string",
  "header": "string",
  "note": "string",
  "note_text": "string",
  "locked": true,
  "bot": true,
  "group": true,
  "discoverable": true,
  "indexable": true,
  "followers_count": 1,
  "following_count": 1,
  "statuses_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "last_status_at": "2026-10-13",
  "fields": [
    {
      "name": "string",
      "value": "string",
      "verified_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "moved": {},
  "suspended": true,
  "limited": true,
  "account_id": "string",
  "list_id": "string"
}
```

## Mastodon: Delete a List members item

`DELETE /accounts/{accountId}/mastodon/list-members/{itemId}`

Accounts in a list (you must follow an account before adding it). Requires scopes: read:lists, write:lists. Network docs: https://docs.joinmastodon.org/methods/lists/#accounts Generic route: /v1/accounts/{accountId}/focus/list-members.

Access: `write` · MCP tool: `mastodon-list-members-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/list-members/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: List Featured accounts

`GET /accounts/{accountId}/mastodon/endorsements`

Accounts you feature (endorse) on your profile. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/endorsements/ Generic route: /v1/accounts/{accountId}/focus/endorsements.

Access: `read` · MCP tool: `mastodon-endorsements-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/endorsements" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "acct": "string",
      "username": "string",
      "display_name": "string",
      "url": "https://example.com",
      "avatar": "string",
      "header": "string",
      "note": "string",
      "note_text": "string",
      "locked": true,
      "bot": true,
      "group": true,
      "discoverable": true,
      "indexable": true,
      "followers_count": 1,
      "following_count": 1,
      "statuses_count": 1,
      "created_at": "2026-10-13T09:00:00.000Z",
      "last_status_at": "2026-10-13",
      "fields": [
        {
          "name": "string",
          "value": "string",
          "verified_at": "2026-10-13T09:00:00.000Z"
        }
      ],
      "moved": {},
      "suspended": true,
      "limited": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Create a Featured accounts item

`POST /accounts/{accountId}/mastodon/endorsements`

Accounts you feature (endorse) on your profile. Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/endorsements/ Generic route: /v1/accounts/{accountId}/focus/endorsements.

Access: `write` · MCP tool: `mastodon-endorsements-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `account_id` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/endorsements" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "acct": "string",
  "username": "string",
  "display_name": "string",
  "url": "https://example.com",
  "avatar": "string",
  "header": "string",
  "note": "string",
  "note_text": "string",
  "locked": true,
  "bot": true,
  "group": true,
  "discoverable": true,
  "indexable": true,
  "followers_count": 1,
  "following_count": 1,
  "statuses_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "last_status_at": "2026-10-13",
  "fields": [
    {
      "name": "string",
      "value": "string",
      "verified_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "moved": {},
  "suspended": true,
  "limited": true
}
```

## Mastodon: Delete a Featured accounts item

`DELETE /accounts/{accountId}/mastodon/endorsements/{itemId}`

Accounts you feature (endorse) on your profile. Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/endorsements/ Generic route: /v1/accounts/{accountId}/focus/endorsements.

Access: `write` · MCP tool: `mastodon-endorsements-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/endorsements/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: List Collections

`GET /accounts/{accountId}/mastodon/collections`

Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: /v1/accounts/{accountId}/focus/collections.

Access: `read` · MCP tool: `mastodon-collections-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)
- `account_id` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/collections" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "sensitive": true,
      "discoverable": true,
      "language": "en",
      "tag": {},
      "items_count": 1,
      "items": [
        {
          "id": "string",
          "state": "string",
          "account": {
            "id": null,
            "acct": null
          }
        }
      ],
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Create a Collections item

`POST /accounts/{accountId}/mastodon/collections`

Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Requires scopes: read:collections, write:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: /v1/accounts/{accountId}/focus/collections.

Access: `write` · MCP tool: `mastodon-collections-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `name` (string; required)
- `description` (string)
- `sensitive` (boolean)
- `discoverable` (boolean)
- `language` (string)
- `tag_name` (string)
- `account_ids` (array of string; ≤ 25 items)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/collections" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "description": "string",
    "sensitive": true,
    "discoverable": true,
    "language": "en"
  }'
```

Response 201:

```json
{
  "id": "string",
  "name": "string",
  "description": "string",
  "sensitive": true,
  "discoverable": true,
  "language": "en",
  "tag": {},
  "items_count": 1,
  "items": [
    {
      "id": "string",
      "state": "string",
      "account": {
        "id": "string",
        "acct": "string"
      }
    }
  ],
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Mastodon: Get a Collections item

`GET /accounts/{accountId}/mastodon/collections/{itemId}`

Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Requires scopes: read:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: /v1/accounts/{accountId}/focus/collections.

Access: `read` · MCP tool: `mastodon-collections-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/collections/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "description": "string",
  "sensitive": true,
  "discoverable": true,
  "language": "en",
  "tag": {},
  "items_count": 1,
  "items": [
    {
      "id": "string",
      "state": "string",
      "account": {
        "id": "string",
        "acct": "string"
      }
    }
  ],
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Mastodon: Update a Collections item

`PATCH /accounts/{accountId}/mastodon/collections/{itemId}`

Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Requires scopes: read:collections, write:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: /v1/accounts/{accountId}/focus/collections.

Access: `write` · MCP tool: `mastodon-collections-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `name` (string)
- `description` (string)
- `sensitive` (boolean)
- `discoverable` (boolean)
- `language` (string)
- `tag_name` (string)
- `account_ids` (array of string; ≤ 25 items)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/collections/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "description": "string",
    "sensitive": true,
    "discoverable": true,
    "language": "en"
  }'
```

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "description": "string",
  "sensitive": true,
  "discoverable": true,
  "language": "en",
  "tag": {},
  "items_count": 1,
  "items": [
    {
      "id": "string",
      "state": "string",
      "account": {
        "id": "string",
        "acct": "string"
      }
    }
  ],
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Mastodon: Delete a Collections item

`DELETE /accounts/{accountId}/mastodon/collections/{itemId}`

Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Requires scopes: read:collections, write:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: /v1/accounts/{accountId}/focus/collections.

Access: `write` · MCP tool: `mastodon-collections-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/collections/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: Add account (Collections)

`POST /accounts/{accountId}/mastodon/collections/{itemId}/add-item`

Add account. Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Requires scopes: read:collections, write:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: /v1/accounts/{accountId}/focus/collections.

Access: `write` · MCP tool: `mastodon-collections-add-item`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `account_id` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/collections/ITEM_ID/add-item" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "string"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Remove account (Collections)

`POST /accounts/{accountId}/mastodon/collections/{itemId}/remove-item`

Remove account. Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Requires scopes: read:collections, write:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: /v1/accounts/{accountId}/focus/collections.

Access: `write` · MCP tool: `mastodon-collections-remove-item`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `item_id` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/collections/ITEM_ID/remove-item" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "item_id": "string"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Remove me from this collection (Collections)

`POST /accounts/{accountId}/mastodon/collections/{itemId}/revoke`

Remove me from this collection. Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Destructive. Requires scopes: read:collections, write:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: /v1/accounts/{accountId}/focus/collections.

Access: `write` · MCP tool: `mastodon-collections-revoke`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `item_id` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/collections/ITEM_ID/revoke" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "item_id": "string"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Collections featuring an account (Collections)

`POST /accounts/{accountId}/mastodon/collections/in-collections`

Collections featuring an account. Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Requires scopes: read:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: /v1/accounts/{accountId}/focus/collections.

Access: `write` · MCP tool: `mastodon-collections-in-collections`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)
- `account_id` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/collections/in-collections" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "cursor": "string",
    "limit": 20,
    "account_id": "string"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Who to follow

`GET /accounts/{accountId}/mastodon/suggestions`

Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/suggestions/ Generic route: /v1/accounts/{accountId}/focus/suggestions.

Access: `read` · MCP tool: `mastodon-suggestions-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; ≤ 80)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/suggestions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "acct": "string",
      "username": "string",
      "display_name": "string",
      "url": "https://example.com",
      "avatar": "string",
      "header": "string",
      "note": "string",
      "note_text": "string",
      "locked": true,
      "bot": true,
      "group": true,
      "discoverable": true,
      "indexable": true,
      "followers_count": 1,
      "following_count": 1,
      "statuses_count": 1,
      "created_at": "2026-10-13T09:00:00.000Z",
      "last_status_at": "2026-10-13",
      "fields": [
        {
          "name": "string",
          "value": "string",
          "verified_at": "2026-10-13T09:00:00.000Z"
        }
      ],
      "moved": {},
      "suspended": true,
      "limited": true,
      "sources": [
        "string"
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Delete a Who to follow item

`DELETE /accounts/{accountId}/mastodon/suggestions/{itemId}`

Never suggest this account again. Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/suggestions/ Generic route: /v1/accounts/{accountId}/focus/suggestions.

Access: `write` · MCP tool: `mastodon-suggestions-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/suggestions/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: Follow (Who to follow)

`POST /accounts/{accountId}/mastodon/suggestions/{itemId}/follow`

Follow. Requires scopes: read:accounts, write:follows. Network docs: https://docs.joinmastodon.org/methods/suggestions/ Generic route: /v1/accounts/{accountId}/focus/suggestions.

Access: `write` · MCP tool: `mastodon-suggestions-follow`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `reblogs` (boolean)
- `notify` (boolean)
- `languages` (array of string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/suggestions/ITEM_ID/follow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reblogs": true,
    "notify": true,
    "languages": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Profile directory

`GET /accounts/{accountId}/mastodon/directory`

Discoverable accounts known to the instance. Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/directory/ Generic route: /v1/accounts/{accountId}/focus/directory.

Access: `read` · MCP tool: `mastodon-directory-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `order` (string; one of active, new)
- `local` (boolean)
- `limit` (integer; ≤ 80)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/directory" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "acct": "string",
      "username": "string",
      "display_name": "string",
      "url": "https://example.com",
      "avatar": "string",
      "header": "string",
      "note": "string",
      "note_text": "string",
      "locked": true,
      "bot": true,
      "group": true,
      "discoverable": true,
      "indexable": true,
      "followers_count": 1,
      "following_count": 1,
      "statuses_count": 1,
      "created_at": "2026-10-13T09:00:00.000Z",
      "last_status_at": "2026-10-13",
      "fields": [
        {
          "name": "string",
          "value": "string",
          "verified_at": "2026-10-13T09:00:00.000Z"
        }
      ],
      "moved": {},
      "suspended": true,
      "limited": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Follow (Profile directory)

`POST /accounts/{accountId}/mastodon/directory/{itemId}/follow`

Follow. Discoverable accounts known to the instance. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/directory/ Generic route: /v1/accounts/{accountId}/focus/directory.

Access: `write` · MCP tool: `mastodon-directory-follow`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `reblogs` (boolean)
- `notify` (boolean)
- `languages` (array of string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/directory/ITEM_ID/follow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reblogs": true,
    "notify": true,
    "languages": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Bookmarks

`GET /accounts/{accountId}/mastodon/bookmarks`

Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:bookmarks. Network docs: https://docs.joinmastodon.org/methods/bookmarks/ Generic route: /v1/accounts/{accountId}/focus/bookmarks.

Access: `read` · MCP tool: `mastodon-bookmarks-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/bookmarks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "https://example.com",
      "url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "edited_at": "2026-10-13T09:00:00.000Z",
      "text": "string",
      "content": "string",
      "spoiler_text": "string",
      "sensitive": true,
      "visibility": "public",
      "language": "en",
      "in_reply_to_id": "string",
      "in_reply_to_account_id": "string",
      "replies_count": 1,
      "reblogs_count": 1,
      "favourites_count": 1,
      "quotes_count": 1,
      "author": "string",
      "author_name": "string",
      "media_attachments": [
        {
          "id": "string",
          "type": "image",
          "url": "https://example.com",
          "preview_url": "https://example.com",
          "remote_url": "https://example.com",
          "description": "string"
        }
      ],
      "poll": {
        "id": "string",
        "expires_at": "2026-10-13T09:00:00.000Z",
        "expired": true,
        "multiple": true,
        "votes_count": 1,
        "voters_count": 1
      },
      "favourited": true,
      "reblogged": true,
      "bookmarked": true,
      "muted": true,
      "pinned": true,
      "is_reblog": true,
      "quote": {
        "state": "string",
        "quoted_status": {}
      },
      "quote_approval": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Create a Bookmarks item

`POST /accounts/{accountId}/mastodon/bookmarks`

Requires scopes: read:bookmarks, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/bookmarks/ Generic route: /v1/accounts/{accountId}/focus/bookmarks.

Access: `write` · MCP tool: `mastodon-bookmarks-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `status_id` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/bookmarks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status_id": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "uri": "https://example.com",
  "url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "edited_at": "2026-10-13T09:00:00.000Z",
  "text": "string",
  "content": "string",
  "spoiler_text": "string",
  "sensitive": true,
  "visibility": "public",
  "language": "en",
  "in_reply_to_id": "string",
  "in_reply_to_account_id": "string",
  "replies_count": 1,
  "reblogs_count": 1,
  "favourites_count": 1,
  "quotes_count": 1,
  "author": "string",
  "author_name": "string",
  "media_attachments": [
    {
      "id": "string",
      "type": "image",
      "url": "https://example.com",
      "preview_url": "https://example.com",
      "remote_url": "https://example.com",
      "description": "string",
      "blurhash": "string",
      "meta": {}
    }
  ],
  "poll": {
    "id": "string",
    "expires_at": "2026-10-13T09:00:00.000Z",
    "expired": true,
    "multiple": true,
    "votes_count": 1,
    "voters_count": 1,
    "voted": true,
    "own_votes": [
      1
    ],
    "options": [
      {
        "title": "string",
        "votes_count": 1
      }
    ]
  },
  "favourited": true,
  "reblogged": true,
  "bookmarked": true,
  "muted": true,
  "pinned": true,
  "is_reblog": true,
  "quote": {
    "state": "string",
    "quoted_status": {}
  },
  "quote_approval": {}
}
```

## Mastodon: Delete a Bookmarks item

`DELETE /accounts/{accountId}/mastodon/bookmarks/{itemId}`

Requires scopes: read:bookmarks, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/bookmarks/ Generic route: /v1/accounts/{accountId}/focus/bookmarks.

Access: `write` · MCP tool: `mastodon-bookmarks-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/bookmarks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: Favourite (Bookmarks)

`POST /accounts/{accountId}/mastodon/bookmarks/{itemId}/favourite`

Favourite. Requires scopes: read:bookmarks, write:favourites. Network docs: https://docs.joinmastodon.org/methods/bookmarks/ Generic route: /v1/accounts/{accountId}/focus/bookmarks.

Access: `write` · MCP tool: `mastodon-bookmarks-favourite`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/bookmarks/ITEM_ID/favourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Boost (Bookmarks)

`POST /accounts/{accountId}/mastodon/bookmarks/{itemId}/boost`

Boost. Requires scopes: read:bookmarks, write:statuses. Network docs: https://docs.joinmastodon.org/methods/bookmarks/ Generic route: /v1/accounts/{accountId}/focus/bookmarks.

Access: `write` · MCP tool: `mastodon-bookmarks-boost`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `visibility` (string; one of public, unlisted, private)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/bookmarks/ITEM_ID/boost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "visibility": "public"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Reply (Bookmarks)

`POST /accounts/{accountId}/mastodon/bookmarks/{itemId}/reply`

Reply. Requires scopes: read:bookmarks, write:statuses. Network docs: https://docs.joinmastodon.org/methods/bookmarks/ Generic route: /v1/accounts/{accountId}/focus/bookmarks.

Access: `write` · MCP tool: `mastodon-bookmarks-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `status` (string): Plain text; URLs count as 23 characters
- `visibility` (string; one of public, unlisted, private, direct)
- `spoiler_text` (string)
- `sensitive` (boolean)
- `language` (string): ISO 639-1
- `media` (array of string): Socialit media ids (uploaded to the instance on publish)
- `media_ids` (array of string): Already-uploaded Mastodon media ids
- `alt_texts` (array of string): Alt text per media item, by index
- `poll` (object)
  - `poll.options` (array of string; ≥ 2 items)
  - `poll.expires_in` (integer)
  - `poll.multiple` (boolean)
  - `poll.hide_totals` (boolean)
- `in_reply_to_id` (string)
- `quoted_status_id` (string): Mastodon 4.5+
- `quote_approval_policy` (string; one of public, followers, nobody)
- `scheduled_at` (string (date-time)): ≥ 5 minutes ahead → ScheduledStatus
- `thread` (array of string): Follow-up replies posted as a self-thread

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/bookmarks/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Favourites

`GET /accounts/{accountId}/mastodon/favourites`

Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:favourites. Network docs: https://docs.joinmastodon.org/methods/favourites/ Generic route: /v1/accounts/{accountId}/focus/favourites.

Access: `read` · MCP tool: `mastodon-favourites-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/favourites" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "https://example.com",
      "url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "edited_at": "2026-10-13T09:00:00.000Z",
      "text": "string",
      "content": "string",
      "spoiler_text": "string",
      "sensitive": true,
      "visibility": "public",
      "language": "en",
      "in_reply_to_id": "string",
      "in_reply_to_account_id": "string",
      "replies_count": 1,
      "reblogs_count": 1,
      "favourites_count": 1,
      "quotes_count": 1,
      "author": "string",
      "author_name": "string",
      "media_attachments": [
        {
          "id": "string",
          "type": "image",
          "url": "https://example.com",
          "preview_url": "https://example.com",
          "remote_url": "https://example.com",
          "description": "string"
        }
      ],
      "poll": {
        "id": "string",
        "expires_at": "2026-10-13T09:00:00.000Z",
        "expired": true,
        "multiple": true,
        "votes_count": 1,
        "voters_count": 1
      },
      "favourited": true,
      "reblogged": true,
      "bookmarked": true,
      "muted": true,
      "pinned": true,
      "is_reblog": true,
      "quote": {
        "state": "string",
        "quoted_status": {}
      },
      "quote_approval": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Create a Favourites item

`POST /accounts/{accountId}/mastodon/favourites`

Requires scopes: read:favourites, write:favourites. Network docs: https://docs.joinmastodon.org/methods/favourites/ Generic route: /v1/accounts/{accountId}/focus/favourites.

Access: `write` · MCP tool: `mastodon-favourites-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `status_id` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/favourites" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status_id": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "uri": "https://example.com",
  "url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "edited_at": "2026-10-13T09:00:00.000Z",
  "text": "string",
  "content": "string",
  "spoiler_text": "string",
  "sensitive": true,
  "visibility": "public",
  "language": "en",
  "in_reply_to_id": "string",
  "in_reply_to_account_id": "string",
  "replies_count": 1,
  "reblogs_count": 1,
  "favourites_count": 1,
  "quotes_count": 1,
  "author": "string",
  "author_name": "string",
  "media_attachments": [
    {
      "id": "string",
      "type": "image",
      "url": "https://example.com",
      "preview_url": "https://example.com",
      "remote_url": "https://example.com",
      "description": "string",
      "blurhash": "string",
      "meta": {}
    }
  ],
  "poll": {
    "id": "string",
    "expires_at": "2026-10-13T09:00:00.000Z",
    "expired": true,
    "multiple": true,
    "votes_count": 1,
    "voters_count": 1,
    "voted": true,
    "own_votes": [
      1
    ],
    "options": [
      {
        "title": "string",
        "votes_count": 1
      }
    ]
  },
  "favourited": true,
  "reblogged": true,
  "bookmarked": true,
  "muted": true,
  "pinned": true,
  "is_reblog": true,
  "quote": {
    "state": "string",
    "quoted_status": {}
  },
  "quote_approval": {}
}
```

## Mastodon: Delete a Favourites item

`DELETE /accounts/{accountId}/mastodon/favourites/{itemId}`

Requires scopes: read:favourites, write:favourites. Network docs: https://docs.joinmastodon.org/methods/favourites/ Generic route: /v1/accounts/{accountId}/focus/favourites.

Access: `write` · MCP tool: `mastodon-favourites-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/favourites/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: Bookmark (Favourites)

`POST /accounts/{accountId}/mastodon/favourites/{itemId}/bookmark`

Bookmark. Requires scopes: read:favourites, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/favourites/ Generic route: /v1/accounts/{accountId}/focus/favourites.

Access: `write` · MCP tool: `mastodon-favourites-bookmark`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/favourites/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Boost (Favourites)

`POST /accounts/{accountId}/mastodon/favourites/{itemId}/boost`

Boost. Requires scopes: read:favourites, write:statuses. Network docs: https://docs.joinmastodon.org/methods/favourites/ Generic route: /v1/accounts/{accountId}/focus/favourites.

Access: `write` · MCP tool: `mastodon-favourites-boost`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `visibility` (string; one of public, unlisted, private)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/favourites/ITEM_ID/boost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "visibility": "public"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Reply (Favourites)

`POST /accounts/{accountId}/mastodon/favourites/{itemId}/reply`

Reply. Requires scopes: read:favourites, write:statuses. Network docs: https://docs.joinmastodon.org/methods/favourites/ Generic route: /v1/accounts/{accountId}/focus/favourites.

Access: `write` · MCP tool: `mastodon-favourites-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `status` (string): Plain text; URLs count as 23 characters
- `visibility` (string; one of public, unlisted, private, direct)
- `spoiler_text` (string)
- `sensitive` (boolean)
- `language` (string): ISO 639-1
- `media` (array of string): Socialit media ids (uploaded to the instance on publish)
- `media_ids` (array of string): Already-uploaded Mastodon media ids
- `alt_texts` (array of string): Alt text per media item, by index
- `poll` (object)
  - `poll.options` (array of string; ≥ 2 items)
  - `poll.expires_in` (integer)
  - `poll.multiple` (boolean)
  - `poll.hide_totals` (boolean)
- `in_reply_to_id` (string)
- `quoted_status_id` (string): Mastodon 4.5+
- `quote_approval_policy` (string; one of public, followers, nobody)
- `scheduled_at` (string (date-time)): ≥ 5 minutes ahead → ScheduledStatus
- `thread` (array of string): Follow-up replies posted as a self-thread

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/favourites/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Followed hashtags

`GET /accounts/{accountId}/mastodon/followed-tags`

Hashtags whose posts appear in your home timeline. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:follows. Network docs: https://docs.joinmastodon.org/methods/followed_tags/ Generic route: /v1/accounts/{accountId}/focus/followed-tags.

Access: `read` · MCP tool: `mastodon-followed-tags-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/followed-tags" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "url": "https://example.com",
      "following": true,
      "featuring": true,
      "history": [
        {
          "day": "string",
          "uses": "string",
          "accounts": "string"
        }
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Create a Followed hashtags item

`POST /accounts/{accountId}/mastodon/followed-tags`

Hashtags whose posts appear in your home timeline. Requires scopes: read:follows, write:follows. Network docs: https://docs.joinmastodon.org/methods/followed_tags/ Generic route: /v1/accounts/{accountId}/focus/followed-tags.

Access: `write` · MCP tool: `mastodon-followed-tags-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `name` (string; required): Without #

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/followed-tags" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "name": "string",
  "url": "https://example.com",
  "following": true,
  "featuring": true,
  "history": [
    {
      "day": "string",
      "uses": "string",
      "accounts": "string"
    }
  ]
}
```

## Mastodon: Get a Followed hashtags item

`GET /accounts/{accountId}/mastodon/followed-tags/{itemId}`

Hashtags whose posts appear in your home timeline. Requires scopes: read:follows. Network docs: https://docs.joinmastodon.org/methods/followed_tags/ Generic route: /v1/accounts/{accountId}/focus/followed-tags.

Access: `read` · MCP tool: `mastodon-followed-tags-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/followed-tags/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "url": "https://example.com",
  "following": true,
  "featuring": true,
  "history": [
    {
      "day": "string",
      "uses": "string",
      "accounts": "string"
    }
  ]
}
```

## Mastodon: Delete a Followed hashtags item

`DELETE /accounts/{accountId}/mastodon/followed-tags/{itemId}`

Hashtags whose posts appear in your home timeline. Requires scopes: read:follows, write:follows. Network docs: https://docs.joinmastodon.org/methods/followed_tags/ Generic route: /v1/accounts/{accountId}/focus/followed-tags.

Access: `write` · MCP tool: `mastodon-followed-tags-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/followed-tags/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: List Featured hashtags

`GET /accounts/{accountId}/mastodon/featured-tags`

Hashtags featured on your profile (max configuration.accounts.max_featured_tags, default 10). Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/featured_tags/ Generic route: /v1/accounts/{accountId}/focus/featured-tags.

Access: `read` · MCP tool: `mastodon-featured-tags-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/featured-tags" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "url": "https://example.com",
      "statuses_count": 1,
      "last_status_at": "2026-10-13"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Create a Featured hashtags item

`POST /accounts/{accountId}/mastodon/featured-tags`

Hashtags featured on your profile (max configuration.accounts.max_featured_tags, default 10). Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/featured_tags/ Generic route: /v1/accounts/{accountId}/focus/featured-tags.

Access: `write` · MCP tool: `mastodon-featured-tags-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `name` (string; required): Without #

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/featured-tags" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "name": "string",
  "url": "https://example.com",
  "statuses_count": 1,
  "last_status_at": "2026-10-13"
}
```

## Mastodon: Delete a Featured hashtags item

`DELETE /accounts/{accountId}/mastodon/featured-tags/{itemId}`

Hashtags featured on your profile (max configuration.accounts.max_featured_tags, default 10). Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/featured_tags/ Generic route: /v1/accounts/{accountId}/focus/featured-tags.

Access: `write` · MCP tool: `mastodon-featured-tags-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/featured-tags/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: Suggestions (Featured hashtags)

`POST /accounts/{accountId}/mastodon/featured-tags/suggestions`

Suggestions. Hashtags featured on your profile (max configuration.accounts.max_featured_tags, default 10). Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/featured_tags/ Generic route: /v1/accounts/{accountId}/focus/featured-tags.

Access: `write` · MCP tool: `mastodon-featured-tags-suggestions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/featured-tags/suggestions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Filters

`GET /accounts/{accountId}/mastodon/filters`

Keyword / status filters (v2) with warn, hide or blur actions. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:filters. Network docs: https://docs.joinmastodon.org/methods/filters/ Generic route: /v1/accounts/{accountId}/focus/filters.

Access: `read` · MCP tool: `mastodon-filters-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filters" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "title": "string",
      "context": [
        "home"
      ],
      "filter_action": "warn",
      "expires_at": "2026-10-13T09:00:00.000Z",
      "keywords": [
        {
          "id": "string",
          "keyword": "string",
          "whole_word": true
        }
      ],
      "statuses": [
        {
          "id": "string",
          "status_id": "string"
        }
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Create a Filters item

`POST /accounts/{accountId}/mastodon/filters`

Keyword / status filters (v2) with warn, hide or blur actions. Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/ Generic route: /v1/accounts/{accountId}/focus/filters.

Access: `write` · MCP tool: `mastodon-filters-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `title` (string; required)
- `context` (array of string; required)
- `filter_action` (string; one of warn, hide, blur)
- `expires_in` (integer): Seconds; omit for never
- `keywords_attributes` (array of object)
  - `keywords_attributes[].id` (string)
  - `keywords_attributes[].keyword` (string)
  - `keywords_attributes[].whole_word` (boolean)
  - `keywords_attributes[]._destroy` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filters" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "context": [
      "home"
    ],
    "filter_action": "warn",
    "expires_in": 1,
    "keywords_attributes": [
      {
        "id": "string",
        "keyword": "string"
      }
    ]
  }'
```

Response 201:

```json
{
  "id": "string",
  "title": "string",
  "context": [
    "home"
  ],
  "filter_action": "warn",
  "expires_at": "2026-10-13T09:00:00.000Z",
  "keywords": [
    {
      "id": "string",
      "keyword": "string",
      "whole_word": true
    }
  ],
  "statuses": [
    {
      "id": "string",
      "status_id": "string"
    }
  ]
}
```

## Mastodon: Get a Filters item

`GET /accounts/{accountId}/mastodon/filters/{itemId}`

Keyword / status filters (v2) with warn, hide or blur actions. Requires scopes: read:filters. Network docs: https://docs.joinmastodon.org/methods/filters/ Generic route: /v1/accounts/{accountId}/focus/filters.

Access: `read` · MCP tool: `mastodon-filters-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filters/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "context": [
    "home"
  ],
  "filter_action": "warn",
  "expires_at": "2026-10-13T09:00:00.000Z",
  "keywords": [
    {
      "id": "string",
      "keyword": "string",
      "whole_word": true
    }
  ],
  "statuses": [
    {
      "id": "string",
      "status_id": "string"
    }
  ]
}
```

## Mastodon: Update a Filters item

`PATCH /accounts/{accountId}/mastodon/filters/{itemId}`

Keyword / status filters (v2) with warn, hide or blur actions. Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/ Generic route: /v1/accounts/{accountId}/focus/filters.

Access: `write` · MCP tool: `mastodon-filters-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `title` (string)
- `context` (array of string)
- `filter_action` (string; one of warn, hide, blur)
- `expires_in` (integer): Seconds; omit for never
- `keywords_attributes` (array of object)
  - `keywords_attributes[].id` (string)
  - `keywords_attributes[].keyword` (string)
  - `keywords_attributes[].whole_word` (boolean)
  - `keywords_attributes[]._destroy` (boolean)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filters/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "context": [
      "home"
    ],
    "filter_action": "warn",
    "expires_in": 1,
    "keywords_attributes": [
      {
        "id": "string",
        "keyword": "string"
      }
    ]
  }'
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "context": [
    "home"
  ],
  "filter_action": "warn",
  "expires_at": "2026-10-13T09:00:00.000Z",
  "keywords": [
    {
      "id": "string",
      "keyword": "string",
      "whole_word": true
    }
  ],
  "statuses": [
    {
      "id": "string",
      "status_id": "string"
    }
  ]
}
```

## Mastodon: Delete a Filters item

`DELETE /accounts/{accountId}/mastodon/filters/{itemId}`

Keyword / status filters (v2) with warn, hide or blur actions. Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/ Generic route: /v1/accounts/{accountId}/focus/filters.

Access: `write` · MCP tool: `mastodon-filters-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filters/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: Add keyword (Filters)

`POST /accounts/{accountId}/mastodon/filters/{itemId}/add-keyword`

Add keyword. Keyword / status filters (v2) with warn, hide or blur actions. Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/ Generic route: /v1/accounts/{accountId}/focus/filters.

Access: `write` · MCP tool: `mastodon-filters-add-keyword`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `keyword` (string; required)
- `whole_word` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filters/ITEM_ID/add-keyword" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "string",
    "whole_word": true
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Filter a status (Filters)

`POST /accounts/{accountId}/mastodon/filters/{itemId}/add-status`

Filter a status. Keyword / status filters (v2) with warn, hide or blur actions. Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/ Generic route: /v1/accounts/{accountId}/focus/filters.

Access: `write` · MCP tool: `mastodon-filters-add-status`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `status_id` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filters/ITEM_ID/add-status" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status_id": "string"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Filter keywords

`GET /accounts/{accountId}/mastodon/filter-keywords`

Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#keywords-get Generic route: /v1/accounts/{accountId}/focus/filter-keywords.

Access: `read` · MCP tool: `mastodon-filter-keywords-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `filter_id` (string; required)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filter-keywords?filter_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "keyword": "string",
      "whole_word": true,
      "filter_id": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Create a Filter keywords item

`POST /accounts/{accountId}/mastodon/filter-keywords`

Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#keywords-get Generic route: /v1/accounts/{accountId}/focus/filter-keywords.

Access: `write` · MCP tool: `mastodon-filter-keywords-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `filter_id` (string; required)
- `keyword` (string; required)
- `whole_word` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filter-keywords" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "filter_id": "string",
    "keyword": "string",
    "whole_word": true
  }'
```

Response 201:

```json
{
  "id": "string",
  "keyword": "string",
  "whole_word": true,
  "filter_id": "string"
}
```

## Mastodon: Get a Filter keywords item

`GET /accounts/{accountId}/mastodon/filter-keywords/{itemId}`

Requires scopes: read:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#keywords-get Generic route: /v1/accounts/{accountId}/focus/filter-keywords.

Access: `read` · MCP tool: `mastodon-filter-keywords-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filter-keywords/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "keyword": "string",
  "whole_word": true,
  "filter_id": "string"
}
```

## Mastodon: Update a Filter keywords item

`PATCH /accounts/{accountId}/mastodon/filter-keywords/{itemId}`

Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#keywords-get Generic route: /v1/accounts/{accountId}/focus/filter-keywords.

Access: `write` · MCP tool: `mastodon-filter-keywords-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `keyword` (string)
- `whole_word` (boolean)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filter-keywords/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "string",
    "whole_word": true
  }'
```

Response 200:

```json
{
  "id": "string",
  "keyword": "string",
  "whole_word": true,
  "filter_id": "string"
}
```

## Mastodon: Delete a Filter keywords item

`DELETE /accounts/{accountId}/mastodon/filter-keywords/{itemId}`

Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#keywords-get Generic route: /v1/accounts/{accountId}/focus/filter-keywords.

Access: `write` · MCP tool: `mastodon-filter-keywords-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filter-keywords/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: List Filtered posts

`GET /accounts/{accountId}/mastodon/filter-statuses`

Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#statuses-get Generic route: /v1/accounts/{accountId}/focus/filter-statuses.

Access: `read` · MCP tool: `mastodon-filter-statuses-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `filter_id` (string; required)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filter-statuses?filter_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "status_id": "string",
      "filter_id": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Create a Filtered posts item

`POST /accounts/{accountId}/mastodon/filter-statuses`

Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#statuses-get Generic route: /v1/accounts/{accountId}/focus/filter-statuses.

Access: `write` · MCP tool: `mastodon-filter-statuses-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `filter_id` (string; required)
- `status_id` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filter-statuses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "filter_id": "string",
    "status_id": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "status_id": "string",
  "filter_id": "string"
}
```

## Mastodon: Get a Filtered posts item

`GET /accounts/{accountId}/mastodon/filter-statuses/{itemId}`

Requires scopes: read:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#statuses-get Generic route: /v1/accounts/{accountId}/focus/filter-statuses.

Access: `read` · MCP tool: `mastodon-filter-statuses-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filter-statuses/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "status_id": "string",
  "filter_id": "string"
}
```

## Mastodon: Delete a Filtered posts item

`DELETE /accounts/{accountId}/mastodon/filter-statuses/{itemId}`

Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#statuses-get Generic route: /v1/accounts/{accountId}/focus/filter-statuses.

Access: `write` · MCP tool: `mastodon-filter-statuses-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filter-statuses/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: List Read markers

`GET /accounts/{accountId}/mastodon/markers`

Last-read position in home and notifications, synced across clients. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/markers/ Generic route: /v1/accounts/{accountId}/focus/markers.

Access: `read` · MCP tool: `mastodon-markers-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/markers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "home",
      "last_read_id": "string",
      "version": 1,
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Update a Read markers item

`PATCH /accounts/{accountId}/mastodon/markers/{itemId}`

Last-read position in home and notifications, synced across clients. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/markers/ Generic route: /v1/accounts/{accountId}/focus/markers.

Access: `write` · MCP tool: `mastodon-markers-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `last_read_id` (string; required)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/markers/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "last_read_id": "string"
  }'
```

Response 200:

```json
{
  "id": "home",
  "last_read_id": "string",
  "version": 1,
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Mastodon: List Home

`GET /accounts/{accountId}/mastodon/home-timeline`

Posts from people and hashtags you follow. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/home-timeline.

Access: `read` · MCP tool: `mastodon-home-timeline-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/home-timeline" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "https://example.com",
      "url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "edited_at": "2026-10-13T09:00:00.000Z",
      "text": "string",
      "content": "string",
      "spoiler_text": "string",
      "sensitive": true,
      "visibility": "public",
      "language": "en",
      "in_reply_to_id": "string",
      "in_reply_to_account_id": "string",
      "replies_count": 1,
      "reblogs_count": 1,
      "favourites_count": 1,
      "quotes_count": 1,
      "author": "string",
      "author_name": "string",
      "media_attachments": [
        {
          "id": "string",
          "type": "image",
          "url": "https://example.com",
          "preview_url": "https://example.com",
          "remote_url": "https://example.com",
          "description": "string"
        }
      ],
      "poll": {
        "id": "string",
        "expires_at": "2026-10-13T09:00:00.000Z",
        "expired": true,
        "multiple": true,
        "votes_count": 1,
        "voters_count": 1
      },
      "favourited": true,
      "reblogged": true,
      "bookmarked": true,
      "muted": true,
      "pinned": true,
      "is_reblog": true,
      "quote": {
        "state": "string",
        "quoted_status": {}
      },
      "quote_approval": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Favourite (Home)

`POST /accounts/{accountId}/mastodon/home-timeline/{itemId}/favourite`

Favourite. Posts from people and hashtags you follow. Requires scopes: read:statuses, write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/home-timeline.

Access: `write` · MCP tool: `mastodon-home-timeline-favourite`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/home-timeline/ITEM_ID/favourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unfavourite (Home)

`POST /accounts/{accountId}/mastodon/home-timeline/{itemId}/unfavourite`

Unfavourite. Posts from people and hashtags you follow. Requires scopes: read:statuses, write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/home-timeline.

Access: `write` · MCP tool: `mastodon-home-timeline-unfavourite`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/home-timeline/ITEM_ID/unfavourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Boost (Home)

`POST /accounts/{accountId}/mastodon/home-timeline/{itemId}/boost`

Boost. Posts from people and hashtags you follow. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/home-timeline.

Access: `write` · MCP tool: `mastodon-home-timeline-boost`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `visibility` (string; one of public, unlisted, private)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/home-timeline/ITEM_ID/boost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "visibility": "public"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Undo boost (Home)

`POST /accounts/{accountId}/mastodon/home-timeline/{itemId}/unboost`

Undo boost. Posts from people and hashtags you follow. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/home-timeline.

Access: `write` · MCP tool: `mastodon-home-timeline-unboost`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/home-timeline/ITEM_ID/unboost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Bookmark (Home)

`POST /accounts/{accountId}/mastodon/home-timeline/{itemId}/bookmark`

Bookmark. Posts from people and hashtags you follow. Requires scopes: read:statuses, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/home-timeline.

Access: `write` · MCP tool: `mastodon-home-timeline-bookmark`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/home-timeline/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Remove bookmark (Home)

`POST /accounts/{accountId}/mastodon/home-timeline/{itemId}/unbookmark`

Remove bookmark. Posts from people and hashtags you follow. Requires scopes: read:statuses, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/home-timeline.

Access: `write` · MCP tool: `mastodon-home-timeline-unbookmark`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/home-timeline/ITEM_ID/unbookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Reply (Home)

`POST /accounts/{accountId}/mastodon/home-timeline/{itemId}/reply`

Reply. Posts from people and hashtags you follow. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/home-timeline.

Access: `write` · MCP tool: `mastodon-home-timeline-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `status` (string): Plain text; URLs count as 23 characters
- `visibility` (string; one of public, unlisted, private, direct)
- `spoiler_text` (string)
- `sensitive` (boolean)
- `language` (string): ISO 639-1
- `media` (array of string): Socialit media ids (uploaded to the instance on publish)
- `media_ids` (array of string): Already-uploaded Mastodon media ids
- `alt_texts` (array of string): Alt text per media item, by index
- `poll` (object)
  - `poll.options` (array of string; ≥ 2 items)
  - `poll.expires_in` (integer)
  - `poll.multiple` (boolean)
  - `poll.hide_totals` (boolean)
- `in_reply_to_id` (string)
- `quoted_status_id` (string): Mastodon 4.5+
- `quote_approval_policy` (string; one of public, followers, nobody)
- `scheduled_at` (string (date-time)): ≥ 5 minutes ahead → ScheduledStatus
- `thread` (array of string): Follow-up replies posted as a self-thread

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/home-timeline/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Local

`GET /accounts/{accountId}/mastodon/local-timeline`

Public posts from this server (may be restricted by configuration.timelines_access). Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/local-timeline.

Access: `read` · MCP tool: `mastodon-local-timeline-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)
- `only_media` (boolean)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/local-timeline" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "https://example.com",
      "url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "edited_at": "2026-10-13T09:00:00.000Z",
      "text": "string",
      "content": "string",
      "spoiler_text": "string",
      "sensitive": true,
      "visibility": "public",
      "language": "en",
      "in_reply_to_id": "string",
      "in_reply_to_account_id": "string",
      "replies_count": 1,
      "reblogs_count": 1,
      "favourites_count": 1,
      "quotes_count": 1,
      "author": "string",
      "author_name": "string",
      "media_attachments": [
        {
          "id": "string",
          "type": "image",
          "url": "https://example.com",
          "preview_url": "https://example.com",
          "remote_url": "https://example.com",
          "description": "string"
        }
      ],
      "poll": {
        "id": "string",
        "expires_at": "2026-10-13T09:00:00.000Z",
        "expired": true,
        "multiple": true,
        "votes_count": 1,
        "voters_count": 1
      },
      "favourited": true,
      "reblogged": true,
      "bookmarked": true,
      "muted": true,
      "pinned": true,
      "is_reblog": true,
      "quote": {
        "state": "string",
        "quoted_status": {}
      },
      "quote_approval": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Favourite (Local)

`POST /accounts/{accountId}/mastodon/local-timeline/{itemId}/favourite`

Favourite. Public posts from this server (may be restricted by configuration.timelines_access). Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/local-timeline.

Access: `write` · MCP tool: `mastodon-local-timeline-favourite`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/local-timeline/ITEM_ID/favourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unfavourite (Local)

`POST /accounts/{accountId}/mastodon/local-timeline/{itemId}/unfavourite`

Unfavourite. Public posts from this server (may be restricted by configuration.timelines_access). Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/local-timeline.

Access: `write` · MCP tool: `mastodon-local-timeline-unfavourite`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/local-timeline/ITEM_ID/unfavourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Boost (Local)

`POST /accounts/{accountId}/mastodon/local-timeline/{itemId}/boost`

Boost. Public posts from this server (may be restricted by configuration.timelines_access). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/local-timeline.

Access: `write` · MCP tool: `mastodon-local-timeline-boost`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `visibility` (string; one of public, unlisted, private)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/local-timeline/ITEM_ID/boost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "visibility": "public"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Undo boost (Local)

`POST /accounts/{accountId}/mastodon/local-timeline/{itemId}/unboost`

Undo boost. Public posts from this server (may be restricted by configuration.timelines_access). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/local-timeline.

Access: `write` · MCP tool: `mastodon-local-timeline-unboost`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/local-timeline/ITEM_ID/unboost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Bookmark (Local)

`POST /accounts/{accountId}/mastodon/local-timeline/{itemId}/bookmark`

Bookmark. Public posts from this server (may be restricted by configuration.timelines_access). Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/local-timeline.

Access: `write` · MCP tool: `mastodon-local-timeline-bookmark`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/local-timeline/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Remove bookmark (Local)

`POST /accounts/{accountId}/mastodon/local-timeline/{itemId}/unbookmark`

Remove bookmark. Public posts from this server (may be restricted by configuration.timelines_access). Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/local-timeline.

Access: `write` · MCP tool: `mastodon-local-timeline-unbookmark`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/local-timeline/ITEM_ID/unbookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Reply (Local)

`POST /accounts/{accountId}/mastodon/local-timeline/{itemId}/reply`

Reply. Public posts from this server (may be restricted by configuration.timelines_access). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/local-timeline.

Access: `write` · MCP tool: `mastodon-local-timeline-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `status` (string): Plain text; URLs count as 23 characters
- `visibility` (string; one of public, unlisted, private, direct)
- `spoiler_text` (string)
- `sensitive` (boolean)
- `language` (string): ISO 639-1
- `media` (array of string): Socialit media ids (uploaded to the instance on publish)
- `media_ids` (array of string): Already-uploaded Mastodon media ids
- `alt_texts` (array of string): Alt text per media item, by index
- `poll` (object)
  - `poll.options` (array of string; ≥ 2 items)
  - `poll.expires_in` (integer)
  - `poll.multiple` (boolean)
  - `poll.hide_totals` (boolean)
- `in_reply_to_id` (string)
- `quoted_status_id` (string): Mastodon 4.5+
- `quote_approval_policy` (string; one of public, followers, nobody)
- `scheduled_at` (string (date-time)): ≥ 5 minutes ahead → ScheduledStatus
- `thread` (array of string): Follow-up replies posted as a self-thread

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/local-timeline/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Federated

`GET /accounts/{accountId}/mastodon/federated-timeline`

Public posts from across the fediverse known to this server. Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/federated-timeline.

Access: `read` · MCP tool: `mastodon-federated-timeline-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)
- `only_media` (boolean)
- `remote` (boolean): Only remote posts

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/federated-timeline" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "https://example.com",
      "url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "edited_at": "2026-10-13T09:00:00.000Z",
      "text": "string",
      "content": "string",
      "spoiler_text": "string",
      "sensitive": true,
      "visibility": "public",
      "language": "en",
      "in_reply_to_id": "string",
      "in_reply_to_account_id": "string",
      "replies_count": 1,
      "reblogs_count": 1,
      "favourites_count": 1,
      "quotes_count": 1,
      "author": "string",
      "author_name": "string",
      "media_attachments": [
        {
          "id": "string",
          "type": "image",
          "url": "https://example.com",
          "preview_url": "https://example.com",
          "remote_url": "https://example.com",
          "description": "string"
        }
      ],
      "poll": {
        "id": "string",
        "expires_at": "2026-10-13T09:00:00.000Z",
        "expired": true,
        "multiple": true,
        "votes_count": 1,
        "voters_count": 1
      },
      "favourited": true,
      "reblogged": true,
      "bookmarked": true,
      "muted": true,
      "pinned": true,
      "is_reblog": true,
      "quote": {
        "state": "string",
        "quoted_status": {}
      },
      "quote_approval": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Favourite (Federated)

`POST /accounts/{accountId}/mastodon/federated-timeline/{itemId}/favourite`

Favourite. Public posts from across the fediverse known to this server. Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/federated-timeline.

Access: `write` · MCP tool: `mastodon-federated-timeline-favourite`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/federated-timeline/ITEM_ID/favourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unfavourite (Federated)

`POST /accounts/{accountId}/mastodon/federated-timeline/{itemId}/unfavourite`

Unfavourite. Public posts from across the fediverse known to this server. Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/federated-timeline.

Access: `write` · MCP tool: `mastodon-federated-timeline-unfavourite`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/federated-timeline/ITEM_ID/unfavourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Boost (Federated)

`POST /accounts/{accountId}/mastodon/federated-timeline/{itemId}/boost`

Boost. Public posts from across the fediverse known to this server. Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/federated-timeline.

Access: `write` · MCP tool: `mastodon-federated-timeline-boost`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `visibility` (string; one of public, unlisted, private)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/federated-timeline/ITEM_ID/boost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "visibility": "public"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Undo boost (Federated)

`POST /accounts/{accountId}/mastodon/federated-timeline/{itemId}/unboost`

Undo boost. Public posts from across the fediverse known to this server. Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/federated-timeline.

Access: `write` · MCP tool: `mastodon-federated-timeline-unboost`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/federated-timeline/ITEM_ID/unboost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Bookmark (Federated)

`POST /accounts/{accountId}/mastodon/federated-timeline/{itemId}/bookmark`

Bookmark. Public posts from across the fediverse known to this server. Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/federated-timeline.

Access: `write` · MCP tool: `mastodon-federated-timeline-bookmark`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/federated-timeline/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Remove bookmark (Federated)

`POST /accounts/{accountId}/mastodon/federated-timeline/{itemId}/unbookmark`

Remove bookmark. Public posts from across the fediverse known to this server. Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/federated-timeline.

Access: `write` · MCP tool: `mastodon-federated-timeline-unbookmark`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/federated-timeline/ITEM_ID/unbookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Reply (Federated)

`POST /accounts/{accountId}/mastodon/federated-timeline/{itemId}/reply`

Reply. Public posts from across the fediverse known to this server. Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/federated-timeline.

Access: `write` · MCP tool: `mastodon-federated-timeline-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `status` (string): Plain text; URLs count as 23 characters
- `visibility` (string; one of public, unlisted, private, direct)
- `spoiler_text` (string)
- `sensitive` (boolean)
- `language` (string): ISO 639-1
- `media` (array of string): Socialit media ids (uploaded to the instance on publish)
- `media_ids` (array of string): Already-uploaded Mastodon media ids
- `alt_texts` (array of string): Alt text per media item, by index
- `poll` (object)
  - `poll.options` (array of string; ≥ 2 items)
  - `poll.expires_in` (integer)
  - `poll.multiple` (boolean)
  - `poll.hide_totals` (boolean)
- `in_reply_to_id` (string)
- `quoted_status_id` (string): Mastodon 4.5+
- `quote_approval_policy` (string; one of public, followers, nobody)
- `scheduled_at` (string (date-time)): ≥ 5 minutes ahead → ScheduledStatus
- `thread` (array of string): Follow-up replies posted as a self-thread

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/federated-timeline/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Hashtag

`GET /accounts/{accountId}/mastodon/hashtag-timeline`

Public posts with a hashtag (any/all/none combinations). Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/hashtag-timeline.

Access: `read` · MCP tool: `mastodon-hashtag-timeline-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)
- `tag` (string; required)
- `any` (array of string)
- `all` (array of string)
- `none` (array of string)
- `local` (boolean)
- `remote` (boolean)
- `only_media` (boolean)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/hashtag-timeline?tag=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "https://example.com",
      "url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "edited_at": "2026-10-13T09:00:00.000Z",
      "text": "string",
      "content": "string",
      "spoiler_text": "string",
      "sensitive": true,
      "visibility": "public",
      "language": "en",
      "in_reply_to_id": "string",
      "in_reply_to_account_id": "string",
      "replies_count": 1,
      "reblogs_count": 1,
      "favourites_count": 1,
      "quotes_count": 1,
      "author": "string",
      "author_name": "string",
      "media_attachments": [
        {
          "id": "string",
          "type": "image",
          "url": "https://example.com",
          "preview_url": "https://example.com",
          "remote_url": "https://example.com",
          "description": "string"
        }
      ],
      "poll": {
        "id": "string",
        "expires_at": "2026-10-13T09:00:00.000Z",
        "expired": true,
        "multiple": true,
        "votes_count": 1,
        "voters_count": 1
      },
      "favourited": true,
      "reblogged": true,
      "bookmarked": true,
      "muted": true,
      "pinned": true,
      "is_reblog": true,
      "quote": {
        "state": "string",
        "quoted_status": {}
      },
      "quote_approval": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Favourite (Hashtag)

`POST /accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/favourite`

Favourite. Public posts with a hashtag (any/all/none combinations). Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/hashtag-timeline.

Access: `write` · MCP tool: `mastodon-hashtag-timeline-favourite`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/hashtag-timeline/ITEM_ID/favourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unfavourite (Hashtag)

`POST /accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/unfavourite`

Unfavourite. Public posts with a hashtag (any/all/none combinations). Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/hashtag-timeline.

Access: `write` · MCP tool: `mastodon-hashtag-timeline-unfavourite`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/hashtag-timeline/ITEM_ID/unfavourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Boost (Hashtag)

`POST /accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/boost`

Boost. Public posts with a hashtag (any/all/none combinations). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/hashtag-timeline.

Access: `write` · MCP tool: `mastodon-hashtag-timeline-boost`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `visibility` (string; one of public, unlisted, private)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/hashtag-timeline/ITEM_ID/boost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "visibility": "public"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Undo boost (Hashtag)

`POST /accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/unboost`

Undo boost. Public posts with a hashtag (any/all/none combinations). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/hashtag-timeline.

Access: `write` · MCP tool: `mastodon-hashtag-timeline-unboost`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/hashtag-timeline/ITEM_ID/unboost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Bookmark (Hashtag)

`POST /accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/bookmark`

Bookmark. Public posts with a hashtag (any/all/none combinations). Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/hashtag-timeline.

Access: `write` · MCP tool: `mastodon-hashtag-timeline-bookmark`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/hashtag-timeline/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Remove bookmark (Hashtag)

`POST /accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/unbookmark`

Remove bookmark. Public posts with a hashtag (any/all/none combinations). Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/hashtag-timeline.

Access: `write` · MCP tool: `mastodon-hashtag-timeline-unbookmark`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/hashtag-timeline/ITEM_ID/unbookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Reply (Hashtag)

`POST /accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/reply`

Reply. Public posts with a hashtag (any/all/none combinations). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/hashtag-timeline.

Access: `write` · MCP tool: `mastodon-hashtag-timeline-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `status` (string): Plain text; URLs count as 23 characters
- `visibility` (string; one of public, unlisted, private, direct)
- `spoiler_text` (string)
- `sensitive` (boolean)
- `language` (string): ISO 639-1
- `media` (array of string): Socialit media ids (uploaded to the instance on publish)
- `media_ids` (array of string): Already-uploaded Mastodon media ids
- `alt_texts` (array of string): Alt text per media item, by index
- `poll` (object)
  - `poll.options` (array of string; ≥ 2 items)
  - `poll.expires_in` (integer)
  - `poll.multiple` (boolean)
  - `poll.hide_totals` (boolean)
- `in_reply_to_id` (string)
- `quoted_status_id` (string): Mastodon 4.5+
- `quote_approval_policy` (string; one of public, followers, nobody)
- `scheduled_at` (string (date-time)): ≥ 5 minutes ahead → ScheduledStatus
- `thread` (array of string): Follow-up replies posted as a self-thread

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/hashtag-timeline/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Link

`GET /accounts/{accountId}/mastodon/link-timeline`

Posts sharing a trending link (4.3+). Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/link-timeline.

Access: `read` · MCP tool: `mastodon-link-timeline-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)
- `url` (string (uri); required)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/link-timeline?url=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "https://example.com",
      "url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "edited_at": "2026-10-13T09:00:00.000Z",
      "text": "string",
      "content": "string",
      "spoiler_text": "string",
      "sensitive": true,
      "visibility": "public",
      "language": "en",
      "in_reply_to_id": "string",
      "in_reply_to_account_id": "string",
      "replies_count": 1,
      "reblogs_count": 1,
      "favourites_count": 1,
      "quotes_count": 1,
      "author": "string",
      "author_name": "string",
      "media_attachments": [
        {
          "id": "string",
          "type": "image",
          "url": "https://example.com",
          "preview_url": "https://example.com",
          "remote_url": "https://example.com",
          "description": "string"
        }
      ],
      "poll": {
        "id": "string",
        "expires_at": "2026-10-13T09:00:00.000Z",
        "expired": true,
        "multiple": true,
        "votes_count": 1,
        "voters_count": 1
      },
      "favourited": true,
      "reblogged": true,
      "bookmarked": true,
      "muted": true,
      "pinned": true,
      "is_reblog": true,
      "quote": {
        "state": "string",
        "quoted_status": {}
      },
      "quote_approval": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Favourite (Link)

`POST /accounts/{accountId}/mastodon/link-timeline/{itemId}/favourite`

Favourite. Posts sharing a trending link (4.3+). Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/link-timeline.

Access: `write` · MCP tool: `mastodon-link-timeline-favourite`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/link-timeline/ITEM_ID/favourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unfavourite (Link)

`POST /accounts/{accountId}/mastodon/link-timeline/{itemId}/unfavourite`

Unfavourite. Posts sharing a trending link (4.3+). Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/link-timeline.

Access: `write` · MCP tool: `mastodon-link-timeline-unfavourite`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/link-timeline/ITEM_ID/unfavourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Boost (Link)

`POST /accounts/{accountId}/mastodon/link-timeline/{itemId}/boost`

Boost. Posts sharing a trending link (4.3+). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/link-timeline.

Access: `write` · MCP tool: `mastodon-link-timeline-boost`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `visibility` (string; one of public, unlisted, private)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/link-timeline/ITEM_ID/boost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "visibility": "public"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Undo boost (Link)

`POST /accounts/{accountId}/mastodon/link-timeline/{itemId}/unboost`

Undo boost. Posts sharing a trending link (4.3+). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/link-timeline.

Access: `write` · MCP tool: `mastodon-link-timeline-unboost`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/link-timeline/ITEM_ID/unboost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Bookmark (Link)

`POST /accounts/{accountId}/mastodon/link-timeline/{itemId}/bookmark`

Bookmark. Posts sharing a trending link (4.3+). Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/link-timeline.

Access: `write` · MCP tool: `mastodon-link-timeline-bookmark`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/link-timeline/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Remove bookmark (Link)

`POST /accounts/{accountId}/mastodon/link-timeline/{itemId}/unbookmark`

Remove bookmark. Posts sharing a trending link (4.3+). Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/link-timeline.

Access: `write` · MCP tool: `mastodon-link-timeline-unbookmark`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/link-timeline/ITEM_ID/unbookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Reply (Link)

`POST /accounts/{accountId}/mastodon/link-timeline/{itemId}/reply`

Reply. Posts sharing a trending link (4.3+). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/link-timeline.

Access: `write` · MCP tool: `mastodon-link-timeline-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `status` (string): Plain text; URLs count as 23 characters
- `visibility` (string; one of public, unlisted, private, direct)
- `spoiler_text` (string)
- `sensitive` (boolean)
- `language` (string): ISO 639-1
- `media` (array of string): Socialit media ids (uploaded to the instance on publish)
- `media_ids` (array of string): Already-uploaded Mastodon media ids
- `alt_texts` (array of string): Alt text per media item, by index
- `poll` (object)
  - `poll.options` (array of string; ≥ 2 items)
  - `poll.expires_in` (integer)
  - `poll.multiple` (boolean)
  - `poll.hide_totals` (boolean)
- `in_reply_to_id` (string)
- `quoted_status_id` (string): Mastodon 4.5+
- `quote_approval_policy` (string; one of public, followers, nobody)
- `scheduled_at` (string (date-time)): ≥ 5 minutes ahead → ScheduledStatus
- `thread` (array of string): Follow-up replies posted as a self-thread

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/link-timeline/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List List

`GET /accounts/{accountId}/mastodon/list-timeline`

Posts from the members of one of your lists. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:lists. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/list-timeline.

Access: `read` · MCP tool: `mastodon-list-timeline-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)
- `list_id` (string; required)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/list-timeline?list_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "https://example.com",
      "url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "edited_at": "2026-10-13T09:00:00.000Z",
      "text": "string",
      "content": "string",
      "spoiler_text": "string",
      "sensitive": true,
      "visibility": "public",
      "language": "en",
      "in_reply_to_id": "string",
      "in_reply_to_account_id": "string",
      "replies_count": 1,
      "reblogs_count": 1,
      "favourites_count": 1,
      "quotes_count": 1,
      "author": "string",
      "author_name": "string",
      "media_attachments": [
        {
          "id": "string",
          "type": "image",
          "url": "https://example.com",
          "preview_url": "https://example.com",
          "remote_url": "https://example.com",
          "description": "string"
        }
      ],
      "poll": {
        "id": "string",
        "expires_at": "2026-10-13T09:00:00.000Z",
        "expired": true,
        "multiple": true,
        "votes_count": 1,
        "voters_count": 1
      },
      "favourited": true,
      "reblogged": true,
      "bookmarked": true,
      "muted": true,
      "pinned": true,
      "is_reblog": true,
      "quote": {
        "state": "string",
        "quoted_status": {}
      },
      "quote_approval": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Favourite (List)

`POST /accounts/{accountId}/mastodon/list-timeline/{itemId}/favourite`

Favourite. Posts from the members of one of your lists. Requires scopes: read:lists, write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/list-timeline.

Access: `write` · MCP tool: `mastodon-list-timeline-favourite`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/list-timeline/ITEM_ID/favourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unfavourite (List)

`POST /accounts/{accountId}/mastodon/list-timeline/{itemId}/unfavourite`

Unfavourite. Posts from the members of one of your lists. Requires scopes: read:lists, write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/list-timeline.

Access: `write` · MCP tool: `mastodon-list-timeline-unfavourite`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/list-timeline/ITEM_ID/unfavourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Boost (List)

`POST /accounts/{accountId}/mastodon/list-timeline/{itemId}/boost`

Boost. Posts from the members of one of your lists. Requires scopes: read:lists, write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/list-timeline.

Access: `write` · MCP tool: `mastodon-list-timeline-boost`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `visibility` (string; one of public, unlisted, private)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/list-timeline/ITEM_ID/boost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "visibility": "public"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Undo boost (List)

`POST /accounts/{accountId}/mastodon/list-timeline/{itemId}/unboost`

Undo boost. Posts from the members of one of your lists. Requires scopes: read:lists, write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/list-timeline.

Access: `write` · MCP tool: `mastodon-list-timeline-unboost`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/list-timeline/ITEM_ID/unboost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Bookmark (List)

`POST /accounts/{accountId}/mastodon/list-timeline/{itemId}/bookmark`

Bookmark. Posts from the members of one of your lists. Requires scopes: read:lists, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/list-timeline.

Access: `write` · MCP tool: `mastodon-list-timeline-bookmark`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/list-timeline/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Remove bookmark (List)

`POST /accounts/{accountId}/mastodon/list-timeline/{itemId}/unbookmark`

Remove bookmark. Posts from the members of one of your lists. Requires scopes: read:lists, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/list-timeline.

Access: `write` · MCP tool: `mastodon-list-timeline-unbookmark`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/list-timeline/ITEM_ID/unbookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Reply (List)

`POST /accounts/{accountId}/mastodon/list-timeline/{itemId}/reply`

Reply. Posts from the members of one of your lists. Requires scopes: read:lists, write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/list-timeline.

Access: `write` · MCP tool: `mastodon-list-timeline-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `status` (string): Plain text; URLs count as 23 characters
- `visibility` (string; one of public, unlisted, private, direct)
- `spoiler_text` (string)
- `sensitive` (boolean)
- `language` (string): ISO 639-1
- `media` (array of string): Socialit media ids (uploaded to the instance on publish)
- `media_ids` (array of string): Already-uploaded Mastodon media ids
- `alt_texts` (array of string): Alt text per media item, by index
- `poll` (object)
  - `poll.options` (array of string; ≥ 2 items)
  - `poll.expires_in` (integer)
  - `poll.multiple` (boolean)
  - `poll.hide_totals` (boolean)
- `in_reply_to_id` (string)
- `quoted_status_id` (string): Mastodon 4.5+
- `quote_approval_policy` (string; one of public, followers, nobody)
- `scheduled_at` (string (date-time)): ≥ 5 minutes ahead → ScheduledStatus
- `thread` (array of string): Follow-up replies posted as a self-thread

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/list-timeline/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Trending hashtags

`GET /accounts/{accountId}/mastodon/trends-tags`

Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/trends/#tags Generic route: /v1/accounts/{accountId}/focus/trends-tags.

Access: `read` · MCP tool: `mastodon-trends-tags-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; ≤ 20)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/trends-tags" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "url": "https://example.com",
      "following": true,
      "featuring": true,
      "history": [
        {
          "day": "string",
          "uses": "string",
          "accounts": "string"
        }
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Follow hashtag (Trending hashtags)

`POST /accounts/{accountId}/mastodon/trends-tags/{itemId}/follow`

Follow hashtag. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/trends/#tags Generic route: /v1/accounts/{accountId}/focus/trends-tags.

Access: `write` · MCP tool: `mastodon-trends-tags-follow`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/trends-tags/ITEM_ID/follow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Trending posts

`GET /accounts/{accountId}/mastodon/trends-statuses`

Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: /v1/accounts/{accountId}/focus/trends-statuses.

Access: `read` · MCP tool: `mastodon-trends-statuses-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; ≤ 40)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/trends-statuses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "https://example.com",
      "url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "edited_at": "2026-10-13T09:00:00.000Z",
      "text": "string",
      "content": "string",
      "spoiler_text": "string",
      "sensitive": true,
      "visibility": "public",
      "language": "en",
      "in_reply_to_id": "string",
      "in_reply_to_account_id": "string",
      "replies_count": 1,
      "reblogs_count": 1,
      "favourites_count": 1,
      "quotes_count": 1,
      "author": "string",
      "author_name": "string",
      "media_attachments": [
        {
          "id": "string",
          "type": "image",
          "url": "https://example.com",
          "preview_url": "https://example.com",
          "remote_url": "https://example.com",
          "description": "string"
        }
      ],
      "poll": {
        "id": "string",
        "expires_at": "2026-10-13T09:00:00.000Z",
        "expired": true,
        "multiple": true,
        "votes_count": 1,
        "voters_count": 1
      },
      "favourited": true,
      "reblogged": true,
      "bookmarked": true,
      "muted": true,
      "pinned": true,
      "is_reblog": true,
      "quote": {
        "state": "string",
        "quoted_status": {}
      },
      "quote_approval": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Favourite (Trending posts)

`POST /accounts/{accountId}/mastodon/trends-statuses/{itemId}/favourite`

Favourite. Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: /v1/accounts/{accountId}/focus/trends-statuses.

Access: `write` · MCP tool: `mastodon-trends-statuses-favourite`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/trends-statuses/ITEM_ID/favourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unfavourite (Trending posts)

`POST /accounts/{accountId}/mastodon/trends-statuses/{itemId}/unfavourite`

Unfavourite. Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: /v1/accounts/{accountId}/focus/trends-statuses.

Access: `write` · MCP tool: `mastodon-trends-statuses-unfavourite`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/trends-statuses/ITEM_ID/unfavourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Boost (Trending posts)

`POST /accounts/{accountId}/mastodon/trends-statuses/{itemId}/boost`

Boost. Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: /v1/accounts/{accountId}/focus/trends-statuses.

Access: `write` · MCP tool: `mastodon-trends-statuses-boost`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `visibility` (string; one of public, unlisted, private)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/trends-statuses/ITEM_ID/boost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "visibility": "public"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Undo boost (Trending posts)

`POST /accounts/{accountId}/mastodon/trends-statuses/{itemId}/unboost`

Undo boost. Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: /v1/accounts/{accountId}/focus/trends-statuses.

Access: `write` · MCP tool: `mastodon-trends-statuses-unboost`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/trends-statuses/ITEM_ID/unboost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Bookmark (Trending posts)

`POST /accounts/{accountId}/mastodon/trends-statuses/{itemId}/bookmark`

Bookmark. Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: /v1/accounts/{accountId}/focus/trends-statuses.

Access: `write` · MCP tool: `mastodon-trends-statuses-bookmark`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/trends-statuses/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Remove bookmark (Trending posts)

`POST /accounts/{accountId}/mastodon/trends-statuses/{itemId}/unbookmark`

Remove bookmark. Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: /v1/accounts/{accountId}/focus/trends-statuses.

Access: `write` · MCP tool: `mastodon-trends-statuses-unbookmark`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/trends-statuses/ITEM_ID/unbookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Reply (Trending posts)

`POST /accounts/{accountId}/mastodon/trends-statuses/{itemId}/reply`

Reply. Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: /v1/accounts/{accountId}/focus/trends-statuses.

Access: `write` · MCP tool: `mastodon-trends-statuses-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `status` (string): Plain text; URLs count as 23 characters
- `visibility` (string; one of public, unlisted, private, direct)
- `spoiler_text` (string)
- `sensitive` (boolean)
- `language` (string): ISO 639-1
- `media` (array of string): Socialit media ids (uploaded to the instance on publish)
- `media_ids` (array of string): Already-uploaded Mastodon media ids
- `alt_texts` (array of string): Alt text per media item, by index
- `poll` (object)
  - `poll.options` (array of string; ≥ 2 items)
  - `poll.expires_in` (integer)
  - `poll.multiple` (boolean)
  - `poll.hide_totals` (boolean)
- `in_reply_to_id` (string)
- `quoted_status_id` (string): Mastodon 4.5+
- `quote_approval_policy` (string; one of public, followers, nobody)
- `scheduled_at` (string (date-time)): ≥ 5 minutes ahead → ScheduledStatus
- `thread` (array of string): Follow-up replies posted as a self-thread

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/trends-statuses/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Trending links

`GET /accounts/{accountId}/mastodon/trends-links`

Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/trends/#links Generic route: /v1/accounts/{accountId}/focus/trends-links.

Access: `read` · MCP tool: `mastodon-trends-links-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; ≤ 20)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/trends-links" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "url": "https://example.com",
      "title": "string",
      "description": "string",
      "type": "link",
      "provider_name": "string",
      "author_name": "string",
      "image": "https://example.com",
      "published_at": "2026-10-13T09:00:00.000Z",
      "history": [
        {
          "day": "string",
          "uses": "string",
          "accounts": "string"
        }
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: List Search

`GET /accounts/{accountId}/mastodon/search`

Search accounts, posts and hashtags. resolve=true imports a remote post or account by URL / handle. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:search. Network docs: https://docs.joinmastodon.org/methods/search/ Generic route: /v1/accounts/{accountId}/focus/search.

Access: `read` · MCP tool: `mastodon-search-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `q` (string; required)
- `type` (string; one of accounts, statuses, hashtags)
- `resolve` (boolean)
- `following` (boolean)
- `account_id` (string)
- `exclude_unreviewed` (boolean)
- `limit` (integer; ≤ 40)
- `cursor` (string): offset=

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/search?q=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "kind": "account",
      "title": "string",
      "url": "https://example.com",
      "account": {
        "id": "string",
        "acct": "string"
      },
      "status": {
        "id": "string"
      },
      "hashtag": {
        "id": "string",
        "name": "string",
        "url": "https://example.com",
        "following": true,
        "featuring": true,
        "history": [
          {
            "day": null,
            "uses": null,
            "accounts": null
          }
        ]
      }
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Get a Hashtags item

`GET /accounts/{accountId}/mastodon/tags/{itemId}`

Hashtag details; follow or feature it on your profile. Network docs: https://docs.joinmastodon.org/methods/tags/ Generic route: /v1/accounts/{accountId}/focus/tags.

Access: `read` · MCP tool: `mastodon-tags-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/tags/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "url": "https://example.com",
  "following": true,
  "featuring": true,
  "history": [
    {
      "day": "string",
      "uses": "string",
      "accounts": "string"
    }
  ]
}
```

## Mastodon: Follow (Hashtags)

`POST /accounts/{accountId}/mastodon/tags/{itemId}/follow`

Follow. Hashtag details; follow or feature it on your profile. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/tags/ Generic route: /v1/accounts/{accountId}/focus/tags.

Access: `write` · MCP tool: `mastodon-tags-follow`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/tags/ITEM_ID/follow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unfollow (Hashtags)

`POST /accounts/{accountId}/mastodon/tags/{itemId}/unfollow`

Unfollow. Hashtag details; follow or feature it on your profile. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/tags/ Generic route: /v1/accounts/{accountId}/focus/tags.

Access: `write` · MCP tool: `mastodon-tags-unfollow`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/tags/ITEM_ID/unfollow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Feature on profile (Hashtags)

`POST /accounts/{accountId}/mastodon/tags/{itemId}/feature`

Feature on profile. Hashtag details; follow or feature it on your profile. Requires scopes: write:accounts. Network docs: https://docs.joinmastodon.org/methods/tags/ Generic route: /v1/accounts/{accountId}/focus/tags.

Access: `write` · MCP tool: `mastodon-tags-feature`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/tags/ITEM_ID/feature" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unfeature (Hashtags)

`POST /accounts/{accountId}/mastodon/tags/{itemId}/unfeature`

Unfeature. Hashtag details; follow or feature it on your profile. Requires scopes: write:accounts. Network docs: https://docs.joinmastodon.org/methods/tags/ Generic route: /v1/accounts/{accountId}/focus/tags.

Access: `write` · MCP tool: `mastodon-tags-unfeature`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/tags/ITEM_ID/unfeature" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Blocked accounts

`GET /accounts/{accountId}/mastodon/blocks`

Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:blocks. Network docs: https://docs.joinmastodon.org/methods/blocks/ Generic route: /v1/accounts/{accountId}/focus/blocks.

Access: `read` · MCP tool: `mastodon-blocks-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "acct": "string",
      "username": "string",
      "display_name": "string",
      "url": "https://example.com",
      "avatar": "string",
      "header": "string",
      "note": "string",
      "note_text": "string",
      "locked": true,
      "bot": true,
      "group": true,
      "discoverable": true,
      "indexable": true,
      "followers_count": 1,
      "following_count": 1,
      "statuses_count": 1,
      "created_at": "2026-10-13T09:00:00.000Z",
      "last_status_at": "2026-10-13",
      "fields": [
        {
          "name": "string",
          "value": "string",
          "verified_at": "2026-10-13T09:00:00.000Z"
        }
      ],
      "moved": {},
      "suspended": true,
      "limited": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Create a Blocked accounts item

`POST /accounts/{accountId}/mastodon/blocks`

Requires scopes: read:blocks, write:blocks. Network docs: https://docs.joinmastodon.org/methods/blocks/ Generic route: /v1/accounts/{accountId}/focus/blocks.

Access: `write` · MCP tool: `mastodon-blocks-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `account_id` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "acct": "string",
  "username": "string",
  "display_name": "string",
  "url": "https://example.com",
  "avatar": "string",
  "header": "string",
  "note": "string",
  "note_text": "string",
  "locked": true,
  "bot": true,
  "group": true,
  "discoverable": true,
  "indexable": true,
  "followers_count": 1,
  "following_count": 1,
  "statuses_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "last_status_at": "2026-10-13",
  "fields": [
    {
      "name": "string",
      "value": "string",
      "verified_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "moved": {},
  "suspended": true,
  "limited": true
}
```

## Mastodon: Delete a Blocked accounts item

`DELETE /accounts/{accountId}/mastodon/blocks/{itemId}`

Unblock. Requires scopes: read:blocks, write:blocks. Network docs: https://docs.joinmastodon.org/methods/blocks/ Generic route: /v1/accounts/{accountId}/focus/blocks.

Access: `write` · MCP tool: `mastodon-blocks-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: List Muted accounts

`GET /accounts/{accountId}/mastodon/mutes`

Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:mutes. Network docs: https://docs.joinmastodon.org/methods/mutes/ Generic route: /v1/accounts/{accountId}/focus/mutes.

Access: `read` · MCP tool: `mastodon-mutes-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/mutes" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "acct": "string",
      "username": "string",
      "display_name": "string",
      "url": "https://example.com",
      "avatar": "string",
      "header": "string",
      "note": "string",
      "note_text": "string",
      "locked": true,
      "bot": true,
      "group": true,
      "discoverable": true,
      "indexable": true,
      "followers_count": 1,
      "following_count": 1,
      "statuses_count": 1,
      "created_at": "2026-10-13T09:00:00.000Z",
      "last_status_at": "2026-10-13",
      "fields": [
        {
          "name": "string",
          "value": "string",
          "verified_at": "2026-10-13T09:00:00.000Z"
        }
      ],
      "moved": {},
      "suspended": true,
      "limited": true,
      "mute_expires_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Create a Muted accounts item

`POST /accounts/{accountId}/mastodon/mutes`

Requires scopes: read:mutes, write:mutes. Network docs: https://docs.joinmastodon.org/methods/mutes/ Generic route: /v1/accounts/{accountId}/focus/mutes.

Access: `write` · MCP tool: `mastodon-mutes-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `account_id` (string; required)
- `notifications` (boolean)
- `duration` (integer): Seconds; 0 = indefinite

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/mutes" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "string",
    "notifications": true,
    "duration": 0
  }'
```

Response 201:

```json
{
  "id": "string",
  "acct": "string",
  "username": "string",
  "display_name": "string",
  "url": "https://example.com",
  "avatar": "string",
  "header": "string",
  "note": "string",
  "note_text": "string",
  "locked": true,
  "bot": true,
  "group": true,
  "discoverable": true,
  "indexable": true,
  "followers_count": 1,
  "following_count": 1,
  "statuses_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "last_status_at": "2026-10-13",
  "fields": [
    {
      "name": "string",
      "value": "string",
      "verified_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "moved": {},
  "suspended": true,
  "limited": true,
  "mute_expires_at": "2026-10-13T09:00:00.000Z"
}
```

## Mastodon: Delete a Muted accounts item

`DELETE /accounts/{accountId}/mastodon/mutes/{itemId}`

Unmute. Requires scopes: read:mutes, write:mutes. Network docs: https://docs.joinmastodon.org/methods/mutes/ Generic route: /v1/accounts/{accountId}/focus/mutes.

Access: `write` · MCP tool: `mastodon-mutes-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/mutes/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: List Blocked servers

`GET /accounts/{accountId}/mastodon/domain-blocks`

Hide everything from a domain and remove its followers. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:blocks. Network docs: https://docs.joinmastodon.org/methods/domain_blocks/ Generic route: /v1/accounts/{accountId}/focus/domain-blocks.

Access: `read` · MCP tool: `mastodon-domain-blocks-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/domain-blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "domain": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Create a Blocked servers item

`POST /accounts/{accountId}/mastodon/domain-blocks`

Hide everything from a domain and remove its followers. Requires scopes: read:blocks, write:blocks. Network docs: https://docs.joinmastodon.org/methods/domain_blocks/ Generic route: /v1/accounts/{accountId}/focus/domain-blocks.

Access: `write` · MCP tool: `mastodon-domain-blocks-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `domain` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/domain-blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "domain": "string"
}
```

## Mastodon: Delete a Blocked servers item

`DELETE /accounts/{accountId}/mastodon/domain-blocks/{itemId}`

Hide everything from a domain and remove its followers. Requires scopes: read:blocks, write:blocks. Network docs: https://docs.joinmastodon.org/methods/domain_blocks/ Generic route: /v1/accounts/{accountId}/focus/domain-blocks.

Access: `write` · MCP tool: `mastodon-domain-blocks-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/domain-blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: Create a Report item

`POST /accounts/{accountId}/mastodon/reports`

Report an account, posts or collections to moderators (400 / 24 h). Rule ids come from Server › Rules. Requires scopes: write:reports. Network docs: https://docs.joinmastodon.org/methods/reports/ Generic route: /v1/accounts/{accountId}/focus/reports.

Access: `write` · MCP tool: `mastodon-reports-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `account_id` (string; required)
- `status_ids` (array of string)
- `collection_ids` (array of string)
- `comment` (string)
- `forward` (boolean)
- `forward_to_domains` (array of string)
- `category` (string; one of spam, legal, violation, other)
- `rule_ids` (array of string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/reports" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "string",
    "status_ids": [
      "string"
    ],
    "collection_ids": [
      "string"
    ],
    "comment": "string",
    "forward": true
  }'
```

Response 201:

```json
{
  "id": "string",
  "account_id": "string",
  "status_ids": [
    "string"
  ],
  "collection_ids": [
    "string"
  ],
  "comment": "string",
  "forward": true,
  "forward_to_domains": [
    "string"
  ],
  "category": "spam",
  "rule_ids": [
    "string"
  ],
  "action_taken": true,
  "created_at": "2026-10-13T09:00:00.000Z"
}
```

## Mastodon: Get Profile

`GET /accounts/{accountId}/mastodon/profile`

Your public profile, posting defaults and the bot flag (many servers require it for automated accounts). Requires one of: profile | read:accounts. Network docs: https://docs.joinmastodon.org/methods/profile/ Generic route: /v1/accounts/{accountId}/focus/profile.

Access: `read` · MCP tool: `mastodon-profile-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "acct": "string",
  "username": "string",
  "display_name": "string",
  "url": "https://example.com",
  "avatar": "string",
  "header": "string",
  "note": "string",
  "note_text": "string",
  "locked": true,
  "bot": true,
  "group": true,
  "discoverable": true,
  "indexable": true,
  "followers_count": 1,
  "following_count": 1,
  "statuses_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "last_status_at": "2026-10-13",
  "fields": [
    {
      "name": "string",
      "value": "string",
      "verified_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "moved": {},
  "suspended": true,
  "limited": true,
  "avatar_description": "string",
  "header_description": "string",
  "hide_collections": true,
  "show_media": true,
  "show_media_replies": true,
  "show_featured": true,
  "attribution_domains": [
    "string"
  ],
  "source": {
    "privacy": "public",
    "sensitive": true,
    "language": "en",
    "note": "string",
    "fields": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "quote_policy": "public"
  }
}
```

## Mastodon: Update Profile

`PATCH /accounts/{accountId}/mastodon/profile`

PATCH /api/v1/profile (4.6+) or /api/v1/accounts/update_credentials. Your public profile, posting defaults and the bot flag (many servers require it for automated accounts). Requires scopes: write:accounts. Requires one of: profile | read:accounts. Network docs: https://docs.joinmastodon.org/methods/profile/ Generic route: /v1/accounts/{accountId}/focus/profile.

Access: `write` · MCP tool: `mastodon-profile-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `display_name` (string): configuration.accounts.max_display_name_length (40 on 4.6+)
- `note` (string): max_note_length (500)
- `avatar` (string): Image (Socialit media id)
- `avatar_description` (string)
- `header` (string)
- `header_description` (string)
- `locked` (boolean)
- `bot` (boolean)
- `discoverable` (boolean)
- `indexable` (boolean)
- `hide_collections` (boolean)
- `show_media` (boolean)
- `show_media_replies` (boolean)
- `show_featured` (boolean)
- `attribution_domains` (array of string; ≤ 10 items)
- `fields_attributes` (array of object; ≤ 4 items)
  - `fields_attributes[].name` (string)
  - `fields_attributes[].value` (string)
- `source` (object)
  - `source.privacy` (string; one of public, unlisted, private)
  - `source.sensitive` (boolean)
  - `source.language` (string)
  - `source.quote_policy` (string; one of public, followers, nobody)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name": "string",
    "note": "string",
    "avatar": "string",
    "avatar_description": "string",
    "header": "string"
  }'
```

Response 200:

```json
{
  "id": "string",
  "acct": "string",
  "username": "string",
  "display_name": "string",
  "url": "https://example.com",
  "avatar": "string",
  "header": "string",
  "note": "string",
  "note_text": "string",
  "locked": true,
  "bot": true,
  "group": true,
  "discoverable": true,
  "indexable": true,
  "followers_count": 1,
  "following_count": 1,
  "statuses_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "last_status_at": "2026-10-13",
  "fields": [
    {
      "name": "string",
      "value": "string",
      "verified_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "moved": {},
  "suspended": true,
  "limited": true,
  "avatar_description": "string",
  "header_description": "string",
  "hide_collections": true,
  "show_media": true,
  "show_media_replies": true,
  "show_featured": true,
  "attribution_domains": [
    "string"
  ],
  "source": {
    "privacy": "public",
    "sensitive": true,
    "language": "en",
    "note": "string",
    "fields": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "quote_policy": "public"
  }
}
```

## Mastodon: Remove avatar (Profile)

`POST /accounts/{accountId}/mastodon/profile/delete-avatar`

Remove avatar. Your public profile, posting defaults and the bot flag (many servers require it for automated accounts). Destructive. Requires scopes: write:accounts. Requires one of: profile | read:accounts. Network docs: https://docs.joinmastodon.org/methods/profile/ Generic route: /v1/accounts/{accountId}/focus/profile.

Access: `write` · MCP tool: `mastodon-profile-delete-avatar`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/profile/delete-avatar" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Remove header (Profile)

`POST /accounts/{accountId}/mastodon/profile/delete-header`

Remove header. Your public profile, posting defaults and the bot flag (many servers require it for automated accounts). Destructive. Requires scopes: write:accounts. Requires one of: profile | read:accounts. Network docs: https://docs.joinmastodon.org/methods/profile/ Generic route: /v1/accounts/{accountId}/focus/profile.

Access: `write` · MCP tool: `mastodon-profile-delete-header`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/profile/delete-header" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Get Preferences

`GET /accounts/{accountId}/mastodon/preferences`

Posting defaults (visibility, sensitivity, language, quote policy) and reading preferences. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/preferences/ Generic route: /v1/accounts/{accountId}/focus/preferences.

Access: `read` · MCP tool: `mastodon-preferences-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/preferences" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "posting:default:visibility": "public",
  "posting:default:sensitive": true,
  "posting:default:language": "string",
  "posting:default:quote_policy": "public",
  "reading:expand:media": "default",
  "reading:expand:spoilers": true
}
```

## Mastodon: List Year in review

`GET /accounts/{accountId}/mastodon/annual-reports`

Wrapstodon annual reports (available Dec 10–31 when the server enables them). Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/annual_reports/ Generic route: /v1/accounts/{accountId}/focus/annual-reports.

Access: `read` · MCP tool: `mastodon-annual-reports-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/annual-reports" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "year": 1,
      "schema_version": 1,
      "data": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Get a Year in review item

`GET /accounts/{accountId}/mastodon/annual-reports/{itemId}`

Wrapstodon annual reports (available Dec 10–31 when the server enables them). Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/annual_reports/ Generic route: /v1/accounts/{accountId}/focus/annual-reports.

Access: `read` · MCP tool: `mastodon-annual-reports-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/annual-reports/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "year": 1,
  "schema_version": 1,
  "data": {}
}
```

## Mastodon: Mark as read (Year in review)

`POST /accounts/{accountId}/mastodon/annual-reports/{itemId}/mark-read`

Mark as read. Wrapstodon annual reports (available Dec 10–31 when the server enables them). Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/annual_reports/ Generic route: /v1/accounts/{accountId}/focus/annual-reports.

Access: `write` · MCP tool: `mastodon-annual-reports-mark-read`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/annual-reports/ITEM_ID/mark-read" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Generate (Year in review)

`POST /accounts/{accountId}/mastodon/annual-reports/{itemId}/generate`

Generate. Wrapstodon annual reports (available Dec 10–31 when the server enables them). Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/annual_reports/ Generic route: /v1/accounts/{accountId}/focus/annual-reports.

Access: `write` · MCP tool: `mastodon-annual-reports-generate`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/annual-reports/ITEM_ID/generate" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Generation state (Year in review)

`POST /accounts/{accountId}/mastodon/annual-reports/{itemId}/state`

Generation state. Wrapstodon annual reports (available Dec 10–31 when the server enables them). Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/annual_reports/ Generic route: /v1/accounts/{accountId}/focus/annual-reports.

Access: `write` · MCP tool: `mastodon-annual-reports-state`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/annual-reports/ITEM_ID/state" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Get Push subscription

`GET /accounts/{accountId}/mastodon/push-subscription`

Web Push subscription of this token (one per token; creating replaces it). Socialit uses it as a webhook. Requires scopes: push. Network docs: https://docs.joinmastodon.org/methods/push/ Generic route: /v1/accounts/{accountId}/focus/push-subscription.

Access: `read` · MCP tool: `mastodon-push-subscription-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/push-subscription" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "endpoint": "https://example.com",
  "standard": true,
  "policy": "all",
  "server_key": "string",
  "alerts": {
    "mention": true,
    "status": true,
    "reblog": true,
    "follow": true,
    "follow_request": true,
    "favourite": true,
    "poll": true,
    "update": true,
    "quote": true,
    "quoted_update": true,
    "admin.sign_up": true,
    "admin.report": true
  }
}
```

## Mastodon: Create a Push subscription item

`POST /accounts/{accountId}/mastodon/push-subscription`

Web Push subscription of this token (one per token; creating replaces it). Socialit uses it as a webhook. Requires scopes: push. Network docs: https://docs.joinmastodon.org/methods/push/ Generic route: /v1/accounts/{accountId}/focus/push-subscription.

Access: `write` · MCP tool: `mastodon-push-subscription-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `endpoint` (string (uri); required)
- `keys` (object; required)
  - `keys.p256dh` (string; required)
  - `keys.auth` (string; required)
- `alerts` (object)
  - `alerts.mention` (boolean)
  - `alerts.status` (boolean)
  - `alerts.reblog` (boolean)
  - `alerts.follow` (boolean)
  - `alerts.follow_request` (boolean)
  - `alerts.favourite` (boolean)
  - `alerts.poll` (boolean)
  - `alerts.update` (boolean)
  - `alerts.quote` (boolean)
  - `alerts.quoted_update` (boolean)
  - `alerts.admin.sign_up` (boolean)
  - `alerts.admin.report` (boolean)
- `policy` (string; one of all, followed, follower, none)
- `standard` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/push-subscription" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "https://example.com",
    "keys": {
      "p256dh": "string",
      "auth": "string"
    },
    "alerts": {
      "mention": true,
      "status": true
    },
    "policy": "all",
    "standard": true
  }'
```

Response 201:

```json
{
  "id": "string",
  "endpoint": "https://example.com",
  "standard": true,
  "policy": "all",
  "server_key": "string",
  "alerts": {
    "mention": true,
    "status": true,
    "reblog": true,
    "follow": true,
    "follow_request": true,
    "favourite": true,
    "poll": true,
    "update": true,
    "quote": true,
    "quoted_update": true,
    "admin.sign_up": true,
    "admin.report": true
  }
}
```

## Mastodon: Update Push subscription

`PATCH /accounts/{accountId}/mastodon/push-subscription`

Web Push subscription of this token (one per token; creating replaces it). Socialit uses it as a webhook. Requires scopes: push. Network docs: https://docs.joinmastodon.org/methods/push/ Generic route: /v1/accounts/{accountId}/focus/push-subscription.

Access: `write` · MCP tool: `mastodon-push-subscription-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `alerts` (object)
  - `alerts.mention` (boolean)
  - `alerts.status` (boolean)
  - `alerts.reblog` (boolean)
  - `alerts.follow` (boolean)
  - `alerts.follow_request` (boolean)
  - `alerts.favourite` (boolean)
  - `alerts.poll` (boolean)
  - `alerts.update` (boolean)
  - `alerts.quote` (boolean)
  - `alerts.quoted_update` (boolean)
  - `alerts.admin.sign_up` (boolean)
  - `alerts.admin.report` (boolean)
- `policy` (string; one of all, followed, follower, none)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/push-subscription" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "alerts": {
      "mention": true,
      "status": true
    },
    "policy": "all"
  }'
```

Response 200:

```json
{
  "id": "string",
  "endpoint": "https://example.com",
  "standard": true,
  "policy": "all",
  "server_key": "string",
  "alerts": {
    "mention": true,
    "status": true,
    "reblog": true,
    "follow": true,
    "follow_request": true,
    "favourite": true,
    "poll": true,
    "update": true,
    "quote": true,
    "quoted_update": true,
    "admin.sign_up": true,
    "admin.report": true
  }
}
```

## Mastodon: Delete Push subscription

`DELETE /accounts/{accountId}/mastodon/push-subscription`

Web Push subscription of this token (one per token; creating replaces it). Socialit uses it as a webhook. Requires scopes: push. Network docs: https://docs.joinmastodon.org/methods/push/ Generic route: /v1/accounts/{accountId}/focus/push-subscription.

Access: `write` · MCP tool: `mastodon-push-subscription-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/push-subscription" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: Get Server

`GET /accounts/{accountId}/mastodon/instance`

Server info, limits (characters, media, polls), API level, registrations, contact. Network docs: https://docs.joinmastodon.org/methods/instance/#v2 Generic route: /v1/accounts/{accountId}/focus/instance.

Access: `read` · MCP tool: `mastodon-instance-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/instance" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "domain": "string",
  "title": "string",
  "version": "string",
  "description": "string",
  "source_url": "https://example.com",
  "languages": [
    "string"
  ],
  "api_versions": {
    "mastodon": 1
  },
  "limits": {},
  "configuration": {},
  "registrations": {
    "enabled": true,
    "approval_required": true,
    "message": "string"
  },
  "contact": {
    "email": "you@example.com",
    "account": {}
  }
}
```

## Mastodon: List Server rules

`GET /accounts/{accountId}/mastodon/instance-rules`

Rules every post must follow (check automation / bot rules). Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/instance/#rules Generic route: /v1/accounts/{accountId}/focus/instance-rules.

Access: `read` · MCP tool: `mastodon-instance-rules-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/instance-rules" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "hint": "string",
      "translations": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Get Terms of service

`GET /accounts/{accountId}/mastodon/terms-of-service`

Network docs: https://docs.joinmastodon.org/methods/instance/#terms_of_service Generic route: /v1/accounts/{accountId}/focus/terms-of-service.

Access: `read` · MCP tool: `mastodon-terms-of-service-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/terms-of-service" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "updated_at": "2026-10-13T09:00:00.000Z",
  "content": "string",
  "effective_date": "2026-10-13"
}
```

## Mastodon: Get Privacy policy

`GET /accounts/{accountId}/mastodon/privacy-policy`

Network docs: https://docs.joinmastodon.org/methods/instance/#privacy_policy Generic route: /v1/accounts/{accountId}/focus/privacy-policy.

Access: `read` · MCP tool: `mastodon-privacy-policy-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/privacy-policy" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "updated_at": "2026-10-13T09:00:00.000Z",
  "content": "string",
  "effective_date": "2026-10-13"
}
```

## Mastodon: Get About this server

`GET /accounts/{accountId}/mastodon/extended-description`

Network docs: https://docs.joinmastodon.org/methods/instance/#extended_description Generic route: /v1/accounts/{accountId}/focus/extended-description.

Access: `read` · MCP tool: `mastodon-extended-description-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/extended-description" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "updated_at": "2026-10-13T09:00:00.000Z",
  "content": "string",
  "effective_date": "2026-10-13"
}
```

## Mastodon: List Known servers

`GET /accounts/{accountId}/mastodon/instance-peers`

Domains this server has federated with (admins may disable it). Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/instance/#peers Generic route: /v1/accounts/{accountId}/focus/instance-peers.

Access: `read` · MCP tool: `mastodon-instance-peers-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/instance-peers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "domain": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: List Server activity

`GET /accounts/{accountId}/mastodon/instance-activity`

Weekly posts, logins and registrations (last 12 weeks). Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/instance/#activity Generic route: /v1/accounts/{accountId}/focus/instance-activity.

Access: `read` · MCP tool: `mastodon-instance-activity-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/instance-activity" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "week": "2026-10-13",
      "statuses": 1,
      "logins": 1,
      "registrations": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: List Moderated servers

`GET /accounts/{accountId}/mastodon/instance-domain-blocks`

Servers this instance limits or suspends (when published by the admins). Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/instance/#domain_blocks Generic route: /v1/accounts/{accountId}/focus/instance-domain-blocks.

Access: `read` · MCP tool: `mastodon-instance-domain-blocks-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/instance-domain-blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "domain": "string",
      "digest": "string",
      "severity": "silence",
      "comment": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: List Translation languages

`GET /accounts/{accountId}/mastodon/translation-languages`

Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/instance/#translation_languages Generic route: /v1/accounts/{accountId}/focus/translation-languages.

Access: `read` · MCP tool: `mastodon-translation-languages-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/translation-languages" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "source": "string",
      "targets": [
        "string"
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: List Custom emoji

`GET /accounts/{accountId}/mastodon/custom-emojis`

Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/custom_emojis/ Generic route: /v1/accounts/{accountId}/focus/custom-emojis.

Access: `read` · MCP tool: `mastodon-custom-emojis-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/custom-emojis" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "shortcode": "string",
      "url": "https://example.com",
      "static_url": "https://example.com",
      "visible_in_picker": true,
      "category": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: List Announcements

`GET /accounts/{accountId}/mastodon/announcements`

Server announcements; dismiss or react. Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/announcements/ Generic route: /v1/accounts/{accountId}/focus/announcements.

Access: `read` · MCP tool: `mastodon-announcements-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `with_dismissed` (boolean)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/announcements" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "content": "string",
      "starts_at": "2026-10-13T09:00:00.000Z",
      "ends_at": "2026-10-13T09:00:00.000Z",
      "published_at": "2026-10-13T09:00:00.000Z",
      "read": true,
      "reactions": [
        {
          "name": "string",
          "count": 1,
          "me": true
        }
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Dismiss (Announcements)

`POST /accounts/{accountId}/mastodon/announcements/{itemId}/dismiss`

Dismiss. Server announcements; dismiss or react. Requires scopes: write:accounts. Network docs: https://docs.joinmastodon.org/methods/announcements/ Generic route: /v1/accounts/{accountId}/focus/announcements.

Access: `write` · MCP tool: `mastodon-announcements-dismiss`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/announcements/ITEM_ID/dismiss" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: React (Announcements)

`POST /accounts/{accountId}/mastodon/announcements/{itemId}/react`

React. Server announcements; dismiss or react. Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/announcements/ Generic route: /v1/accounts/{accountId}/focus/announcements.

Access: `write` · MCP tool: `mastodon-announcements-react`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `name` (string; required): Unicode emoji or custom shortcode

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/announcements/ITEM_ID/react" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Remove reaction (Announcements)

`POST /accounts/{accountId}/mastodon/announcements/{itemId}/unreact`

Remove reaction. Server announcements; dismiss or react. Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/announcements/ Generic route: /v1/accounts/{accountId}/focus/announcements.

Access: `write` · MCP tool: `mastodon-announcements-unreact`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `name` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/announcements/ITEM_ID/unreact" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Account overview

`GET /accounts/{accountId}/mastodon/account-overview`

Daily engagement on posts created in the window (favourites, replies, boosts, quotes) plus current followers. Mastodon keeps no history, so engagement is attributed to the post’s creation day. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:accounts, read:statuses. Network docs: https://docs.joinmastodon.org/methods/accounts/#statuses Generic route: /v1/accounts/{accountId}/focus/account-overview.

Access: `read` · MCP tool: `mastodon-account-overview-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): Default: 30 days ago
- `until` (string (date)): Default: today

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/account-overview" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "date": "2026-10-13",
      "posts": 1,
      "likes": 1,
      "comments": 1,
      "shares": 1,
      "quotes": 1,
      "engagements": 1,
      "followers": 1,
      "following": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: List Post performance

`GET /accounts/{accountId}/mastodon/post-performance`

Your posts in the window ranked by engagements (favourites + replies + boosts + quotes). Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:accounts, read:statuses. Network docs: https://docs.joinmastodon.org/methods/accounts/#statuses Generic route: /v1/accounts/{accountId}/focus/post-performance.

Access: `read` · MCP tool: `mastodon-post-performance-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): Default: 30 days ago
- `until` (string (date)): Default: today
- `limit` (integer; ≤ 200)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/post-performance" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "text": "string",
      "likes": 1,
      "comments": 1,
      "shares": 1,
      "quotes": 1,
      "engagements": 1,
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: List Accounts

`GET /accounts/{accountId}/mastodon/admin-accounts`

GET /api/v2/admin/accounts. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Cursor pagination: pass next_cursor back as cursor. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: /v1/accounts/{accountId}/focus/admin-accounts.

Access: `read` · MCP tool: `mastodon-admin-accounts-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)
- `origin` (string; one of local, remote)
- `status` (string; one of active, pending, disabled, silenced, suspended)
- `permissions` (string; one of staff)
- `role_ids` (array of string)
- `invited_by` (string)
- `username` (string)
- `display_name` (string)
- `by_domain` (string)
- `email` (string)
- `ip` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-accounts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "username": "string",
      "domain": "string",
      "acct": "string",
      "display_name": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "email": "you@example.com",
      "ip": "string",
      "locale": "en",
      "role": {
        "id": "string",
        "name": "string",
        "permissions": "string"
      },
      "confirmed": true,
      "approved": true,
      "disabled": true,
      "silenced": true,
      "suspended": true,
      "sensitized": true,
      "invite_request": "string",
      "account": {
        "id": "string",
        "acct": "string"
      }
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Get a Accounts item

`GET /accounts/{accountId}/mastodon/admin-accounts/{itemId}`

Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: /v1/accounts/{accountId}/focus/admin-accounts.

Access: `read` · MCP tool: `mastodon-admin-accounts-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-accounts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "username": "string",
  "domain": "string",
  "acct": "string",
  "display_name": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "email": "you@example.com",
  "ip": "string",
  "locale": "en",
  "role": {
    "id": "string",
    "name": "string",
    "permissions": "string"
  },
  "confirmed": true,
  "approved": true,
  "disabled": true,
  "silenced": true,
  "suspended": true,
  "sensitized": true,
  "invite_request": "string",
  "account": {
    "id": "string",
    "acct": "string",
    "username": "string",
    "display_name": "string",
    "url": "https://example.com",
    "avatar": "string",
    "header": "string",
    "note": "string",
    "note_text": "string",
    "locked": true,
    "bot": true,
    "group": true,
    "discoverable": true,
    "indexable": true,
    "followers_count": 1,
    "following_count": 1,
    "statuses_count": 1,
    "created_at": "2026-10-13T09:00:00.000Z",
    "last_status_at": "2026-10-13",
    "fields": [
      {
        "name": "string",
        "value": "string",
        "verified_at": "2026-10-13T09:00:00.000Z"
      }
    ],
    "moved": {},
    "suspended": true,
    "limited": true
  }
}
```

## Mastodon: Delete a Accounts item

`DELETE /accounts/{accountId}/mastodon/admin-accounts/{itemId}`

Delete the data of a suspended account. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Requires scopes: admin:write:accounts. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: /v1/accounts/{accountId}/focus/admin-accounts.

Access: `write` · MCP tool: `mastodon-admin-accounts-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-accounts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: Approve sign-up (Accounts)

`POST /accounts/{accountId}/mastodon/admin-accounts/{itemId}/approve`

Approve sign-up. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Requires scopes: admin:write:accounts. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: /v1/accounts/{accountId}/focus/admin-accounts.

Access: `write` · MCP tool: `mastodon-admin-accounts-approve`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-accounts/ITEM_ID/approve" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Reject sign-up (Accounts)

`POST /accounts/{accountId}/mastodon/admin-accounts/{itemId}/reject`

Reject sign-up. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Destructive. Requires scopes: admin:write:accounts. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: /v1/accounts/{accountId}/focus/admin-accounts.

Access: `write` · MCP tool: `mastodon-admin-accounts-reject`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-accounts/ITEM_ID/reject" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Moderate (Accounts)

`POST /accounts/{accountId}/mastodon/admin-accounts/{itemId}/action`

Moderate. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Destructive. Requires scopes: admin:write:accounts. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: /v1/accounts/{accountId}/focus/admin-accounts.

Access: `write` · MCP tool: `mastodon-admin-accounts-action`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `type` (string; required; one of none, sensitive, disable, silence, suspend)
- `report_id` (string)
- `warning_preset_id` (string)
- `text` (string)
- `send_email_notification` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-accounts/ITEM_ID/action" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "none",
    "report_id": "string",
    "warning_preset_id": "string",
    "text": "string",
    "send_email_notification": true
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Re-enable login (Accounts)

`POST /accounts/{accountId}/mastodon/admin-accounts/{itemId}/enable`

Re-enable login. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Requires scopes: admin:write:accounts. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: /v1/accounts/{accountId}/focus/admin-accounts.

Access: `write` · MCP tool: `mastodon-admin-accounts-enable`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-accounts/ITEM_ID/enable" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unlimit (Accounts)

`POST /accounts/{accountId}/mastodon/admin-accounts/{itemId}/unsilence`

Unlimit. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Requires scopes: admin:write:accounts. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: /v1/accounts/{accountId}/focus/admin-accounts.

Access: `write` · MCP tool: `mastodon-admin-accounts-unsilence`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-accounts/ITEM_ID/unsilence" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unsuspend (Accounts)

`POST /accounts/{accountId}/mastodon/admin-accounts/{itemId}/unsuspend`

Unsuspend. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Requires scopes: admin:write:accounts. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: /v1/accounts/{accountId}/focus/admin-accounts.

Access: `write` · MCP tool: `mastodon-admin-accounts-unsuspend`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-accounts/ITEM_ID/unsuspend" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unmark sensitive (Accounts)

`POST /accounts/{accountId}/mastodon/admin-accounts/{itemId}/unsensitive`

Unmark sensitive. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Requires scopes: admin:write:accounts. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: /v1/accounts/{accountId}/focus/admin-accounts.

Access: `write` · MCP tool: `mastodon-admin-accounts-unsensitive`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-accounts/ITEM_ID/unsensitive" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Reports

`GET /accounts/{accountId}/mastodon/admin-reports`

Moderation reports: assign, resolve, reopen, recategorize. Cursor pagination: pass next_cursor back as cursor. Requires one of: admin:read | admin:read:reports. Network docs: https://docs.joinmastodon.org/methods/admin/reports/ Generic route: /v1/accounts/{accountId}/focus/admin-reports.

Access: `read` · MCP tool: `mastodon-admin-reports-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)
- `resolved` (boolean)
- `account_id` (string)
- `target_account_id` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-reports" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z",
      "category": "spam",
      "comment": "string",
      "forwarded": true,
      "action_taken": true,
      "action_taken_at": "2026-10-13T09:00:00.000Z",
      "reporter": "string",
      "target": "string",
      "assigned_to": "+15551234567",
      "rules": [
        {
          "id": "string",
          "text": "string"
        }
      ],
      "statuses": [
        {
          "id": "string"
        }
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Get a Reports item

`GET /accounts/{accountId}/mastodon/admin-reports/{itemId}`

Moderation reports: assign, resolve, reopen, recategorize. Requires one of: admin:read | admin:read:reports. Network docs: https://docs.joinmastodon.org/methods/admin/reports/ Generic route: /v1/accounts/{accountId}/focus/admin-reports.

Access: `read` · MCP tool: `mastodon-admin-reports-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-reports/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "category": "spam",
  "comment": "string",
  "forwarded": true,
  "action_taken": true,
  "action_taken_at": "2026-10-13T09:00:00.000Z",
  "reporter": "string",
  "target": "string",
  "assigned_to": "+15551234567",
  "rules": [
    {
      "id": "string",
      "text": "string"
    }
  ],
  "statuses": [
    {
      "id": "string",
      "uri": "https://example.com",
      "url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "edited_at": "2026-10-13T09:00:00.000Z",
      "text": "string",
      "content": "string",
      "spoiler_text": "string",
      "sensitive": true,
      "visibility": "public",
      "language": "en",
      "in_reply_to_id": "string",
      "in_reply_to_account_id": "string",
      "replies_count": 1,
      "reblogs_count": 1,
      "favourites_count": 1,
      "quotes_count": 1,
      "author": "string",
      "author_name": "string",
      "media_attachments": [
        {
          "id": "string",
          "type": "image",
          "url": "https://example.com",
          "preview_url": "https://example.com",
          "remote_url": "https://example.com",
          "description": "string"
        }
      ],
      "poll": {
        "id": "string",
        "expires_at": "2026-10-13T09:00:00.000Z",
        "expired": true,
        "multiple": true,
        "votes_count": 1,
        "voters_count": 1
      },
      "favourited": true,
      "reblogged": true,
      "bookmarked": true,
      "muted": true,
      "pinned": true,
      "is_reblog": true,
      "quote": {
        "state": "string",
        "quoted_status": {}
      },
      "quote_approval": {}
    }
  ]
}
```

## Mastodon: Update a Reports item

`PATCH /accounts/{accountId}/mastodon/admin-reports/{itemId}`

Moderation reports: assign, resolve, reopen, recategorize. Requires scopes: admin:write:reports. Requires one of: admin:read | admin:read:reports. Network docs: https://docs.joinmastodon.org/methods/admin/reports/ Generic route: /v1/accounts/{accountId}/focus/admin-reports.

Access: `write` · MCP tool: `mastodon-admin-reports-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `category` (string; one of spam, legal, violation, other)
- `rule_ids` (array of string)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-reports/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "spam",
    "rule_ids": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "id": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "category": "spam",
  "comment": "string",
  "forwarded": true,
  "action_taken": true,
  "action_taken_at": "2026-10-13T09:00:00.000Z",
  "reporter": "string",
  "target": "string",
  "assigned_to": "+15551234567",
  "rules": [
    {
      "id": "string",
      "text": "string"
    }
  ],
  "statuses": [
    {
      "id": "string",
      "uri": "https://example.com",
      "url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "edited_at": "2026-10-13T09:00:00.000Z",
      "text": "string",
      "content": "string",
      "spoiler_text": "string",
      "sensitive": true,
      "visibility": "public",
      "language": "en",
      "in_reply_to_id": "string",
      "in_reply_to_account_id": "string",
      "replies_count": 1,
      "reblogs_count": 1,
      "favourites_count": 1,
      "quotes_count": 1,
      "author": "string",
      "author_name": "string",
      "media_attachments": [
        {
          "id": "string",
          "type": "image",
          "url": "https://example.com",
          "preview_url": "https://example.com",
          "remote_url": "https://example.com",
          "description": "string"
        }
      ],
      "poll": {
        "id": "string",
        "expires_at": "2026-10-13T09:00:00.000Z",
        "expired": true,
        "multiple": true,
        "votes_count": 1,
        "voters_count": 1
      },
      "favourited": true,
      "reblogged": true,
      "bookmarked": true,
      "muted": true,
      "pinned": true,
      "is_reblog": true,
      "quote": {
        "state": "string",
        "quoted_status": {}
      },
      "quote_approval": {}
    }
  ]
}
```

## Mastodon: Assign to me (Reports)

`POST /accounts/{accountId}/mastodon/admin-reports/{itemId}/assign`

Assign to me. Moderation reports: assign, resolve, reopen, recategorize. Requires scopes: admin:write:reports. Requires one of: admin:read | admin:read:reports. Network docs: https://docs.joinmastodon.org/methods/admin/reports/ Generic route: /v1/accounts/{accountId}/focus/admin-reports.

Access: `write` · MCP tool: `mastodon-admin-reports-assign`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-reports/ITEM_ID/assign" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Unassign (Reports)

`POST /accounts/{accountId}/mastodon/admin-reports/{itemId}/unassign`

Unassign. Moderation reports: assign, resolve, reopen, recategorize. Requires scopes: admin:write:reports. Requires one of: admin:read | admin:read:reports. Network docs: https://docs.joinmastodon.org/methods/admin/reports/ Generic route: /v1/accounts/{accountId}/focus/admin-reports.

Access: `write` · MCP tool: `mastodon-admin-reports-unassign`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-reports/ITEM_ID/unassign" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Resolve (Reports)

`POST /accounts/{accountId}/mastodon/admin-reports/{itemId}/resolve`

Resolve. Moderation reports: assign, resolve, reopen, recategorize. Requires scopes: admin:write:reports. Requires one of: admin:read | admin:read:reports. Network docs: https://docs.joinmastodon.org/methods/admin/reports/ Generic route: /v1/accounts/{accountId}/focus/admin-reports.

Access: `write` · MCP tool: `mastodon-admin-reports-resolve`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-reports/ITEM_ID/resolve" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Reopen (Reports)

`POST /accounts/{accountId}/mastodon/admin-reports/{itemId}/reopen`

Reopen. Moderation reports: assign, resolve, reopen, recategorize. Requires scopes: admin:write:reports. Requires one of: admin:read | admin:read:reports. Network docs: https://docs.joinmastodon.org/methods/admin/reports/ Generic route: /v1/accounts/{accountId}/focus/admin-reports.

Access: `write` · MCP tool: `mastodon-admin-reports-reopen`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-reports/ITEM_ID/reopen" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Domain blocks

`GET /accounts/{accountId}/mastodon/admin-domain-blocks`

Limit or suspend remote servers (4.0+). Cursor pagination: pass next_cursor back as cursor. Requires one of: admin:read | admin:read:domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/domain_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-domain-blocks.

Access: `read` · MCP tool: `mastodon-admin-domain-blocks-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-domain-blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "digest": "string",
      "domain": "string",
      "severity": "silence",
      "reject_media": true,
      "reject_reports": true,
      "private_comment": "string",
      "public_comment": "string",
      "obfuscate": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Create a Domain blocks item

`POST /accounts/{accountId}/mastodon/admin-domain-blocks`

Limit or suspend remote servers (4.0+). Requires scopes: admin:write:domain_blocks. Requires one of: admin:read | admin:read:domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/domain_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-domain-blocks.

Access: `write` · MCP tool: `mastodon-admin-domain-blocks-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `domain` (string; required)
- `severity` (string; one of silence, suspend, noop)
- `reject_media` (boolean)
- `reject_reports` (boolean)
- `private_comment` (string)
- `public_comment` (string)
- `obfuscate` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-domain-blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "string",
    "severity": "silence",
    "reject_media": true,
    "reject_reports": true,
    "private_comment": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "digest": "string",
  "domain": "string",
  "severity": "silence",
  "reject_media": true,
  "reject_reports": true,
  "private_comment": "string",
  "public_comment": "string",
  "obfuscate": true
}
```

## Mastodon: Get a Domain blocks item

`GET /accounts/{accountId}/mastodon/admin-domain-blocks/{itemId}`

Limit or suspend remote servers (4.0+). Requires one of: admin:read | admin:read:domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/domain_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-domain-blocks.

Access: `read` · MCP tool: `mastodon-admin-domain-blocks-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-domain-blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "digest": "string",
  "domain": "string",
  "severity": "silence",
  "reject_media": true,
  "reject_reports": true,
  "private_comment": "string",
  "public_comment": "string",
  "obfuscate": true
}
```

## Mastodon: Update a Domain blocks item

`PATCH /accounts/{accountId}/mastodon/admin-domain-blocks/{itemId}`

Limit or suspend remote servers (4.0+). Requires scopes: admin:write:domain_blocks. Requires one of: admin:read | admin:read:domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/domain_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-domain-blocks.

Access: `write` · MCP tool: `mastodon-admin-domain-blocks-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `domain` (string)
- `severity` (string; one of silence, suspend, noop)
- `reject_media` (boolean)
- `reject_reports` (boolean)
- `private_comment` (string)
- `public_comment` (string)
- `obfuscate` (boolean)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-domain-blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "string",
    "severity": "silence",
    "reject_media": true,
    "reject_reports": true,
    "private_comment": "string"
  }'
```

Response 200:

```json
{
  "id": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "digest": "string",
  "domain": "string",
  "severity": "silence",
  "reject_media": true,
  "reject_reports": true,
  "private_comment": "string",
  "public_comment": "string",
  "obfuscate": true
}
```

## Mastodon: Delete a Domain blocks item

`DELETE /accounts/{accountId}/mastodon/admin-domain-blocks/{itemId}`

Limit or suspend remote servers (4.0+). Requires scopes: admin:write:domain_blocks. Requires one of: admin:read | admin:read:domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/domain_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-domain-blocks.

Access: `write` · MCP tool: `mastodon-admin-domain-blocks-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-domain-blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: List Domain allows

`GET /accounts/{accountId}/mastodon/admin-domain-allows`

Allowed servers in limited-federation mode. Cursor pagination: pass next_cursor back as cursor. Requires one of: admin:read | admin:read:domain_allows. Network docs: https://docs.joinmastodon.org/methods/admin/domain_allows/ Generic route: /v1/accounts/{accountId}/focus/admin-domain-allows.

Access: `read` · MCP tool: `mastodon-admin-domain-allows-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-domain-allows" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "domain": "string",
      "created_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Create a Domain allows item

`POST /accounts/{accountId}/mastodon/admin-domain-allows`

Allowed servers in limited-federation mode. Requires scopes: admin:write:domain_allows. Requires one of: admin:read | admin:read:domain_allows. Network docs: https://docs.joinmastodon.org/methods/admin/domain_allows/ Generic route: /v1/accounts/{accountId}/focus/admin-domain-allows.

Access: `write` · MCP tool: `mastodon-admin-domain-allows-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `domain` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-domain-allows" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "domain": "string",
  "created_at": "2026-10-13T09:00:00.000Z"
}
```

## Mastodon: Get a Domain allows item

`GET /accounts/{accountId}/mastodon/admin-domain-allows/{itemId}`

Allowed servers in limited-federation mode. Requires one of: admin:read | admin:read:domain_allows. Network docs: https://docs.joinmastodon.org/methods/admin/domain_allows/ Generic route: /v1/accounts/{accountId}/focus/admin-domain-allows.

Access: `read` · MCP tool: `mastodon-admin-domain-allows-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-domain-allows/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "domain": "string",
  "created_at": "2026-10-13T09:00:00.000Z"
}
```

## Mastodon: Delete a Domain allows item

`DELETE /accounts/{accountId}/mastodon/admin-domain-allows/{itemId}`

Allowed servers in limited-federation mode. Requires scopes: admin:write:domain_allows. Requires one of: admin:read | admin:read:domain_allows. Network docs: https://docs.joinmastodon.org/methods/admin/domain_allows/ Generic route: /v1/accounts/{accountId}/focus/admin-domain-allows.

Access: `write` · MCP tool: `mastodon-admin-domain-allows-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-domain-allows/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: List IP blocks

`GET /accounts/{accountId}/mastodon/admin-ip-blocks`

Cursor pagination: pass next_cursor back as cursor. Requires one of: admin:read | admin:read:ip_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/ip_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-ip-blocks.

Access: `read` · MCP tool: `mastodon-admin-ip-blocks-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-ip-blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "expires_at": "2026-10-13T09:00:00.000Z",
      "ip": "string",
      "severity": "sign_up_requires_approval",
      "comment": "string",
      "expires_in": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Create a IP blocks item

`POST /accounts/{accountId}/mastodon/admin-ip-blocks`

Requires scopes: admin:write:ip_blocks. Requires one of: admin:read | admin:read:ip_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/ip_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-ip-blocks.

Access: `write` · MCP tool: `mastodon-admin-ip-blocks-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `ip` (string; required): IP or CIDR range
- `severity` (string; required; one of sign_up_requires_approval, sign_up_block, no_access)
- `comment` (string)
- `expires_in` (integer): Seconds

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-ip-blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ip": "string",
    "severity": "sign_up_requires_approval",
    "comment": "string",
    "expires_in": 1
  }'
```

Response 201:

```json
{
  "id": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "expires_at": "2026-10-13T09:00:00.000Z",
  "ip": "string",
  "severity": "sign_up_requires_approval",
  "comment": "string",
  "expires_in": 1
}
```

## Mastodon: Get a IP blocks item

`GET /accounts/{accountId}/mastodon/admin-ip-blocks/{itemId}`

Requires one of: admin:read | admin:read:ip_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/ip_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-ip-blocks.

Access: `read` · MCP tool: `mastodon-admin-ip-blocks-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-ip-blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "expires_at": "2026-10-13T09:00:00.000Z",
  "ip": "string",
  "severity": "sign_up_requires_approval",
  "comment": "string",
  "expires_in": 1
}
```

## Mastodon: Update a IP blocks item

`PATCH /accounts/{accountId}/mastodon/admin-ip-blocks/{itemId}`

Requires scopes: admin:write:ip_blocks. Requires one of: admin:read | admin:read:ip_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/ip_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-ip-blocks.

Access: `write` · MCP tool: `mastodon-admin-ip-blocks-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `ip` (string): IP or CIDR range
- `severity` (string; one of sign_up_requires_approval, sign_up_block, no_access)
- `comment` (string)
- `expires_in` (integer): Seconds

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-ip-blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ip": "string",
    "severity": "sign_up_requires_approval",
    "comment": "string",
    "expires_in": 1
  }'
```

Response 200:

```json
{
  "id": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "expires_at": "2026-10-13T09:00:00.000Z",
  "ip": "string",
  "severity": "sign_up_requires_approval",
  "comment": "string",
  "expires_in": 1
}
```

## Mastodon: Delete a IP blocks item

`DELETE /accounts/{accountId}/mastodon/admin-ip-blocks/{itemId}`

Requires scopes: admin:write:ip_blocks. Requires one of: admin:read | admin:read:ip_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/ip_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-ip-blocks.

Access: `write` · MCP tool: `mastodon-admin-ip-blocks-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-ip-blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: List Email domain blocks

`GET /accounts/{accountId}/mastodon/admin-email-domain-blocks`

Cursor pagination: pass next_cursor back as cursor. Requires one of: admin:read | admin:read:email_domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/email_domain_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-email-domain-blocks.

Access: `read` · MCP tool: `mastodon-admin-email-domain-blocks-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-email-domain-blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "domain": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "history": [
        {
          "day": "string",
          "accounts": "string",
          "uses": "string"
        }
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Create a Email domain blocks item

`POST /accounts/{accountId}/mastodon/admin-email-domain-blocks`

Requires scopes: admin:write:email_domain_blocks. Requires one of: admin:read | admin:read:email_domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/email_domain_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-email-domain-blocks.

Access: `write` · MCP tool: `mastodon-admin-email-domain-blocks-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `domain` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-email-domain-blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "domain": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "history": [
    {
      "day": "string",
      "accounts": "string",
      "uses": "string"
    }
  ]
}
```

## Mastodon: Get a Email domain blocks item

`GET /accounts/{accountId}/mastodon/admin-email-domain-blocks/{itemId}`

Requires one of: admin:read | admin:read:email_domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/email_domain_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-email-domain-blocks.

Access: `read` · MCP tool: `mastodon-admin-email-domain-blocks-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-email-domain-blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "domain": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "history": [
    {
      "day": "string",
      "accounts": "string",
      "uses": "string"
    }
  ]
}
```

## Mastodon: Delete a Email domain blocks item

`DELETE /accounts/{accountId}/mastodon/admin-email-domain-blocks/{itemId}`

Requires scopes: admin:write:email_domain_blocks. Requires one of: admin:read | admin:read:email_domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/email_domain_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-email-domain-blocks.

Access: `write` · MCP tool: `mastodon-admin-email-domain-blocks-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-email-domain-blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: List Email blocks

`GET /accounts/{accountId}/mastodon/admin-canonical-email-blocks`

Block specific (canonicalized) email addresses. Cursor pagination: pass next_cursor back as cursor. Requires one of: admin:read | admin:read:canonical_email_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/canonical_email_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-canonical-email-blocks.

Access: `read` · MCP tool: `mastodon-admin-canonical-email-blocks-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from a previous next_cursor
- `limit` (integer; 1–80)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-canonical-email-blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "canonical_email_hash": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Create a Email blocks item

`POST /accounts/{accountId}/mastodon/admin-canonical-email-blocks`

Block specific (canonicalized) email addresses. Requires scopes: admin:write:canonical_email_blocks. Requires one of: admin:read | admin:read:canonical_email_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/canonical_email_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-canonical-email-blocks.

Access: `write` · MCP tool: `mastodon-admin-canonical-email-blocks-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `email` (string (email))
- `canonical_email_hash` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-canonical-email-blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "canonical_email_hash": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "canonical_email_hash": "string"
}
```

## Mastodon: Get a Email blocks item

`GET /accounts/{accountId}/mastodon/admin-canonical-email-blocks/{itemId}`

Block specific (canonicalized) email addresses. Requires one of: admin:read | admin:read:canonical_email_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/canonical_email_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-canonical-email-blocks.

Access: `read` · MCP tool: `mastodon-admin-canonical-email-blocks-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-canonical-email-blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "canonical_email_hash": "string"
}
```

## Mastodon: Delete a Email blocks item

`DELETE /accounts/{accountId}/mastodon/admin-canonical-email-blocks/{itemId}`

Block specific (canonicalized) email addresses. Requires scopes: admin:write:canonical_email_blocks. Requires one of: admin:read | admin:read:canonical_email_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/canonical_email_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-canonical-email-blocks.

Access: `write` · MCP tool: `mastodon-admin-canonical-email-blocks-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-canonical-email-blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Mastodon: Test an email (Email blocks)

`POST /accounts/{accountId}/mastodon/admin-canonical-email-blocks/test`

Test an email. Block specific (canonicalized) email addresses. Requires one of: admin:read | admin:read:canonical_email_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/canonical_email_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-canonical-email-blocks.

Access: `write` · MCP tool: `mastodon-admin-canonical-email-blocks-test`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `email` (string (email); required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-canonical-email-blocks/test" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Server metrics

`GET /accounts/{accountId}/mastodon/admin-measures`

Active users, sign-ups, interactions, reports per day. Cursor pagination: pass next_cursor back as cursor. Requires scopes: admin:read. Network docs: https://docs.joinmastodon.org/methods/admin/measures/ Generic route: /v1/accounts/{accountId}/focus/admin-measures.

Access: `read` · MCP tool: `mastodon-admin-measures-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `keys` (array of string)
- `since` (string (date))
- `until` (string (date))
- `params` (any): Per-key params, e.g. { tag_accounts: { id } } · JSON-encoded object or array

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-measures" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "key": "active_users",
      "date": "2026-10-13",
      "value": 1.5
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: List Server breakdowns

`GET /accounts/{accountId}/mastodon/admin-dimensions`

Top languages, sign-up sources, servers, software versions, space usage. Cursor pagination: pass next_cursor back as cursor. Requires scopes: admin:read. Network docs: https://docs.joinmastodon.org/methods/admin/dimensions/ Generic route: /v1/accounts/{accountId}/focus/admin-dimensions.

Access: `read` · MCP tool: `mastodon-admin-dimensions-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `keys` (array of string)
- `since` (string (date))
- `until` (string (date))
- `limit` (integer)
- `params` (any): JSON-encoded object or array

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-dimensions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "key": "languages",
      "item": "string",
      "label": "string",
      "value": 1.5
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: List Retention

`GET /accounts/{accountId}/mastodon/admin-retention`

Sign-up cohorts and how many stay active. Cursor pagination: pass next_cursor back as cursor. Requires scopes: admin:read. Network docs: https://docs.joinmastodon.org/methods/admin/retention/ Generic route: /v1/accounts/{accountId}/focus/admin-retention.

Access: `read` · MCP tool: `mastodon-admin-retention-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date))
- `until` (string (date))
- `frequency` (string; one of day, month)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-retention" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "cohort": "2026-10-13",
      "date": "2026-10-13",
      "rate": 1.5,
      "value": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: List Trending links review

`GET /accounts/{accountId}/mastodon/admin-trends-links`

Review trending links: approve to allow them in public trends, reject to hide. Cursor pagination: pass next_cursor back as cursor. Requires scopes: admin:read. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: /v1/accounts/{accountId}/focus/admin-trends-links.

Access: `read` · MCP tool: `mastodon-admin-trends-links-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-trends-links" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "url": "https://example.com",
      "title": "string",
      "provider_name": "string",
      "requires_review": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Approve (Trending links review)

`POST /accounts/{accountId}/mastodon/admin-trends-links/{itemId}/approve`

Approve. Review trending links: approve to allow them in public trends, reject to hide. Requires scopes: admin:read, admin:write. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: /v1/accounts/{accountId}/focus/admin-trends-links.

Access: `write` · MCP tool: `mastodon-admin-trends-links-approve`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-trends-links/ITEM_ID/approve" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Reject (Trending links review)

`POST /accounts/{accountId}/mastodon/admin-trends-links/{itemId}/reject`

Reject. Review trending links: approve to allow them in public trends, reject to hide. Destructive. Requires scopes: admin:read, admin:write. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: /v1/accounts/{accountId}/focus/admin-trends-links.

Access: `write` · MCP tool: `mastodon-admin-trends-links-reject`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-trends-links/ITEM_ID/reject" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Trending posts review

`GET /accounts/{accountId}/mastodon/admin-trends-statuses`

Review trending statuses: approve to allow them in public trends, reject to hide. Cursor pagination: pass next_cursor back as cursor. Requires scopes: admin:read. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: /v1/accounts/{accountId}/focus/admin-trends-statuses.

Access: `read` · MCP tool: `mastodon-admin-trends-statuses-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-trends-statuses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "https://example.com",
      "url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "edited_at": "2026-10-13T09:00:00.000Z",
      "text": "string",
      "content": "string",
      "spoiler_text": "string",
      "sensitive": true,
      "visibility": "public",
      "language": "en",
      "in_reply_to_id": "string",
      "in_reply_to_account_id": "string",
      "replies_count": 1,
      "reblogs_count": 1,
      "favourites_count": 1,
      "quotes_count": 1,
      "author": "string",
      "author_name": "string",
      "media_attachments": [
        {
          "id": "string",
          "type": "image",
          "url": "https://example.com",
          "preview_url": "https://example.com",
          "remote_url": "https://example.com",
          "description": "string"
        }
      ],
      "poll": {
        "id": "string",
        "expires_at": "2026-10-13T09:00:00.000Z",
        "expired": true,
        "multiple": true,
        "votes_count": 1,
        "voters_count": 1
      },
      "favourited": true,
      "reblogged": true,
      "bookmarked": true,
      "muted": true,
      "pinned": true,
      "is_reblog": true,
      "quote": {
        "state": "string",
        "quoted_status": {}
      },
      "quote_approval": {},
      "requires_review": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Approve (Trending posts review)

`POST /accounts/{accountId}/mastodon/admin-trends-statuses/{itemId}/approve`

Approve. Review trending statuses: approve to allow them in public trends, reject to hide. Requires scopes: admin:read, admin:write. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: /v1/accounts/{accountId}/focus/admin-trends-statuses.

Access: `write` · MCP tool: `mastodon-admin-trends-statuses-approve`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-trends-statuses/ITEM_ID/approve" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Reject (Trending posts review)

`POST /accounts/{accountId}/mastodon/admin-trends-statuses/{itemId}/reject`

Reject. Review trending statuses: approve to allow them in public trends, reject to hide. Destructive. Requires scopes: admin:read, admin:write. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: /v1/accounts/{accountId}/focus/admin-trends-statuses.

Access: `write` · MCP tool: `mastodon-admin-trends-statuses-reject`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-trends-statuses/ITEM_ID/reject" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: List Trending hashtags review

`GET /accounts/{accountId}/mastodon/admin-trends-tags`

Review trending tags: approve to allow them in public trends, reject to hide. Cursor pagination: pass next_cursor back as cursor. Requires scopes: admin:read. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: /v1/accounts/{accountId}/focus/admin-trends-tags.

Access: `read` · MCP tool: `mastodon-admin-trends-tags-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-trends-tags" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "url": "https://example.com",
      "following": true,
      "featuring": true,
      "history": [
        {
          "day": "string",
          "uses": "string",
          "accounts": "string"
        }
      ],
      "requires_review": true,
      "trendable": true,
      "usable": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Mastodon: Approve (Trending hashtags review)

`POST /accounts/{accountId}/mastodon/admin-trends-tags/{itemId}/approve`

Approve. Review trending tags: approve to allow them in public trends, reject to hide. Requires scopes: admin:read, admin:write. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: /v1/accounts/{accountId}/focus/admin-trends-tags.

Access: `write` · MCP tool: `mastodon-admin-trends-tags-approve`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-trends-tags/ITEM_ID/approve" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Mastodon: Reject (Trending hashtags review)

`POST /accounts/{accountId}/mastodon/admin-trends-tags/{itemId}/reject`

Reject. Review trending tags: approve to allow them in public trends, reject to hide. Destructive. Requires scopes: admin:read, admin:write. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: /v1/accounts/{accountId}/focus/admin-trends-tags.

Access: `write` · MCP tool: `mastodon-admin-trends-tags-reject`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-trends-tags/ITEM_ID/reject" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```


---

Source: https://socialit.com/docs/api-reference/focus-mastodon/
