# installation-token

From **GitHub v3 REST API**.

Authentication token for a GitHub App installed on a user or org.

- Type: `object`

## Properties

### `expires_at`

- Required: true
- Type: `string`

### `has_multiple_single_files`

- Required: false
- Type: `boolean`
- Example: `true`

### `permissions`

- Required: false
- Type: `object`
- Example: `{
  "contents": "read",
  "deployments": "write",
  "issues": "read",
  "single_file": "read"
}`

The permissions granted to the user-to-server access token.

### `repositories`

- Required: false
- Type: `array`

### `repository_selection`

- Required: false
- Type: `string`
- Allowed values: `"all"`, `"selected"`

### `single_file`

- Required: false
- Type: `string`
- Example: `README.md`

### `single_file_paths`

- Required: false
- Type: `array`
- Example: `[
  "config.yml",
  ".github/issue_TEMPLATE.md"
]`

### `token`

- Required: true
- Type: `string`

## JSON Schema

```json
{"description":"Authentication token for a GitHub App installed on a user or org.","properties":{"expires_at":{"type":"string"},"has_multiple_single_files":{"example":true,"type":"boolean"},"permissions":{"$ref":"#/components/schemas/app-permissions"},"repositories":{"items":{"$ref":"#/components/schemas/repository"},"type":"array"},"repository_selection":{"enum":["all","selected"],"type":"string"},"single_file":{"example":"README.md","type":"string"},"single_file_paths":{"example":["config.yml",".github/issue_TEMPLATE.md"],"items":{"type":"string"},"type":"array"},"token":{"type":"string"}},"required":["token","expires_at"],"title":"Installation Token","type":"object"}
```