# dev.knotless.awaitSpaceWrites

> Published by [lexicons.knotless.dev](https://lexicon.garden/identity/did:plc:yqsg7znbbhfmj3a2nrpnaerk)

✓ This is the authoritative definition for this NSID.

## Description

A runner's ask of the appview for the private repositories written to, as soon as one is.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:yqsg7znbbhfmj3a2nrpnaerk/dev.knotless.awaitSpaceWrites)
- [Documentation](https://lexicon.garden/lexicon/did:plc:yqsg7znbbhfmj3a2nrpnaerk/dev.knotless.awaitSpaceWrites/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:yqsg7znbbhfmj3a2nrpnaerk/dev.knotless.awaitSpaceWrites/examples)

## Definitions

### `dev.knotless.awaitSpaceWrites`

**Type**: `query`

The spaces written to since `cursor`, of the private repositories whose owners invited the caller (dev.knotless.inviteRunner), as their authorities told the appview (com.atproto.space.notifyWrite): nothing written in a space reaches the firehose. Answers as soon as there is one, or with none after a while, to be asked again from the cursor it gives. A write told of is only a reason to look: the caller reads the space itself, as a member. Requires a service token from the caller's PDS, audience the appview's DID, for this method.

#### Parameters

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `cursor` | `string` | No | Where the last answer ended. With none, the answer says only where things are now. |

#### Output

**Encoding**: `application/json`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `cursor` | `string` | Yes | Where this answer ended: the cursor to ask from next. |
| `missed` | `boolean` | No | Set when `cursor` was none, or of no place the appview remembers, as after it restarted: any space may have been written to since. |
| `writes` | `array` | Yes |  |

### `dev.knotless.awaitSpaceWrites#write`

**Type**: `object`

A space written to.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `space` | `string` | Yes | The space, as `at://<owner>/space/dev.knotless.space/<name>`. |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "The spaces written to since `cursor`, of the private repositories whose owners invited the caller (dev.knotless.inviteRunner), as their authorities told the appview (com.atproto.space.notifyWrite): nothing written in a space reaches the firehose. Answers as soon as there is one, or with none after a while, to be asked again from the cursor it gives. A write told of is only a reason to look: the caller reads the space itself, as a member. Requires a service token from the caller's PDS, audience the appview's DID, for this method.",
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "cursor": {
              "description": "Where this answer ended: the cursor to ask from next.",
              "maxLength": 64,
              "type": "string"
            },
            "missed": {
              "description": "Set when `cursor` was none, or of no place the appview remembers, as after it restarted: any space may have been written to since.",
              "type": "boolean"
            },
            "writes": {
              "items": {
                "ref": "#write",
                "type": "ref"
              },
              "type": "array"
            }
          },
          "required": [
            "cursor",
            "writes"
          ],
          "type": "object"
        }
      },
      "parameters": {
        "properties": {
          "cursor": {
            "description": "Where the last answer ended. With none, the answer says only where things are now.",
            "maxLength": 64,
            "type": "string"
          }
        },
        "type": "params"
      },
      "type": "query"
    },
    "write": {
      "description": "A space written to.",
      "properties": {
        "space": {
          "description": "The space, as `at://<owner>/space/dev.knotless.space/<name>`.",
          "maxLength": 512,
          "type": "string"
        }
      },
      "required": [
        "space"
      ],
      "type": "object"
    }
  },
  "description": "A runner's ask of the appview for the private repositories written to, as soon as one is.",
  "id": "dev.knotless.awaitSpaceWrites",
  "lexicon": 1
}
```