Releases Index
Source by slug
View .md

Resolve a bare source slug to its canonical org-scoped home

GET
/lookups/source-by-slug

Translation aid for clients holding a bare source slug. Returns the org-scoped tuple { sourceId, sourceSlug, orgSlug } so callers can rewrite to the canonical /v1/orgs/:orgSlug/sources/:sourceSlug path before the bare API path stops resolving slugs (#698 final piece).

A slug owned by one org returns that row and carries Sunset: Sun, 01 Nov 2026 00:00:00 GMT. A slug owned by more than one org returns 409 with details.candidates (org/slug + src_ id) instead of picking a row (#2525).

Authorization

bearerAuth
headerAuthorizationBearer <relk_… | relu_… | OAuth JWT>

Machine/operator tokens use the relk_ prefix; self-serve read-only user keys use relu_; Sign in with Releases supplies an OAuth access token. Required scope depends on the endpoint.

Query Parameters

slug*string

Bare source slug to resolve.

Response Body

Canonical home for the slug

application/json
  1. response
sourceId*string
sourceSlug*string
orgSlug*string
Example Request
curl -X GET 'https://api.releases.sh/v1/lookups/source-by-slug?slug=string'
Example Response
{  "sourceId": "string",  "sourceSlug": "string",  "orgSlug": "string"}