---
title: Resource links
summary: A resource link represents a link between a shared resource (such as an kv store or config store) and a service version.
url: https://www.fastly.com/documentation/reference/api/services/resource
---

A resource link represents a link between a shared resource (such as an kv store or config store) and a service version.

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `name` | string | The name of the resource link. Note this is separate from the resource store name and might not match the store name. |
| `resource_id` | string | The ID of the underlying linked resource. |
| `created_at` | string | Date and time in ISO 8601 format. (Read-only) |
| `deleted_at` | string | Date and time in ISO 8601 format. (Read-only) |
| `href` | string | The path to the resource. |
| `id` | string | An alphanumeric string identifying the resource link. |
| `resource_type` | string | Resource type. |
| `service_id` | string | Alphanumeric string identifying the service. |
| `updated_at` | string | Date and time in ISO 8601 format. (Read-only) |
| `version` | integer | Integer identifying a service version. |

## API endpoints

### List resource links

**GET** `/service/{service_id}/version/{version_id}/resource`

List links between resources and services.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `service_id` | string | path | Yes | Alphanumeric string identifying the service. |
| `version_id` | integer | path | Yes | Integer identifying a service version. |

### Create a resource link

**POST** `/service/{service_id}/version/{version_id}/resource`

Create a link between a resource and a service version.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `service_id` | string | path | Yes | Alphanumeric string identifying the service. |
| `version_id` | integer | path | Yes | Integer identifying a service version. |

### Display a resource link

**GET** `/service/{service_id}/version/{version_id}/resource/{id}`

Display a resource link by its identifier.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `id` | string | path | Yes | An alphanumeric string identifying the resource link. |
| `service_id` | string | path | Yes | Alphanumeric string identifying the service. |
| `version_id` | integer | path | Yes | Integer identifying a service version. |

### Update a resource link

**PUT** `/service/{service_id}/version/{version_id}/resource/{id}`

Update a link between a resource and a service version.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `id` | string | path | Yes | An alphanumeric string identifying the resource link. |
| `service_id` | string | path | Yes | Alphanumeric string identifying the service. |
| `version_id` | integer | path | Yes | Integer identifying a service version. |

### Delete a resource link

**DELETE** `/service/{service_id}/version/{version_id}/resource/{id}`

Delete a link between a resource and a service version.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `id` | string | path | Yes | An alphanumeric string identifying the resource link. |
| `service_id` | string | path | Yes | Alphanumeric string identifying the service. |
| `version_id` | integer | path | Yes | Integer identifying a service version. |