---
title: Service authorizations
summary: A service authorization allows limited users to access only specified services.
url: https://www.fastly.com/documentation/reference/api/account/service-authorization
---

A service authorization allows limited users to access only specified services.

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `permission` | string | The permission the user has in relation to the service. |
| `relationships.service.id` | string | Alphanumeric string identifying the service. |
| `relationships.user.id` | string | The ID of the user being given access to the service. |
| `type` | string | Resource type. |
| `created_at` | string | Date and time in ISO 8601 format. (Read-only) |
| `deleted_at` | string | Date and time in ISO 8601 format. (Read-only) |
| `id` | string | Alphanumeric string identifying a service authorization. (Read-only) |
| `updated_at` | string | Date and time in ISO 8601 format. (Read-only) |

## API endpoints

### Show service authorization

**GET** `/service-authorizations/{service_authorization_id}`

Show service authorization.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `service_authorization_id` | string | path | Yes | Alphanumeric string identifying a service authorization. |

### Delete service authorization

**DELETE** `/service-authorizations/{service_authorization_id}`

Delete service authorization.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `service_authorization_id` | string | path | Yes | Alphanumeric string identifying a service authorization. |

### Update service authorization

**PATCH** `/service-authorizations/{service_authorization_id}`

Update service authorization.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `service_authorization_id` | string | path | Yes | Alphanumeric string identifying a service authorization. |

### List service authorizations

**GET** `/service-authorizations`

List service authorizations.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `page[number]` | integer | query | No | Current page. |
| `page[size]` | integer | query | No | Number of records per page. |

### Create service authorization

**POST** `/service-authorizations`

Create service authorization.

### Delete service authorizations

**DELETE** `/service-authorizations`

Delete service authorizations.

### Update service authorizations

**PATCH** `/service-authorizations`

Update service authorizations.