---
# @generated by sylphx-gen 0.1.0 from contracts@e145cc7cf1bc9605f2b27439e5e17ed76a1a2fd7e7021906a013f7565e4a0cd5. Do not edit.
title: "Source links"
description: "The `source_links` collection of Sylphx Hosting: A SourceLink links a project to one repository through Sylphx Connections."
type: reference
product: hosting
summary: "A SourceLink links a project to one repository through Sylphx Connections."
updated: 2026-09-28
order: 900
---

> **This method is not served on the public API.** `api.sylphx.com` does not route this call: its backend is not deployed behind the public API, or does not implement the call. This page documents the contract. It is kept out of the sidebar and of search engines.

A SourceLink links a project to one repository through Sylphx Connections. Source is read at an exact commit with a token from the credential service narrowed to that repository; a webhook is only a latency hint.

**Service** Sylphx Hosting · **Resource type** `hosting.sylphx.com/SourceLink` · **Name pattern** `orgs/{org}/projects/{project}/source_links/{source_link}` · **Shape** `spec_status`

**Not available yet.** Sylphx Hosting is declared in the registry but no backend serves it: every call answers `501` with the problem code `UNIMPLEMENTED`.

## Fields

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | `orgs/{org}/projects/{project}/source_links/{source_link}`. |
| `uid` | `string` | `src_<cell><ulid>`; never reused. Output only. |
| `meta` | `ResourceMeta` | Resource metadata. |
| `spec` | `SourceLinkSpec` | Desired state. Required. |
| `status` | `SourceLinkStatus` | Observed state. Output only. |

## Methods

Every method of the collection, in the registry's order, with the scope it
needs. The full request, response and examples are one link away.

| Method | Call | What it does |
| --- | --- | --- |
| `GET` | [`get`](/docs/api/source_links#get) | Gets a source link. |
| `GET` | [`list`](/docs/api/source_links#list) | Lists source links in a project. |
| `POST` | [`create`](/docs/api/source_links#create) | Creates a source link. The Operation is done when the controller settles it. |
| `PATCH` | [`update`](/docs/api/source_links#update) | Updates a source link. |
| `DELETE` | [`delete`](/docs/api/source_links#delete) | Deletes a source link. |

## get

Gets a source link.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/source_links/source-link` · scope `hosting:read` · effect `read` · not available yet · [Request, response and examples](/docs/api/source_links/get)

## list

Lists source links in a project.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/source_links` · scope `hosting:read` · effect `read` · not available yet · paginated · [Request, response and examples](/docs/api/source_links/list)

## create

Creates a source link. The Operation is done when the controller settles it.

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/source_links` · scope `hosting:write` · effect `write` · not available yet · long-running · [Request, response and examples](/docs/api/source_links/create)

## update

Updates a source link.

`PATCH https://api.sylphx.com/v1/orgs/acme/projects/shop/source_links/source-link` · scope `hosting:write` · effect `write` · not available yet · long-running · [Request, response and examples](/docs/api/source_links/update)

## delete

Deletes a source link.

`DELETE https://api.sylphx.com/v1/orgs/acme/projects/shop/source_links/source-link` · scope `hosting:write` · effect `destructive` · not available yet · long-running · [Request, response and examples](/docs/api/source_links/delete)