# io.atcr.hold.updateCrewTier

> Published by [atcr.io](https://lexicon.garden/identity/did:plc:wfj5kyialpmcv2fzk6uqwsln)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:wfj5kyialpmcv2fzk6uqwsln/io.atcr.hold.updateCrewTier)
- [Documentation](https://lexicon.garden/lexicon/did:plc:wfj5kyialpmcv2fzk6uqwsln/io.atcr.hold.updateCrewTier/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:wfj5kyialpmcv2fzk6uqwsln/io.atcr.hold.updateCrewTier/examples)

## Definitions

### `io.atcr.hold.updateCrewTier`

**Type**: `procedure`

Update a crew member's tier. Only accepts requests from the trusted appview.

#### Input

**Encoding**: `application/json`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `userDid` | `string` (did) | Yes | DID of the crew member whose tier is being updated. |
| `tierRank` | `integer` | Yes | Tier rank index (0-based, maps to hold tier list by position). |

#### Output

**Encoding**: `application/json`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `tierName` | `string` | Yes | Resolved tier name on this hold. |

#### Errors

- **AuthRequired**: Valid appview token required.
- **UserNotFound**: User is not a crew member on this hold.

## Raw Schema

```json
{
  "id": "io.atcr.hold.updateCrewTier",
  "defs": {
    "main": {
      "type": "procedure",
      "input": {
        "schema": {
          "type": "object",
          "required": [
            "userDid",
            "tierRank"
          ],
          "properties": {
            "userDid": {
              "type": "string",
              "format": "did",
              "description": "DID of the crew member whose tier is being updated."
            },
            "tierRank": {
              "type": "integer",
              "minimum": 0,
              "description": "Tier rank index (0-based, maps to hold tier list by position)."
            }
          }
        },
        "encoding": "application/json"
      },
      "errors": [
        {
          "name": "AuthRequired",
          "description": "Valid appview token required."
        },
        {
          "name": "UserNotFound",
          "description": "User is not a crew member on this hold."
        }
      ],
      "output": {
        "schema": {
          "type": "object",
          "required": [
            "tierName"
          ],
          "properties": {
            "tierName": {
              "type": "string",
              "maxLength": 64,
              "description": "Resolved tier name on this hold."
            }
          }
        },
        "encoding": "application/json"
      },
      "description": "Update a crew member's tier. Only accepts requests from the trusted appview."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```