# today.joblist.suggestion

> A company someone suggests for a list they do not own, written in their own repository. Open lists show it at once, credited to its author; for other lists, the list's author accepts or dismisses it.

- Kind: record
- Record key: tid
- Authority: joblist.today
- Lexicon: 1
- Published by [joblist.today](https://lexicon.garden/identity/did:plc:jqaucxlucukeif3bltpuc7zx), the NSID's authority

## Links

- [Documentation](https://lexicon.garden/lexicon/did:plc:jqaucxlucukeif3bltpuc7zx/today.joblist.suggestion)
- [Schema JSON](https://lexicon.garden/lexicon/did:plc:jqaucxlucukeif3bltpuc7zx/today.joblist.suggestion/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:plc:jqaucxlucukeif3bltpuc7zx/today.joblist.suggestion/analytics)

## Record (`today.joblist.suggestion`)

Type: record · key tid

### Properties

- `company` (string, required): Company record key (its domain).
  - Constraints: maxLength: 253
- `createdAt` (string · datetime, required)
- `list` (string · at-uri, required): The today.joblist.list the company is suggested for.
- `note` (string): Why it belongs in the list.
  - Constraints: maxLength: 3000, maxGraphemes: 300

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "key": "tid",
      "record": {
        "properties": {
          "company": {
            "description": "Company record key (its domain).",
            "maxLength": 253,
            "type": "string"
          },
          "createdAt": {
            "format": "datetime",
            "type": "string"
          },
          "list": {
            "description": "The today.joblist.list the company is suggested for.",
            "format": "at-uri",
            "type": "string"
          },
          "note": {
            "description": "Why it belongs in the list.",
            "maxGraphemes": 300,
            "maxLength": 3000,
            "type": "string"
          }
        },
        "required": [
          "list",
          "company",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "description": "A company someone suggests for a list they do not own, written in their own repository. Open lists show it at once, credited to its author; for other lists, the list's author accepts or dismisses it.",
  "id": "today.joblist.suggestion",
  "lexicon": 1
}
```