# org-membership

From **GitHub v3 REST API**.

Org Membership

- Type: `object`

## Properties

### `organization`

- Required: true
- Type: `object`

Organization Simple

### `organization_url`

- Required: true
- Type: `string`
- Format: `uri`
- Example: `https://api.github.com/orgs/octocat`

### `permissions`

- Required: false
- Type: `object`

### `role`

- Required: true
- Type: `string`
- Example: `admin`
- Allowed values: `"admin"`, `"member"`, `"billing_manager"`

The user's membership type in the organization.

### `state`

- Required: true
- Type: `string`
- Example: `active`
- Allowed values: `"active"`, `"pending"`

The state of the member in the organization. The `pending` state indicates the user has not yet accepted an invitation.

### `url`

- Required: true
- Type: `string`
- Format: `uri`
- Example: `https://api.github.com/orgs/octocat/memberships/defunkt`

### `user`

- Required: true
- Type: `object`
- Nullable: true

Simple User

## JSON Schema

```json
{"description":"Org Membership","properties":{"organization":{"$ref":"#/components/schemas/organization-simple"},"organization_url":{"example":"https://api.github.com/orgs/octocat","format":"uri","type":"string"},"permissions":{"properties":{"can_create_repository":{"type":"boolean"}},"required":["can_create_repository"],"type":"object"},"role":{"description":"The user's membership type in the organization.","enum":["admin","member","billing_manager"],"example":"admin","type":"string"},"state":{"description":"The state of the member in the organization. The `pending` state indicates the user has not yet accepted an invitation.","enum":["active","pending"],"example":"active","type":"string"},"url":{"example":"https://api.github.com/orgs/octocat/memberships/defunkt","format":"uri","type":"string"},"user":{"$ref":"#/components/schemas/nullable-simple-user"}},"required":["state","role","organization_url","url","organization","user"],"title":"Org Membership","type":"object"}
```