# fyi.opensocial.offerTab

> Published by [lexicons.opensocial.fyi](https://lexicon.garden/identity/did:plc:2gqnilpksz2e7faj3bwvo6qc)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:2gqnilpksz2e7faj3bwvo6qc/fyi.opensocial.offerTab)
- [Documentation](https://lexicon.garden/lexicon/did:plc:2gqnilpksz2e7faj3bwvo6qc/fyi.opensocial.offerTab/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:2gqnilpksz2e7faj3bwvo6qc/fyi.opensocial.offerTab/examples)

## Definitions

### `fyi.opensocial.offerTab`

**Type**: `procedure`

Offer a tab of a channel kept for chosen people you're in to the group's site, to one of its channels or wherever those who may change the site think best. While it waits they may read that tab, and nothing else in the channel, to decide.

#### Input

**Encoding**: `application/json`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `channel` | `string` (at-uri) | Yes |  |
| `group` | `string` (did) | Yes |  |
| `note` | `string` | No |  |
| `tab` | `string` | Yes | The tab's slug in that channel. |
| `to` | `string` | No | The slug of the site's channel it would go in; absent, wherever they think best. |

#### Output

**Encoding**: `application/json`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `offer` | `string` | Yes |  |

#### Errors

- **InvalidOffer**
- **NotFound**

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Offer a tab of a channel kept for chosen people you're in to the group's site, to one of its channels or wherever those who may change the site think best. While it waits they may read that tab, and nothing else in the channel, to decide.",
      "errors": [
        {
          "name": "InvalidOffer"
        },
        {
          "name": "NotFound"
        }
      ],
      "input": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "channel": {
              "format": "at-uri",
              "type": "string"
            },
            "group": {
              "format": "did",
              "type": "string"
            },
            "note": {
              "maxGraphemes": 500,
              "type": "string"
            },
            "tab": {
              "description": "The tab's slug in that channel.",
              "type": "string"
            },
            "to": {
              "description": "The slug of the site's channel it would go in; absent, wherever they think best.",
              "type": "string"
            }
          },
          "required": [
            "group",
            "channel",
            "tab"
          ],
          "type": "object"
        }
      },
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "offer": {
              "type": "string"
            }
          },
          "required": [
            "offer"
          ],
          "type": "object"
        }
      },
      "type": "procedure"
    }
  },
  "id": "fyi.opensocial.offerTab",
  "lexicon": 1
}
```