# dev.gitosphere.repository.issueMutation

> Published by [gitosphere-lex.bsky.social](https://lexicon.garden/identity/did:plc:iz47txlteeb2ojtp5ygiqet6)

✓ This is the authoritative definition for this NSID.

## Description

Append-only record of an authorized Issue change. Only changes accepted by the server take effect.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:iz47txlteeb2ojtp5ygiqet6/dev.gitosphere.repository.issueMutation)
- [Documentation](https://lexicon.garden/lexicon/did:plc:iz47txlteeb2ojtp5ygiqet6/dev.gitosphere.repository.issueMutation/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:iz47txlteeb2ojtp5ygiqet6/dev.gitosphere.repository.issueMutation/examples)

## Definitions

### `dev.gitosphere.repository.issueMutation#historicalIssue`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `blobs` | `array` | No |  |
| `body` | `string` | No |  |
| `bodyDocument` | `bytes` | No |  |
| `bodyDocumentFormat` | `string` | No |  |
| `createdAt` | `string` (datetime) | Yes |  |
| `issueId` | `string` | Yes |  |
| `mentions` | `array` | No |  |
| `number` | `integer` | Yes |  |
| `references` | `array` | No |  |
| `repositoryId` | `string` | Yes |  |
| `title` | `string` | Yes |  |

### `dev.gitosphere.repository.issueMutation#intent`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `body` | `string` | No |  |
| `bodyDocument` | `bytes` | No |  |
| `bodyDocumentFormat` | `string` | No |  |
| `number` | `integer` | No |  |
| `operation` | `string` | Yes |  |
| `relation` | `string` | No |  |
| `relationRevision` | `string` | No |  |
| `state` | `string` | No |  |
| `target` | `string` (at-uri) | No |  |
| `title` | `string` | No |  |

### `dev.gitosphere.repository.issueMutation`

**Type**: `record`

**Key**: `any`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `acceptedBy` | `string` (did) | Yes |  |
| `actor` | `string` (did) | Yes |  |
| `authorizationRevision` | `string` | Yes |  |
| `baseRevision` | `string` | Yes |  |
| `createdAt` | `string` (datetime) | Yes |  |
| `initialIssue` | `ref` → `#historicalIssue` | No |  |
| `intent` | `ref` → `dev.gitosphere.repository.issueMutation#intent` | Yes |  |
| `issue` | `string` (at-uri) | Yes |  |
| `keyId` | `string` | Yes |  |
| `operationId` | `string` | Yes |  |
| `realmId` | `string` | Yes |  |
| `receipt` | `string` | Yes |  |
| `relationRecord` | `ref` → `dev.gitosphere.repository.issueRelation` | No |  |
| `relationRecordKey` | `string` | No |  |
| `repositoryId` | `string` | Yes |  |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "historicalIssue": {
      "properties": {
        "blobs": {
          "items": {
            "accept": [
              "image/*"
            ],
            "maxSize": 1000000,
            "type": "blob"
          },
          "maxLength": 10,
          "type": "array"
        },
        "body": {
          "maxGraphemes": 10000,
          "maxLength": 100000,
          "type": "string"
        },
        "bodyDocument": {
          "maxLength": 262144,
          "type": "bytes"
        },
        "bodyDocumentFormat": {
          "knownValues": [
            "gsp-xml-zip-v1"
          ],
          "type": "string"
        },
        "createdAt": {
          "format": "datetime",
          "type": "string"
        },
        "issueId": {
          "maxLength": 36,
          "minLength": 36,
          "type": "string"
        },
        "mentions": {
          "items": {
            "format": "did",
            "type": "string"
          },
          "maxLength": 50,
          "type": "array"
        },
        "number": {
          "maximum": 9007199254740991,
          "minimum": 1,
          "type": "integer"
        },
        "references": {
          "items": {
            "format": "at-uri",
            "type": "string"
          },
          "maxLength": 50,
          "type": "array"
        },
        "repositoryId": {
          "maxLength": 36,
          "minLength": 36,
          "type": "string"
        },
        "title": {
          "maxGraphemes": 256,
          "maxLength": 2560,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "issueId",
        "number",
        "title",
        "repositoryId",
        "createdAt"
      ],
      "type": "object"
    },
    "intent": {
      "properties": {
        "body": {
          "maxLength": 100000,
          "type": "string"
        },
        "bodyDocument": {
          "maxLength": 262144,
          "type": "bytes"
        },
        "bodyDocumentFormat": {
          "knownValues": [
            "gsp-xml-zip-v1"
          ],
          "type": "string"
        },
        "number": {
          "minimum": 1,
          "type": "integer"
        },
        "operation": {
          "enum": [
            "create",
            "edit",
            "state",
            "relation"
          ],
          "type": "string"
        },
        "relation": {
          "type": "string"
        },
        "relationRevision": {
          "type": "string"
        },
        "state": {
          "enum": [
            "open",
            "closed"
          ],
          "type": "string"
        },
        "target": {
          "format": "at-uri",
          "type": "string"
        },
        "title": {
          "maxLength": 2560,
          "type": "string"
        }
      },
      "required": [
        "operation"
      ],
      "type": "object"
    },
    "main": {
      "key": "any",
      "record": {
        "properties": {
          "acceptedBy": {
            "format": "did",
            "type": "string"
          },
          "actor": {
            "format": "did",
            "type": "string"
          },
          "authorizationRevision": {
            "type": "string"
          },
          "baseRevision": {
            "type": "string"
          },
          "createdAt": {
            "format": "datetime",
            "type": "string"
          },
          "initialIssue": {
            "ref": "#historicalIssue",
            "type": "ref"
          },
          "intent": {
            "ref": "dev.gitosphere.repository.issueMutation#intent",
            "type": "ref"
          },
          "issue": {
            "format": "at-uri",
            "type": "string"
          },
          "keyId": {
            "type": "string"
          },
          "operationId": {
            "type": "string"
          },
          "realmId": {
            "type": "string"
          },
          "receipt": {
            "type": "string"
          },
          "relationRecord": {
            "ref": "dev.gitosphere.repository.issueRelation",
            "type": "ref"
          },
          "relationRecordKey": {
            "type": "string"
          },
          "repositoryId": {
            "type": "string"
          }
        },
        "required": [
          "realmId",
          "repositoryId",
          "operationId",
          "actor",
          "authorizationRevision",
          "baseRevision",
          "issue",
          "intent",
          "createdAt",
          "keyId",
          "acceptedBy",
          "receipt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "description": "Append-only record of an authorized Issue change. Only changes accepted by the server take effect.",
  "id": "dev.gitosphere.repository.issueMutation",
  "lexicon": 1
}
```