# social.coves.aggregator.service

> Published by [coves.social](https://lexicon.garden/identity/did:web:coves.social)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:web:coves.social/social.coves.aggregator.service)
- [Documentation](https://lexicon.garden/lexicon/did:web:coves.social/social.coves.aggregator.service/docs)
- [Examples](https://lexicon.garden/lexicon/did:web:coves.social/social.coves.aggregator.service/examples)

## Definitions

### `social.coves.aggregator.service`

**Type**: `record`

Declaration of an aggregator service that can post to communities. Published in the aggregator's own repository. Similar to app.bsky.feed.generator and app.bsky.labeler.service.

**Key**: `literal:self`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `did` | `string` (did) | Yes | DID of the aggregator service (must match repo DID) |
| `avatar` | `blob` | No | Avatar image for bot identity |
| `createdAt` | `string` (datetime) | Yes |  |
| `sourceUrl` | `string` (uri) | No | URL to aggregator's source code (for transparency) |
| `maintainer` | `string` (did) | No | DID of person/organization maintaining this aggregator |
| `description` | `string` | No | Description of what this aggregator does |
| `displayName` | `string` | Yes | Human-readable name (e.g., 'RSS News Aggregator') |
| `configSchema` | `unknown` | No | JSON Schema describing config options for this aggregator. Communities use this to know what configuration fields are available. |

## Raw Schema

```json
{
  "id": "social.coves.aggregator.service",
  "defs": {
    "main": {
      "key": "literal:self",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "did",
          "displayName",
          "createdAt"
        ],
        "properties": {
          "did": {
            "type": "string",
            "format": "did",
            "description": "DID of the aggregator service (must match repo DID)"
          },
          "avatar": {
            "type": "blob",
            "accept": [
              "image/png",
              "image/jpeg",
              "image/webp"
            ],
            "maxSize": 1000000,
            "description": "Avatar image for bot identity"
          },
          "createdAt": {
            "type": "string",
            "format": "datetime"
          },
          "sourceUrl": {
            "type": "string",
            "format": "uri",
            "description": "URL to aggregator's source code (for transparency)"
          },
          "maintainer": {
            "type": "string",
            "format": "did",
            "description": "DID of person/organization maintaining this aggregator"
          },
          "description": {
            "type": "string",
            "maxLength": 3000,
            "description": "Description of what this aggregator does",
            "maxGraphemes": 300
          },
          "displayName": {
            "type": "string",
            "maxLength": 640,
            "description": "Human-readable name (e.g., 'RSS News Aggregator')",
            "maxGraphemes": 64
          },
          "configSchema": {
            "type": "unknown",
            "description": "JSON Schema describing config options for this aggregator. Communities use this to know what configuration fields are available."
          }
        }
      },
      "description": "Declaration of an aggregator service that can post to communities. Published in the aggregator's own repository. Similar to app.bsky.feed.generator and app.bsky.labeler.service."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```